Hinweise zur Nutzung von Emacs-Reveal-Präsentationen

Die Präsentationen werden mit emacs-reveal erzeugt und nutzen das HTML-Framework reveal.js.

Tastaturbelegung und Navigation
- Druck von „?“ zeigt Tastaturbelegung von reveal.js
- Tasten „n“ und „p“ führen zu nächster und vorangehender (previous) Folie; Mausrad funktioniert
- Auf/ab (Wischen, Cursor-Tasten) navigieren innerhalb von Abschnitten, links/rechts zwischen Abschnitten („o“ zeigt, was wo liegt)
- Eingabe von Foliennummer gefolgt von Return/Enter/Eingabetaste führt zur entsprechenden Folie
- Browser-Historie (möglicherweise sind zwei Versuche nötig)
- Zoom mit Strg-Maus oder Alt-Maus
- Suche mit Strg-Umschalt-F („Eingabetaste“ für weitere Suchtreffer)
- Seit August 2021 nutzen Präsentationen den linearen Navigationsmodus von Reveal.js. Der URL-Parameter default-navigation ändert dies zum voreingestellten Navigationsmodus von Reveal.js (z. B. https://oer.gitlab.io/emacs-reveal-howto/howto.html?default-navigation).
PDF-Export
- Ändern der Browser-URL durch Hinzufügen des URL-Parameters print-pdf (z. B. https://oer.gitlab.io/OS/Operating-Systems-JiTT.html?print-pdf), dann in PDF-Datei drucken (Strg-p)
  - Reveal.js gibt an, dass dies mit dem Chromium/Chrome funktioniert, vorgeschlagene Einstellungen
  - Neuere Projekte erstellen diese PDF-Variante möglicherweise direkt; Lehrende geben dann einen entsprechenden Hinweis
- Je nach Projekt sind möglicherweise bereits PDF-Dateien aus den Quelldateien generiert worden. In diesem Fall kann die Endung .html der URL einer Präsentation durch .pdf ersetzt werden.
- Alternativ können Sie statt eines PDF-Exports die Quelldateien im Texteditor kommentieren oder ergänzen
  - Org Mode, reines Textformat
Offline-Verwendung
- Präsentationen können als ZIP-Archive von Build-Pipelines ihrer Quellprojekte heruntergeladen werden
  - Archiv-Inhalte extrahieren, lokale HTML-Datei(en) im Browser öffnen
  - Z. B. von Pipelines eines Kurses zu Betriebssystemen durch Klick auf Download-Icon der aktuellsten Pipeline
- Alternativ können Präsentationen lokal aus Quelldateien erzeugt werden
Audio
- Falls vorhanden liegen Tonspuren im freien Ogg-Format vor
  - Nach Rückmeldungen von Studierenden startet der Ton nicht automatisch (aber seit August 2021 kann dies mit dem URL-Parameter audio-autoplay geändert werden)
    - Kompatibilität und bekannte Probleme des zugrunde liegenden Audio-Plugins
    - Firefox scheint überall zu funktionieren
  - Audio-Steuerung links unten (weitere Optionen wie Geschwindigkeit per Rechts-Klick)
    - URL-Parameter audio-speed ändert die Geschwindigkeit für die gesamte Präsentation, z. B. audio-speed=2.0 für doppelte Geschwindigkeit (Parameter existiert seit Juni 2022)
  - Start und Pause von Ton über Taste „+“ (oder „a“ für ältere Präsentationen)
Notizen
- Folien enthalten Notizen, wenn das Ordner-Symbol dargestellt wird
  - Taste „v“ öffnet „Courseware-Ansicht“; alternativ öffnen Klick auf das Symbol sowie Taste „s“ die Vortragsansicht
    - Pop-Ups müssen für Vortragsansicht erlaubt werden
    - Wenn das Pop-Up-Fenster nicht funktioniert, kann es helfen, erneut „s“ zu drücken oder das Pop-Up-Fenster einmal zu schließen
- Wenn die Folie eine Tonspur enthält, zeigen die Notizen den zugehörigen Text
Verweise/Hyperlinks
- In Präsentationen werden interne und externe Verweise (erstere heißen auch relativ, letztere zeigen auf einen externen Ziel-Server) unterschiedlich dargestellt
  - Verschiedene Farben für interne (blau) und externe (grün) Verweise
    - Für interne Verweise innerhalb einer Präsentation wird angezeigt, ob sie zu einer vorigen (◂) oder einer nachfolgenden (▸) Folie führen
  - Spezielle Link-Symbole für „nicht-lokale“ Verweise
    - Z. B. das generische Symbol in folgendem externen Verweis zu einer Seite mit Eräuterungen zu externen Verweisen; diese führen typischerweise zu Servern von Dritten mit eigenen Zielen und Datenschutzrichtlinien
    - Aber auch zu anderen Präsentationen (dies erlaubt es, Vorwärtsverweise zu erkennen und beim ersten Studium womöglich zu ignorieren)
    - Daneben könnten andere Symbole hindeuten auf
      - grundlegende Inhalte, z. B. Aufklärung (wer den Begriff nicht erklären kann, sollte vor dem Weitergehen in der Präsentation dem Verweis folgen; dies bedeutet nicht, dass die Seite vollständig gelesen werden muss…),
      - über Lernziele hinausgehende Inhalte, z. B. post-quantum cryptography (für die keine „Klausurrelevanz“ besteht)
      - Inhalte, die kurz angerissen und später vertieft werden (Symbol ↔)
  - Zusammenfassend werden in Präsentationen (aber nicht auf dieser Seite) verschiedene Darstellungen verwendet:
    - Extern (grün mit Symbol)
      - Ggf. mit verschiedenen Symbolen zur „Wichtigkeit“
    - Relativ zu anderer Präsentation (blau mit Symbol)
    - Relativ innerhalb selber Präsentation (blau), entweder zurück (◂) oder vorwärts (▸)
- Einige Studierende schlagen vor, Verweise zu entfernen. Dies lässt sich durch Hinzufügen des URL-Parameters hidelinks konfigurieren, wodurch die meisten Verweise verborgen werden. Zusätzlich können durch einen numerischen Wert wie hidelinks=24 verschiedene Arten von Verweisen basierend auf folgenden Bit-Werten verborgen werden:
  - 1: Verweise zu vorigen Folien
  - 2: Verweise zu nachfolgenden Folien
  - 4: Verweise zwischen Präsentationen
  - 8: Verweise zu anderen Ressourcen unter oer.gitlab.io
  - 16: Externe Verweise
  - 32: Verweise, die über Lernziele hinausgehen
  Beispielsweise werden mit hidelinks=28 (28 = 16 + 8 + 4) weder externe Verweise (16) noch Verweise unter oer.gitlab.io (8) noch Verweise zu anderen Präsentationen (4) angezeigt.

Die Nutzung der Präsentationen ist bei fehlenden Tastatureingaben in mobilen Browsern stark eingeschränkt. Neuere Präsentationen (seit April 2022) können je nach Betriebssystem und Browser ggf. im Browser-Menü als App-Icon zum Startbildschirm hinzugefügt werden und öffnen sich über dieses Icon ohne störende Adresszeile im Vollbildmodus.

Das Dokument CONTRIBUTING.org liefert Hinweise (auf Englisch), wie Sie Verbesserungsvorschläge für die OER der Gruppe oer auf GitLab einreichen können.