Kurs in der Vorschau testen

Vor der Einreichung läuft der Kurs einmal komplett lokal durch. Diese Lektion beschreibt, wie die Vorschau startet und welche Punkte dabei zu prüfen sind.

Den lokalen Entwicklungsserver starten

1. ein Terminal öffnen und in das Projektverzeichnis wechseln

2. den Entwicklungsserver starten:

   • mit npm:

     npm start
     

   • mit Docker:

     npm run docker:up
     

3. sobald der Server läuft, die Seite im Browser öffnen:

   http://localhost:1313
   

Den Kurs in der Vorschau ansehen

1. die Kursseite aufrufen:

   http://localhost:1313/de/courses/<Ihr-Kursname>
   

2. die Kursübersichtsseite prüfen:

   • alle Metadaten korrekt (Titel, Beschreibung, Tags usw.)
   • Kursbild und Video (sofern vorhanden) werden angezeigt
   • Kursziele und Voraussetzungen sind richtig aufgeführt

3. durch jede Lektion navigieren:

   • über die Schaltflächen „Kurs starten“ und „Nächste Lektion“ durch den Kurs gehen
   • die Reihenfolge der Lektionen prüfen

Den Kursinhalt testen

Während der Vorschau stehen fünf Prüfungen an:

1. Inhaltsanzeige:

   • Markdown wird korrekt gerendert (Überschriften, Listen, Codeblöcke usw.)
   • alle Links funktionieren und zeigen auf die richtigen Ziele

2. Medienanzeige:

   • Bilder werden korrekt und unverzerrt angezeigt
   • Videos lassen sich abspielen
   • herunterladbare Ressourcen sind erreichbar

3. Navigation:

   • alle Navigationselemente funktionieren (vorherige/nächste Lektion, Kursübersicht)
   • die Kursabschnitte sind richtig organisiert

4. Responsivität:

   • der Kurs funktioniert auf verschiedenen Bildschirmgrößen (die Entwicklertools des Browsers helfen dabei)
   • Inhalte und Medien passen sich mobilen Geräten an

5. Barrierefreiheit:

   • alle Bilder haben passenden Alternativtext
   • der Farbkontrast reicht für gute Lesbarkeit

Korrekturen vornehmen

Wenn in der Vorschau Probleme auftauchen:

1. den Entwicklungsserver stoppen (Strg+C im Terminal)
2. die Kursdateien korrigieren
3. den Server neu starten und erneut testen

Übung: Den Kurs testen

1. den lokalen Entwicklungsserver starten
2. den gesamten Kurs durchgehen, Lektion für Lektion
3. alle oben aufgeführten Prüfungen durchführen
4. gefundene Probleme notieren und beheben
5. erneut testen, bis alle Korrekturen sitzen

Die nächste Lektion behandelt die Einreichung des Kurses über einen GitLab Merge Request.