Skip to content

Journal Editor Handbuch

Der Journal Editor verwaltet Lerntexte, Lore, Hilfeseiten und globale Nachschlageinträge.

Zugriff

  1. Editor mit ?editor öffnen
  2. Tab Journal Editor wählen

Journal Editor

Der Screenshot zeigt einen geöffneten Journaleintrag mit:

  • rekursivem Journalbaum links
  • Toolbar für Erstellen, Umbenennen, Löschen und Refresh
  • Formular mit General- und Content-Tab

Organisation

Journaleinträge werden wie Quests in einer Baumstruktur organisiert:

  • Ordner für Themengebiete
  • JSON-Dateien für die einzelnen Einträge
  • Drag and Drop für Umstrukturierungen

Die Ordnerstruktur bildet zugleich die sichtbaren Kategorien im Spiel. Wer sauber nach Themen gliedert, schafft dadurch automatisch ein besser navigierbares Nachschlagewerk.

General-Tab

Hier werden die Metadaten gepflegt:

  • title
  • voice
  • condition
  • keepGlobal

keepGlobal

Ein Eintrag mit keepGlobal bleibt nach der Freischaltung auch in anderen Welten sichtbar. Das ist für allgemeine Lerntexte oder dauerhaft freigeschaltete Wissensseiten gedacht.

Content-Tab

Journal Editor - Inhalt

Der Content-Tab nutzt Monaco und akzeptiert HTML-basierte Inhalte.

Unterstützt werden:

  • HTML
  • Codeblöcke
  • Tabellen
  • Mermaid-Diagramme
  • Mermaid-Objektdiagramme
  • NSD-Struktogramme

Das ist derselbe Rich-Content-Pfad wie in Quests. Journal- und Questtexte verhalten sich also in der Darstellung konsistent.

Journalseiten können direkt auf andere Journalseiten verlinken:

<a href="journal:nrw_list">Zur NRWList</a>

Damit lassen sich Übersichtsseiten, Glossare oder kleine Lernpfade bauen. Der Link öffnet den referenzierten Journaleintrag direkt im Journal. Innerhalb eines Journal-Popups wird stattdessen die geöffnete Journalseite ausgetauscht.

NSD-Struktogramme eignen sich dabei nicht nur für Aufgaben, sondern auch für Erklärtexte. So kann etwa ein Algorithmus erst als Struktogramm erläutert und später in einer Quest als Java-Code umgesetzt werden.

Preview

Journal Editor - Vorschau

Über Preview kann der Eintrag direkt so geprüft werden, wie er später im Spiel angezeigt wird. Das ist besonders wichtig bei:

  • größeren HTML-Blöcken
  • Tabellen
  • Mermaid
  • NSD
  • Audio- und Textkombinationen

Die Vorschau ist damit kein Luxus, sondern ein zentraler Qualitätsschritt vor dem Speichern.

Speicherort

Journaleinträge liegen unter:

public/data/worlds/<world>/journal/**/*.json

Typische Einsatzfälle

  • Erklärtexte zu Java-Grundlagen
  • Nachschlagewissen zu Syntax oder API
  • Story- und Loretexte
  • freischaltbare Hilfeseiten nach Quests

Empfehlung für Autorinnen und Autoren

  1. Thema und Kategorie festlegen
  2. Sichtbarkeitsbedingung setzen
  3. optional Voice hinterlegen
  4. Inhalt mit Preview prüfen
  5. bei allgemein gültigen Einträgen keepGlobal bewusst setzen

Häufige Fehler

  • keepGlobal wird gesetzt, obwohl der Eintrag nur für eine einzelne Welt gedacht ist.
  • Bedingungen werden nicht getestet, sodass der Eintrag nie oder zu früh sichtbar wird.
  • Diagramme oder Tabellen werden gespeichert, ohne die Vorschau zu prüfen.
  • Das Journal wird als reiner Textspeicher genutzt, obwohl Beispiele, Code und NSD den Lerneffekt deutlich verbessern können.