Redo HTML online documentation
The current HTML version of the user manual has several shortcomings and does not work well on different devices. I would suggest moving to a different compiler for this.
One option would be to use Pandoc to convert the LaTeX code to Markdown and then to use mkdocs
which produces some nice ReadTheDocs style output which is searchable and easy to navigate. A sample configuration file would be:
site_name: Allpix Squared User Manual
repo_url: https://gitlab.cern.ch/allpix-squared/allpix-squared
repo_name: CERN GitLab
edit_uri: edit/master/doc/usermanual/
docs_dir: mkdocs
theme: readthedocs
pages:
- Introduction: introduction.md
- Quick Start: quick_start.md
- Installation: installation.md
- Getting Started: getting_started.md
- Framework: framework.md
- Objects: objects.md
- Modules: modules.md
- Examples: examples.md
- Module & Detector Development: development.md
- Development Tools & Continuous Integration: testing.md
- Frequently Asked Questions: faq.md
- Additional Tools: additional.md
- Acknowledgements: acknowledgements.md
The output produced is similar to the example here: http://peary-caribou.web.cern.ch/peary-caribou/
However, there are a few quirks to work around when converting the LaTeX back to Markdown - and maybe we should just do it the other way: have all documentation as Markdown and then only convert it to LaTeX for producing the PDF version of the manual. This would, however, entail some work.