vllt. OT: Software für umfangreichere Doku
Hi, worin setzt Ihr sowas um: Eine Doku mit 4... 5... Menüebenen, am besten als Menü auf einer Seite und Inhalte inkl. Grafiken, möglichst nicht zu steile Lernkurve, für die Inhalte vielleicht Markdown o.ä. und die Menüverwaltung nicht zu umständlich, Ausgabe in HTML im LAN, muss also nicht extra sicher sein... Hab mich in der Auswahl all der Wikis etc. nicht so recht entscheiden können, v.a. die Menüebenen bereiten mir etwas Kopfzerbrechen Thx für jeden Tipp -- cu jth
Am 18/01/2023 um 16.14 schrieb Jörg Thümmler:
worin setzt Ihr sowas um: Eine Doku mit 4... 5... Menüebenen, am besten als Menü auf einer Seite und Inhalte inkl. Grafiken, möglichst nicht zu steile Lernkurve, für die Inhalte vielleicht Markdown o.ä. und die Menüverwaltung nicht zu umständlich, Ausgabe in HTML im LAN, muss also nicht extra sicher sein...
Hab mich in der Auswahl all der Wikis etc. nicht so recht entscheiden können, v.a. die Menüebenen bereiten mir etwas Kopfzerbrechen
Sphinx Holger
On Wednesday, 18 January 2023 16:14:22 CET Jörg Thümmler wrote:
worin setzt Ihr sowas um: Eine Doku mit 4... 5... Menüebenen, am besten als Menü auf einer Seite und Inhalte inkl. Grafiken, möglichst nicht zu steile Lernkurve, für die Inhalte vielleicht Markdown o.ä. und die Menüverwaltung nicht zu umständlich, Ausgabe in HTML im LAN, muss also nicht extra sicher sein...
Ich habe mir so etwas selbst gebaut. Basis ist pandoc mit pandoc's markdown. Den build habe ich mit make automatisiert. Unzulänglichkeiten habe ich mit verschiedenen Boardmitteln von pandoc-Erweiterungen gelöst: - Inhaltsverzeichnis (TOC) - HTML-Templates - CSS style-Files - Lua-Scripts - Syntax-Highlighting mit einem eigenen KDE-style XML definition file erweitert. (Wenn einem das von pandoc nicht gefällt.) - ... Meine Struktur besteht aus verschiedenen Büchern auf höchster Ebene und dann darunter aus HTML-Seiten, die links jeweils ein Inhaltsverzeichnis pro Buch haben und rechts Text. Alles natürlich navigierbar. Wie man so etwas machen kann, steht alles in der sehr guten Dokumentation von pandoc. Alles in allem ist das mit der Zeit immer umfangreicher geworden. Das schöne ist, dass pandoc an sich eine sehr schöne Plattform ist und schon sehr viel kann. Meine Erweiterungen sind mit der Zeit gewachsen, das muss man nicht alles sofort machen / können und hängt auch sehr von den eigenen Bedürfnissen ab. Inzwischen bin ich jedenfalls ein großer Fan von pandoc. Für Deine einfache Beschreibung oben brauchst Du das alles vielleicht gar nicht, aber falls doch, ist pandoc sehr gut erweiterbar. Viele Grüße Karl
Am 22.01.23 um 10:32 schrieb Karl Weber:
On Wednesday, 18 January 2023 16:14:22 CET Jörg Thümmler wrote:
worin setzt Ihr sowas um: Eine Doku mit 4... 5... Menüebenen, am besten als Menü auf einer Seite und Inhalte inkl. Grafiken, möglichst nicht zu steile Lernkurve, für die Inhalte vielleicht Markdown o.ä. und die Menüverwaltung nicht zu umständlich, Ausgabe in HTML im LAN, muss also nicht extra sicher sein...
Ich habe mir so etwas selbst gebaut. Basis ist pandoc mit pandoc's markdown. Den build habe ich mit make automatisiert. Unzulänglichkeiten habe ich mit verschiedenen Boardmitteln von pandoc-Erweiterungen gelöst:
- Inhaltsverzeichnis (TOC) - HTML-Templates - CSS style-Files - Lua-Scripts - Syntax-Highlighting mit einem eigenen KDE-style XML definition file erweitert. (Wenn einem das von pandoc nicht gefällt.) - ...
Meine Struktur besteht aus verschiedenen Büchern auf höchster Ebene und dann darunter aus HTML-Seiten, die links jeweils ein Inhaltsverzeichnis pro Buch haben und rechts Text. Alles natürlich navigierbar.
Wie man so etwas machen kann, steht alles in der sehr guten Dokumentation von pandoc.
Alles in allem ist das mit der Zeit immer umfangreicher geworden. Das schöne ist, dass pandoc an sich eine sehr schöne Plattform ist und schon sehr viel kann. Meine Erweiterungen sind mit der Zeit gewachsen, das muss man nicht alles sofort machen / können und hängt auch sehr von den eigenen Bedürfnissen ab. Inzwischen bin ich jedenfalls ein großer Fan von pandoc.
Für Deine einfache Beschreibung oben brauchst Du das alles vielleicht gar nicht, aber falls doch, ist pandoc sehr gut erweiterbar.
Viele Grüße Karl
Hi und Danke für die Empfehluungen. Sphinx will bei mir nicht so recht... irgendwelche python-Fehler, bin nicht sicher, ob das nicht das Gleiche ist, was hier neulich über die Liste ging, mit python 2.x resp. 3.x, scheint mir aber wahrscheinlich eh overkill mit etwas zu steiler Lernkurve... pandoc ... hat ja wirklich eine gute Doku, das Markup werde ich wohl verwenden... für die Navigation werde ich meinen alten Kram wohl ausbauen müssen... vielleicht finde ich mal die Zeit, den Verzeichniskram später auch da drin zu bauen... Danke! -- cu jth
participants (3)
-
Holger Bruenjes -
Jörg Thümmler -
Karl Weber