Videos zum Kurs produzieren

Ein Video oben in der Lektion entsteht nicht neben dem Kurs, sondern aus ihm. Das Repository hat dafür einen eigenen Ordner video/, dessen Werkzeuge aus den fertigen Lektionen ein Skript und ein Foliendeck pro Lektion erzeugen. Diese Lektion zeigt den Weg von der eingefrorenen Lektion bis zur Video-ID im Frontmatter.

Wo die Videoquellen liegen

Der Ordner video/ spiegelt content/. Aus einer Lektion unter content/de/courses/<slug>/<abschnitt>/<lektion>.md wird ein Ordner video/de/courses/<slug>/<abschnitt>/<lektion>/ mit zwei Dateien:

video/de/courses/ihr-kurs-name/
├── README.md                      Videoliste und Stand
├── _trailer/                      Vorschau für die Kursseite
├── 10-getting-started/
│   └── 10-introduction/
│       ├── script.md              Szenen, Sprechtext, Regie
│       └── slides.md              Folien mit dem Sprechtext als Notizen
└── _outro/

Beide Dateien sind Markdown und liegen in Git. Ändert sich eine Lektion, ändern sich Skript und Deck im selben Merge Request, denn die Videos zitieren Kommandos und Ausgaben der Lektion wörtlich. Aufnahmen und fertige Videodateien gehören nicht ins Repository; dafür gibt es das TIB AV-Portal, siehe unten.

Die Werkzeuge im Ordner sind vom Website-Build unabhängig. Einmalig installieren:

make video-install

Das Gerüst aus den Lektionen erzeugen

Erst wenn der Kurs inhaltlich fertig ist, lohnt sich der nächste Schritt: Ein Video zementiert den Stand seiner Lektion, und jede spätere Korrektur am Text erreicht die Zuschauenden nicht mehr.

Führen Sie aus:

make video-new-course COURSE=ihr-kurs-name

Der Befehl liest Abschnitte und Lektionen des Kurses und legt pro Lektion den Ordner mit script.md und slides.md an, dazu _trailer/, _outro/ und das Kurs-README mit der Videoliste:

created _trailer
created 10-getting-started/10-introduction
created 10-getting-started/20-setup-environment
…
created _outro
created README.md

13 lesson folder(s) created for "Wie man einen Kurs erstellt"

Vorbefüllt sind Titel, Beschreibung und die Ziel-Länge aus duration. Die ##-Überschriften der Lektion werden zu Szenen im Skript und zu Folien im Deck. Codeblöcke der Lektion, also Kommandos, Terminal-Ausgaben und Dateiinhalte, stehen wörtlich in der passenden Folie. Die erste Frage aus dem ## Check samt Antwort bildet die Schlussfolie. Vorhandene Ordner lässt der Befehl in Ruhe, nach einer neuen Lektion können Sie ihn also erneut ausführen.

Was der Befehl nicht kopiert, ist der Fließtext. Der Sprechtext wird fürs Sprechen geschrieben, nicht zum Vorlesen der Lektion.

Skript und Deck ausfüllen

Das Skript beschreibt jede Szene mit Bild, Sprechtext und Regie: Was ist auf dem Bildschirm zu sehen, was wird dazu gesagt, wann ist die Kamera eingeblendet. Die Regeln dafür stehen in video/GUIDE.md, mit Quellen aus der Forschung zu Lehrvideos. Die wichtigsten:

• ein Lernziel pro Video, unter sechs Minuten
• Code und Terminal-Ausgaben als Text auf der Folie, nie als Screenshot
• keine Lektionsnummern im Bild oder im Sprechtext, damit sich Videos später einschieben lassen
• am Ende eine Frage aus dem Check mit Pause vor der Antwort
• der Trailer beginnt ohne Fachbegriffe; welche das sind, steht in terms.json neben dem Kurs-README, und die Prüfung meldet sie im Aufhänger
• Fachbegriffe mit Definition bekommen beim ersten Nennen eine Glossar-Karte im Video, und die Lektionsseite zeigt dieselben Definitionen unter dem Video

Das Deck ist eine Slidev-Präsentation in Markdown. Der Sprechtext steht als Kommentar unter jeder Folie, [click]-Marken darin gehören zu den Einblendungen. Zum Bearbeiten und späteren Aufnehmen starten Sie ein Deck so:

make video-slides LESSON=introduction

Der Befehl öffnet das erste Deck, dessen Pfad das Wort enthält. Unter http://localhost:3030/ liegt die Folienansicht, unter http://localhost:3030/presenter/ die Presenter-Ansicht mit dem Sprechtext neben der Folie. Beim Aufnehmen ist die zweite Ansicht der Teleprompter.

Prüfen und exportieren

Vor der Aufnahme bauen Sie alle Decks des Repositories einmal durch; kaputte Folien fallen hier auf:

make video-check

Zum Korrekturlesen außerhalb des Browsers schreibt der Export ein PDF-Handout mit Folie und Sprechtext nebeneinander sowie den Sprechtext als Markdown:

make video-export LESSON=ihr-kurs-name

Das Ergebnis liegt unter video/renders/export/, einem Ordner, den Git ignoriert.

Aufnehmen und veröffentlichen

Aufgenommen wird pro Szene, nicht pro Video, mit OBS und der Presenter-Ansicht auf dem zweiten Monitor. Das Setup mit Szenen und Hotkeys beschreibt video/RECORDING.md.

Das geschnittene Video laden Sie ins TIB AV-Portal hoch. Die dortige ID kommt in das Frontmatter der Lektion, wie in der vorherigen Lektion beschrieben:

video:
  tibav: 42061

Damit ist die Lektion der einzige Ort, der festhält, ob und welches Video zu ihr gehört.

Als Faustregel: Videos erst nach dem Content-Freeze, Skript und Deck immer im selben Merge Request wie die Lektion, Aufnahmen nie ins Repository.

Check