Pandoc Markdown Lecture Template: This project defines a skeleton repo for creating lecture slides and handouts including lecture notes out of Pandoc Markdown (https://pandoc.org/MANUAL.html) using a single source approach.
MIT License
97
stars
18
forks
source link
Tooling to create a single GFM file containg all lessons #293
Ä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 #291 zunächst individuelle GFM-Dateien erstellen, aber ohne Quellenverzeichnis (letzten Schritt in #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
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?
Ä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:
pandoc readme.md ebeneA/readme.md ebeneA/file1.md ...
summary.md
bei mdBook)Fragen: