Skip to content

Mokolea/docker-asciidoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

docker-asciidoc Docker Cloud Build Status Docker Image Size (tag)

Test AsciiDoc (includes pandoc)

Release

AsciiDoc

Usage

  • Start new container from a current asciidoc-project directory: $ docker run -it -v $(pwd):/data --name asciidoc -h asciidoc mokolea/asciidoc:latest
  • Optional: Set user and group IDs to override the default image user (1000:1000) by using parameter:
    • -u root for root user
    • -u $(id -u):$(id -g) for current host user (experimental - does not work without additional configuration)
  • Subsequent use of the same stopped container: $ docker start -ai asciidoc
  • Create bash shell session in the already running container: $ docker exec -it asciidoc bash

Test

docker@asciidoc:/data$ asciidoc --version
asciidoc 8.6.9
docker@asciidoc:/data$ 

docker@asciidoc:/data$ docbook2pdf --version
DocBook-utils version 0.6.14 (jw version 1.1)
docker@asciidoc:/data$ 

docker@asciidoc:/data$ asciidoc -b docbook hello-world.adoc && docbook2pdf hello-world.xml
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /data/hello-world.xml
Done.
docker@asciidoc:/data$ 

TODO

  • Add hello-world.adoc

Done

  • Setup appropriate user to not run tools (asciidoc, docbook2pdf, ...) as root and so not have generated files from root in host file system

-- Mario