[Hugo] Ersetze Hugo mit Quarto? Oder alternativ Hugo-Geekdocs? Oder manuelle Pandoc-Templates?

[cagix]

Aktuell gibt es zwei Workflows: Ausgehend von Pandoc-Markdown-Files wird

1. mit Pandoc und LaTeX+Beamer ein Foliensatz erzeugt, und
2. mit Pandoc und Hugo+Relearn eine Webseite erzeugt.

Angedacht ist zusätzlich die Veröffentlichung als PDF oder ePub (Buch).

---

Das Hugo-Relearn-Theme ist ganz nett für eine Vorlesungsseite, ist aber auf Dauer zu "barock" und schrill. Ein schlichteres Theme ala Geekdocs wäre schön. Allerdings ist der Aufwand für die Umstellung recht hoch, auch wenn das eigentlich nur ein (anderes) Hugo-Theme ist. Auch ganz nett für Hugo: Docsy.

Mit Quarto gibt es einen integrierten Ansatz, der ein ähnliches minimalistisches Theme mitbringt inklusive der Navigation links+rechts ala mkDocs. Unter der Haube wird Pandoc eingesetzt, d.h. die Filter könnten weiter verwendet werden. Es gibt auch einen PDF-Export, wobei noch unklar ist, ob das nur Datei-weise ist oder für das gesamte Projekt funktioniert. Außerdem gibt es hier bereits fertige GH-Actions vom Projekt, die man direkt nutzen könnte. Allerdings steht das Projekt unter GNU GPL v2, was sich ggf. auf die damit erzeugten Artefakte auswirkt? Außerdem ist das Projekt vergleichsweise groß mit vielen Bereichen, die hier nicht benötigt werden.

---

@cagix note2self: hugo muss mittelfristig wieder raus aus der toolchain. erstelle templates mit ähnlicher funktionalität (hugo + hugo-learn-theme) direkt für pandoc.

Originally posted by @cagix in https://github.com/Compilerbau/Lecture/issues/62#issuecomment-926567791

https://github.com/ashki23/pandoc-bootstrap ist ein Projekt mit einfachen HTML-Templates, mit denen man eine halbwegs modern aussehende Webseite erzeugen kann. Dark Mode geht leider nicht, könnte aber vermutlich nachgebaut werden.

Die Struktur des Projekts muss von Hand in die Navigation übertragen werden.

---

Jekyll und just-the-docs könnten auch ein interessantes Gespann sein. Die generierten Seiten sind sehr minimalistisch und recht ansehnlich. Beispiel: Stanza – A Python NLP Package for Many Human Languages (Stanford University). Vorteil: Theme ist super schlicht und gut lesbar, Jekyll liegt hinter GH-Pages. Nachteil: Jekyll hat keine Binaries und muss per Ruby-Gem installiert werden (Default-Ruby auf macOS zu alt).