Skip to content

Latest commit

 

History

History
145 lines (94 loc) · 3.33 KB

PITCHME.md

File metadata and controls

145 lines (94 loc) · 3.33 KB
Raw

Static Site Generators für die Entwicklung von OER nutzen

Axel Dürkop, Andreas Böttger, Tina Ladwig, ITBH an der TUHH

Elevator Pitch

"Wir haben an der TUHH ein technisches System entwickelt, mit dem wir OER erstellen, verarbeiten, vermischen und verbreiten können. Dafür nutzen wir GitLab und Static Site Generators."

Agenda

Ziele des Workshops

  • Vorstellen eines 5R-gemäßen OER-Kreislaufs
  • Aufzeigen
    • des Potenzials von Git
    • des großen Mehrwerts von Markdown
    • der Vorzüge von Docker für technische Lernsysteme, ehemals E-Learning

Der Technikstack

+++

Markdown

  • Wileys 5R und ALMS-Framework
  • Aus Markdown kann Vieles entstehen
    • mittels pandoc
    • mittels Static Site Generators

+++

Static Site Generator

  • Definition: Programm, die aus Textdateien ein statisches HTML-Kontrukt erzeugt
  • Beispiele:
    • Jekyll
    • GitBook
    • Hugo
    • Middleman
  • Ausführen des Programms in der Regel auf der Kommandozeile

+++

GitBook

  • Static Site Generator der einfachen Art
  • sowohl proprietärer Dienst (gitbook.com) als auch freie Software (Apache 2.0)

+++

GitLab

  • freie Software (MIT-Lizenz) für das Selberhosten eines "GitHubs"
  • (+) einfachere integrierte Workflows
  • (+) volle Kontrolle über Daten und Konfiguration
  • (-) Die Musik spielt immer noch auf GitHub
  • (+/-) kein zentraler Ort

+++

Docker

  • Vitualisierung von Diensten in Containern
  • (+) schnelles Ausprobieren
  • (+) Reproduzierbarkeit von Umgebungen
  • (+) Skalierbarkeit
  • (-) unausgereifte Administrationstools

Der technische Ablauf

  • Autor_innen ergänzen/verändern Inhalte in GitLab.
  • Dadurch zieht sich ein GitLab-Runner die aktuellen Markdown-Dateien aus GitLab
  • Ein neuer Docker-Container wird gestartet, in dem alle Softwarekomponenten für die Generierung bspw. eines GitBooks enthalten sind.
  • Das GitBook-HTML-Konstrukt sowie das GitBook-PDF werden erzeugt.
  • Entstandene Artefakte werden auf einen Webserver geschoben.
  • Der Vorgang dauert ca. 30 Sekunden und kann anschließend von vorne begonnen werden.

Soziale Workflows

  • transparente Kollaboration durch branches und WIP Merge Requests
  • Brainstorming und Vorbereitung der Gliederung im Wiki des Repos
  • Entwicklungsversionen durch Branches (Review Apps)
  • Qualitätssicherung durch Merge Requests und Commit Comments

+++

Beispiel: Commit Comments

Feedback in einem Commit geben

Ausprobieren!

+++

Anmeldung in GitLab

Wir arbeiten mit vorbereiteten Nutzeraccounts in einem vorbereiteten Projekt.

Zusammenarbeit

Szenario:

  • Kurze Planung, Gliederung, Thema: Tiere
  • Branch [lieblingstier] erstellen
  • Neue Datei [lieblingstier].md anlegen
  • -> Inhalte einpflegen, speichern
  • | Vorschau des Branches ansehen
  • <- WIP Merge Request auf den master stellen

Abschluss & Diskussion

+++

Fragen

  • Wie können mit dem vorgestellten System die 5R von Wiley eingelöst werden?