Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
  1. docker image pull registry.gitlab.com/papercutsoftware/docs-as-code:latest

  2. cd ~/demo/

  3. git init demo-project

  4. cd demo-proect

  5. git config user.email alecclews@gmail.com

  6. mkdir -p source/images

  7. wget https://gist.githubusercontent.com/alecthegeek/5b2ab1f1a26949962aa995c90da10f78/raw/DemoLegacyDocument.docx

  8. 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

  9. Image export vi LibreOffice

  10. mv *.gif images/image001.gif

  11. Edit image location -- something like

.. figure:: images/image001.gif
   :alt: Pandoc workflow to convert from one format to another

   Pandoc Workflow
  1. Add A title at the top

  2. runDocTools sphinx-quickstart

  3. Add to index.rst :glob: [0-9][0-9][0-9][0-9]-*

  4. runDocTools make html

@alecthegeek
Copy link
Author

alecthegeek commented Jan 8, 2020

This is a demo file for a talk about migrating legacy documents into a lightweight markup language.

to get this file locally

wget https://gist.github.com/alecthegeek/5b2ab1f1a26949962aa995c90da10f78/raw/23ad6f35512c9316936c1794e336d0a048da0c40/DemoLegacyDocument.docx

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment