Kursdateien erstellen

Kursdateien erstellen

In dieser Lektion werden wir den Prozess der Erstellung der notwendigen Dateien für Ihren Kurs durchgehen, einschließlich der Kursübersicht und einzelner Lehrdateien.

Erstellen der Kursübersicht-Datei

  1. Navigieren Sie zu Ihrem Projektverzeichnis
  2. Erstellen Sie einen neuen Kurs mit dem Hugo-Befehl:
hugo new courses/<kebab-style-course-name>/_index.md
  1. Öffnen Sie die _index.md-Datei und fügen Sie die Frontmatter ein:
---
title: "Ihr Kurs Titel"
description: "Eine kurze Beschreibung Ihres Kurses"
summary: "Eine Zusammenfassung der Kursinhalte"
type: "Kurse"
layout: "kurs"
date: YYYY-MM-DD
# lastUpdated: "Juli 2026"             # Optionaler Anzeige-Override
tags: ["tag1", "tag2", "tag3"]
levels: "anfänger/fortgeschrittene/expert"
video:
  youtube: YOUR_VIDEO_ID              # YouTube Video-ID (empfohlen)
  # vimeo: 123456789                  # oder Vimeo Video-ID
  # tibav: 42061                      # oder TIB AV-Portal ID
image: kurs-thumbnail.png             # Bild aus dem _media/-Ordner
# duration: 90                        # Optionaler Kurs-Override in Minuten
lessonCount: X
firstLessonURL: "/de/courses/your-course-name/lesson1/"
featured: true/false
certificate: true/false
objectives:
  - "Ziel 1"
  - "Ziel 2"
prerequisites:
  - "Voraussetzung 1"
  - "Voraussetzung 2"
programmingLanguages:
  - "Sprache 1"
  - "Sprache 2"
authors:
  - name: "Ihr Name"
    role: "Ihre Rolle"
    avatar: "/images/placeholders/avatar.svg"
---

# Kursinhalt kommt hier hin

Ohne duration im Kursindex summiert die Kursseite automatisch alle Lektionsdauern. Setzen Sie dort nur dann eine numerische Minutenzahl, wenn Sie die berechnete Gesamtdauer überschreiben möchten. Ebenso wird ohne lastUpdated automatisch die jüngste Git-Änderung des Kursindex oder einer Lektion angezeigt.

Erstellen von Lehrdateien

  1. Für jede Lektion in Ihrem Kurs erstellen Sie eine neue Datei:
hugo new courses/<kebab-style-course-name>/<prefix>-<kebab-style-lesson-name>.md
  1. Öffnen Sie jede Lehrdatei und fügen Sie die Frontmatter ein:
---
title: "Lektion Titel"
description: "Kurze Beschreibung der Lektion"
type: "Kurse"
course: "ihr-kurs-name"
layout: "lektion"
lessonNumber: X
courseSection: "Kurs Abschnitt Name"
duration: X                           # Optional: geschätzte Minuten
image: erste-schritte/lektion-thumbnail.png  # Bild aus _media/-Unterordner
video:
  youtube: YOUR_VIDEO_ID              # YouTube Video-ID (empfohlen)
  # vimeo: 123456789                  # oder Vimeo Video-ID
---

# Lehrinhalt kommt hier hin

duration: 5 ist die Kurzform für fünf Minuten. Für genauere Angaben können Sie die Komponenten einzeln angeben:

duration:
  hours: 1
  minutes: 2
  seconds: 30
  factor: 1.5                       # Optionaler positiver Multiplikator

Alle Komponenten und factor sind optional; ohne Faktor gilt 1. Mit ausschließlich factor: 2 wird die automatisch geschätzte Dauer verdoppelt. Ohne explizite Lektionsdauer schätzt Hugo die Zeit aus Fließtext, Codeblöcken und Bildern. Die Kursseite addiert die exakten Werte und rundet erst die Gesamtdauer auf volle Minuten auf.

Organisieren Ihrer Dateien

Stellen Sie sicher, dass Ihre Dateien gemäß der empfohlenen Struktur organisiert sind:

content/
└── de/
    └── courses/
        └── ihr-kurs-name/
            ├── _index.md
            ├── _media/
            │   ├── index.md
            │   ├── kurs-thumbnail.png
            │   └── erste-schritte/
            │       └── lektion-thumbnail.png
            ├── 10-erste-schritte/
            │   ├── _index.md
            │   ├── 10-einfuehrung.md
            │   └── 20-erste-schritte.md
            ├── 20-fortgeschrittene-themen/
            │   ├── _index.md
            │   └── 10-fortgeschrittenes-thema.md
            └── ...

Übung: Erstellen Sie Ihre Kursdateien

  1. Erstellen Sie die Kursübersicht-Datei für Ihren geplanten Kurs
  2. Erstellen Sie mindestens drei Lehrdateien, die der Namenskonvention folgen
  3. Füllen Sie die Frontmatter für jede Datei mit entsprechenden Informationen aus

In der nächsten Lektion werden wir uns darauf konzentrieren, effektive Kursinhalte mit Markdown zu schreiben.