Usage¶
Note
All commands in the documentation refrer to the installation according to the official ` Docker installation guide <https://docs.docker.com/engine/installation/>`_.
If you installed Docker via the package manager of your Operating System you may have to adjust the commands.
Meaning if you installed Docker on Ubuntu from the Ubuntu repositories the syntax would be docker.io
in place of docker
.
Update Image¶
Check and update application image to a newer version:
docker pull testthedocs/plone-docsbuilder
Building HTML¶
plone-docsbuilder is designed to build HTML out of rst files in your current working directory ($PWD).
The build output will be saved in a directory called _build in your $PWD.
Example¶
Change into your documentation dorectory (/docs) of your project:
cd docs
Do a ls
to see all the files here:
index.rst
Run plone-docsbuilder:
docker run -v `pwd`:/build/docs testthedocs/plone-docsbuilder html
After the build is finished, check the content of the directory with ls
again:
index.rst _build