📚 Gegenstand

Im Mittelpunkt dieses Beitrags steht die technische Infrastruktur hinter dem SciBlog iWIP. Ziel ist eine offene, frei verfügbare und OER-kompatible Plattform für Wissenschaftskommunikation und Lehre.

Die eingesetzten Tools ermöglichen sowohl effizientes Publizieren als auch kollaboratives Arbeiten mit Co-Autor:innen.

Der SciBlog iWIP ist jedoch kein rein technisches Projekt, sondern folgt einem didaktischen Primat: Die technische Infrastruktur dient der Unterstützung von Lehr-Lern-Prozessen, deren Planung, Reflexion und Veröffentlichung.

Die Technik wird daher bewusst einfach gehalten und an didaktischen Anforderungen ausgerichtet – nicht umgekehrt.


1️⃣ Entwicklungsumgebung „GitHub“

  • 🌐 GitHub als öffentliche Softwareentwicklungsplattform: https://github.com
    Ich nutze die Plattform GitHub, die eine benutzerfreundliche Umgebung für die Entwicklung, Versionierung und Veröffentlichung von Code bietet. Die Zusammenarbeit an Code wird durch die Versionsverwaltungs-Software Git transparent dokumentiert. GitHub ist für Open-Source-Projekte kostenfrei.

  • 🚀 GitHub Pages als Host: https://pages.github.com
    Der Blog wird direkt über GitHub Pages im Internet veröffentlicht.


2️⃣ Webseitengenerator „Hugo“

  • ⚡ Hugo als Generator: https://gohugo.io
    Hugo ist ein schneller und vielseitiger Webseitengenerator, der Markdown-Dateien in statische HTML-Seiten umwandelt. Er eignet sich besonders gut für die Veröffentlichung über GitHub Pages und unterstützt eine effiziente Automatisierung via GitHub Actions. ✅ Da rein statische Seiten generiert werden, ist die Ladegeschwindigkeit hoch, das Hosting einfach und die langfristige Archivierbarkeit ganz im Sinne von OER.

  • 📦 Hugo Modules als Modulverwaltung: https://gohugo.io/hugo-modules/
    Die Verwaltung von Themes und Erweiterungen erfolgt über Hugo Modules. Diese bieten gegenüber klassischen Git Submodules eine einfachere, robustere und wartungsärmere Lösung – besonders im Teamkontext.

  • 🎨 PaperMod als Theme: https://github.com/adityatelange/hugo-PaperMod
    Das PaperMod-Theme überzeugt durch minimalistisches Design, hohe Anpassbarkeit über Custom CSS und gute Dokumentation.

  • 🖥️ Reveal-Hugo als Präsentationserweiterung: https://github.com/joshed-io/reveal-hugo
    Mit Reveal-Hugo können Blogbeiträge auch als interaktive Online-Präsentationen (basierend auf reveal.js) dargestellt werden – ein Feature, das ich in meinen Lehrveranstaltungen aktiv nutze.

  • 🎇 GitHub Actions für automatisiertes Deployment: https://github.com/astefanutti/decktape Es werden erweiterte Build-Prozesse genutzt, z. B. der PDF-Export für Präsentationen über DeckTape.


3️⃣ Quelltext-Editor Visual Studio Code

Zur Programmierung der Webseiten nutze ich 📝 Visual Studio Code https://code.visualstudio.com, der über zahlreiche Erweiterungen, z. B. Markdown All in One oder Live Preview, individuell erweitert und angepasst werden kann. 💡 Kleinere Änderungen nehme ich auch über GitHub selbst vor.


4️⃣ KI-Unterstützung

🤖 Für die Konzeption des SciBlogs iWIP sowie für die technische Umsetzung nutze ich die KI ChatGPT.
Sie kommt insbesondere bei der Ideensammlung, der Codeoptimierung, der Fehlersuche, dem Schreiben von Dokumentationen sowie der didaktischen Aufbereitung von Inhalten zum Einsatz.


5️⃣ Didaktischer Planungsagent

Ein zentrales Element des SciBlog iWIP ist ein didaktischer Planungsagent, der die Entwicklung von Lehr-Lern-Inhalten unterstützt.

Der Agent verbindet den Arbeitszusammenhang:

Planung → Blog → Präsentation

Er arbeitet dialogisch und strukturierend und unterstützt insbesondere die didaktische Ausarbeitung von Inhalten. Der Blog dient dabei als zentrales Arbeitsdokument.

Weitere Informationen finden sich in der Agentendokumentation: → ai_agents/README.md


6️⃣ Automatisierte Metadatenpflege

Zur Verbesserung der Auffindbarkeit und Interoperabilität werden Metadaten automatisiert gepflegt und aktualisiert.

Dies erfolgt über GitHub Actions, die Änderungen an Metadaten im Repository automatisiert committen können.

Dadurch können auch ohne manuelle Eingriffe Aktualisierungen im Repository entstehen.

Diese Automatisierung ist insbesondere für die Anbindung an OER-Infrastrukturen wie OERSI relevant.


7️⃣ Struktur


8️⃣ Zusammenarbeit

  • 👥 Alle interessierten GitHub Nutzer:innen können über Pull Requests im Repository Beiträge oder Änderungen vorschlagen und so transparent dokumentiert als Co-Autor:innen am Projekt mitwirken.
  • 🤝 Collaborator:innen können direkt im Fork https://github.com/kiwip2025/iWIP arbeiten, Beiträge erstellen und live unter https://kiwip2025.github.io/iWIP/ testen, bevor sie ihre Inhalte über Pull Requests in das Hauptprojekt einbringen.

9️⃣ Versionierung & Reifegrad von Blogbeiträgen

🛠️ Entwicklungslogik des SciBlog iWIP: Neben der technischen Infrastruktur folgt der SciBlog iWIP einer transparenten Entwicklungslogik für Lehr-Lern-Einheiten.

Im SciBlog iWIP werden Lehr-Lern-Einheiten nicht nur veröffentlicht, sondern kontinuierlich weiterentwickelt.
Um diesen Entwicklungsprozess transparent zu machen, werden zwei unterschiedliche Angaben ausgewiesen:


🧩 Version (X.Y)

Die Version beschreibt Veränderungen an der Struktur oder am Inhalt einer Einheit.

  • X (Hauptversion)
    Eine neue Hauptversion (z. B. 2.0) bedeutet eine grundlegende didaktische Überarbeitung, etwa eine neue Zielgruppe, eine veränderte Struktur oder eine konzeptionelle Neuausrichtung.

  • Y (Unterversion)
    Unterversionen (z. B. 1.1, 1.2) markieren inhaltliche Ergänzungen, Präzisierungen, sprachliche Überarbeitungen oder kleinere didaktische Anpassungen.

Die Version macht sichtbar, was sich verändert hat.


🚦 Reifegrad (Status)

Der Status beschreibt den Entwicklungsstand einer Lehr-Lern-Einheit.

Die Reifegrade sind:

SymbolBezeichnungBedeutung
🟡EntwurfDie Einheit befindet sich noch im Aufbau. Struktur oder Inhalte können sich ändern.
🟠In ErprobungDie Einheit wird aktuell in der Lehre eingesetzt und weiterentwickelt.
🔵StabilDie Einheit wurde mehrfach eingesetzt und ist zuverlässig nutzbar.
🟢Didaktisch abgestimmtDie Einheit ist didaktisch konsolidiert und reflektiert ausgearbeitet.

Wichtiger Hinweis

Der Reifegrad ist kein Qualitätsranking.
Er stellt keine Wertung dar, sondern macht transparent, in welcher Phase des Entwicklungsprozesses sich eine Einheit befindet.

Eine Einheit im Status „In Erprobung“ ist nicht „schlechter“ als eine „Stabile“ Einheit – sie befindet sich lediglich in einer anderen Phase der didaktischen Weiterentwicklung.

🔟 Versionierung der Plattform und des didaktischen Planungsagenten

Die Versionierung erfolgt auf mehreren Ebenen:

  • Lehr-Lern-Einheiten (OER): eigene Versionierung und Reifegrad (z. B. 1.0, „In Erprobung“), siehe oben
  • Plattform (SciBlog iWIP): markiert größere Entwicklungsschritte (Version 1.1)
  • Agent: eigenständige Versionierung (Version 1.0)

Kleinere technische Änderungen werden nicht versioniert.