Angenommen, ich habe ein Handbuch für ein Computerprogramm im Markdown-/Org-Mode-Format. Das Handbuch ist als Buch mit Kapiteln, Abschnitten und Unterabschnitten geschrieben.
Ich weiß, dass Pandoc diese Markdown-Datei in HTML konvertieren kann. Aber was ist, wenn ich beispielsweise jedes Kapitel in eine eigene HTML-Seite umwandeln und auf das nächste und vorherige Kapitel oder den nächsten und vorherigen Abschnitt verlinken möchte?
Sehen Sie sich beispielsweise die Website zur Dokumentation von SWIG an.http://swig.org/Doc3.0/Sections.htmlDies ist genau die Struktur, die ich mir für die Ausgabe von Pandoc in meiner Markdown-Datei wünsche.
Ich weiß, dass latex2html dies für Latex-Dateien kann und dass Pandoc Markdown in Latex konvertieren kann, aber mir gefällt die resultierende Ausgabe nicht. Ich würde eine reine Pandoc-Lösung ohne externe Programme bevorzugen.
Antwort1
Dies ist nicht ganz trivial. Ein guter Ansatz wäre, eine benutzerdefinierte HTML-Vorlage zu schreiben, die von pandoc verwendet werden kann.
% pandoc -D html > my-page-template.html
# edit my-page-template.html to your liking
Diese Vorlage könnte Links zur vorherigen und nächsten Seite enthalten, sofern vorhanden.
$if(next-page)$<a href="$next-page$">next</a>$endif$
Die jeweiligen Dateinamen würden über die Befehlszeile übergeben, sodass Pandoc die richtigen Werte einfügen kann.
pandoc -M next-page=introduction.html --template=my-page-template.html …
Ein in Shell oder einer anderen Skriptsprache geschriebenes Wrapper-Skript wäre wahrscheinlich nützlich.
Wie Sie sehen, kann das ziemlich viel Arbeit bedeuten. Glücklicherweise hat das schon jemand gemacht und in ein R-Paket gepackt:Buchdown. Es erzeugt großartige Ergebnisse und ich kann es wärmstens empfehlen.