Open
Description
Ähnlich wie in #291 soll aus den in Pandoc-Markdown (mit YAML) vorliegenden Lektionen ein GitHub-Markdown-basiertes File entstehen.
Dabei sollen aber alle Dateien in der korrekten Reihenfolge konkateniert werden. Es soll für die resultierende Datei ein Gesamtquellenverzeichnis geben.
Vermutliches Vorgehen:
- Erstellen der Ausgangsdateien: Wie in Tooling to create GFM files per lesson #291 zunächst individuelle GFM-Dateien erstellen, aber ohne Quellenverzeichnis (letzten Schritt in Tooling to create GFM files per lesson #291 weglassen) => jede Lektion hat den richtigen Aufbau inkl. der Boxen für "TLDR" etc., aber noch kein Literaturverzeichnis (nur die Pandoc-Referenzen)
- Erkennen der benötigten Dateien: Analog zum Warping-Filter rekursiv beginnend mit dem Readme alle lokalen Links auf Markdown-Dateien und Abbildungen ablaufen. Pro Ebene jeweils das Readme und die Markdowns in der Reihenfolge des Auftretens sowie die Ordner der nächsten Ebenenen speichern.
- Variante 1
- Über den entstehenden Baum die Header anpassen
- Konkatenation per Makefile-Snippet (generieren lassen):
pandoc readme.md ebeneA/readme.md ebeneA/file1.md ...
- Variante 2
- Eine Art Startdatei mit Links erzeugen (ala
summary.md
bei mdBook) - Mit Pandoc und einem der vorhandenen Include-Filter das Gesamtdokument erzeugen
- Eine Art Startdatei mit Links erzeugen (ala
- Als letzten Schritt ggf. nochmal Citeproc zur Generierung des Literaturverzeichnisses
Fragen:
- Was ist mit Abbildungen? Müssen die bewegt werden?
- Was ist mit lokalen Links? Müssen die angepasst werden?
Metadata
Metadata
Assignees
Labels
No labels
Projects
Status
Backlog