-
docker image pull registry.gitlab.com/papercutsoftware/docs-as-code:latest
-
cd ~/demo/
-
git init demo-project
-
cd demo-proect
-
git config user.email [email protected]
-
mkdir -p source/images
-
wget https://gist.githubusercontent.com/alecthegeek/5b2ab1f1a26949962aa995c90da10f78/raw/DemoLegacyDocument.docx
-
docker container run -it --mount "type=bind,src=$PWD,target=/docs-as-code" --rm --name mySphinx registry.gitlab.com/papercutsoftware/docs-as-code:latest pandoc -f docx DemoLegacyDocument.docx -t rst -o source/001-convert.rst
-
Image export vi LibreOffice
-
mv *.gif images/image001.gif
-
Edit image location -- something like
.. figure:: images/image001.gif
:alt: Pandoc workflow to convert from one format to another
Pandoc Workflow
-
Add A title at the top
-
runDocTools sphinx-quickstart
-
Add to index.rst :glob: [0-9][0-9][0-9][0-9]-*
-
runDocTools make html
This is a demo file for a talk about migrating legacy documents into a lightweight markup language.
to get this file locally