This ports reStructuredText content, created over time, into Markdown.
Although Hugo can render content from RST (using Docutils), MD with Hugo
feels more "native" (and I personally find it easier to edit), so I hope
that this is a net gain in maintainability. Format conversion was done
with pandoc; only "note" directives and internal links had to be manually
adjusted.
The pages have been re-ordered into Hugo page bundles; these are rendered
by the theme as "chapters". This makes the side menu much more readable,
and the content is beter organised. A downside is that it breaks existing
links, but this seems acceptable once per funding period.
The changes are technical and structural, but the content remains the
same. In case the rewrite is kept as a separate branch (instead of being
merged on top of the exiting one), I would like to use this opportunity
to acknowledge my colleagues who contributed to creating this content.
Co-authored-by: Hanke, Michael <michael.hanke@gmail.com>
Co-authored-by: Christian Mönch <christian.moench@web.de>
Co-authored-by: Laura Waite <laura@waite.eu>
Co-authored-by: Stephan Heunis <s.heunis@fz-juelich.de>
Co-authored-by: Wagner, Adina Svenja <a.wagner@fz-juelich.de>
Michał Szczepanik
0b93213123