Prepare documentation for web publication
Currently, our documentation is only available as PDF file in the TeX distributions. After we created a website for v6, there's room for publishing it on the website as well. Therefore, we need to do the following:
- Use a common input format, i.e. Markdown.
- Prepare shortcodes for Zola to avoid losing structural information.
- Use a processor like pandoc to convert to PDF.
- Write custom transformation rules for the processing application to produce a good-looking PDF.
A preliminary task list:
-
Quickstart guide -
Transform into Markdown -
Prepare shortcodes -
Publish on web page -
Create pandoc template -
Produce PDF using CI and pandoc -
Remove tex sources from repo
-
-
Manual, same procedure as above
Edited by Ben Frank