# Goethe-Format 1 – Kurzfassung

Das offene Dateiformat von Goethe Write. Maßgeblich ist [die englische Fassung](GOETHE_FORMAT_1.md); diese Seite fasst
sie zusammen.

| | |
|---|---|
| Stand | Fassung 1.0 (Format 1), veröffentlicht 2026 |
| Beschreibt | genau das, was Goethe Write heute schreibt und liest |
| Namen | `.goethe`, `.goethex`, die Typkennungen und der MIME-Typ sind endgültig und ändern sich nie mehr |
| Lizenz | Spezifikation: CC BY 4.0, © 2026 ICSL FZE; Schemas und Referenz-Leser: MIT. Siehe [Lizenz](#lizenz). |
| Herausgeber | ICSL FZE, Sharjah, Vereinigte Arabische Emirate; Fragen an [hello@lexxington.com](mailto:hello@lexxington.com) |
| Adresse | https://goethecloud.com/format/ |

## Ein Inhalt, zwei Formen

| | Projekt | Austauschdatei | alte Projekte |
|---|---|---|---|
| Endung | `.goethe` (ein Ordner, den macOS und iOS als ein Dokument zeigen) | `.goethex` (dieselben Einträge als **eine** ZIP-Datei) | `.lexwrite` |
| Typkennung | `com.goethecloud.goethe.project` | `com.goethecloud.goethe.exchange` | `com.lexxington.write.project` |
| gehört zu | `com.apple.package`, `public.composite-content` | `public.data`, `public.content` (bewusst **kein** ZIP-Archiv, sonst böte der Finder das Archivprogramm an) | wie das Projekt |
| MIME-Typ | – | `application/vnd.goethecloud.goethex+zip` (noch nicht bei der IANA eingetragen) | – |
| im Finder | Goethe-Write-Projekt | Goethe-Write-Austauschdatei | Goethe-Write-Projekt (alt) |
| wozu | Arbeiten: schnell beim Sichern, gut für Git und Time Machine | Versenden: Mail, Cloud, Agentur, andere Programme | öffnet weiter |

- **`.lexwrite`** ist dasselbe Format unter seinem früheren Namen. Goethe Write öffnet es und sichert es an seinem
  Ort. Beim ersten ⌘S fragt es einmal, ob das Projekt die neue Endung bekommt („Sichern unter“; die alte Datei bleibt
  liegen). Umbenannt wird nie ungefragt.
- **Eine `.goethex` öffnen** ergibt am Mac ein neues, unbenanntes Projekt (die Datei selbst wird nie beschrieben), auf
  iPhone und iPad ein eigenes `.goethe`-Paket im Ordner der App.
- **Ablage ▸ Exportieren als ▸ „Goethe-Austauschdatei (.goethex)“** schreibt das ganze Projekt als eine Datei.

## Was im Paket liegt

```
Mein Roman.goethe/
  manifest.json      Fassung des Formats und welches Programm geschrieben hat
  project.json       Gliederung, Wissen (Kommentare, Quellen, Figurenentwicklung …), Einstellungen, Fensterstand
  texts/             je Eintrag ein Text als RTF (.rtf, mit Bildern .rtfd)
  files/             Recherche-Dateien
  snapshots/         gesicherte Fassungen
  deleted/           gelöschte Stellen mit Formatierung (nur wenn vorhanden)
  guides.json        Hilfslinien (nur wenn bearbeitet)
  watermarks/        Bild des Wasserzeichens (nur wenn gesetzt)
```

Unbekannte Einträge oben im Paket behält Goethe Write Byte für Byte. Unbekannte Schlüssel in `project.json` dagegen
nicht; neue Daten einer späteren Fassung kommen deshalb in eigene Dateien.

## Zeichenformate im Text

Was das RTF des Mac nicht trägt, steht in einer Gruppe, die andere Programme überspringen (Zusatz 5, seit dem
12. November 2026): `{\*\lexxchars v1 len=<L> <Anfang>+<Länge>:<Merkmal>[,<Merkmal>] …}`. `<L>` ist die Länge des
Texts in UTF-16-Einheiten, wie er geschrieben ist (Fußnote und Bild je ein Zeichen, Feld-Platzhalter mit ihren
Zeichen). Merkmale: `sc` Kapitälchen, `caps` Versalien (beide lassen die Buchstaben, wie sie geschrieben sind),
`hidden` ausgeblendeter Text (nicht gedruckt, nicht ausgegeben, nicht gezählt), `lang=<Tag>` die Sprache einer Passage
(BCP 47, etwa `en-GB`; Rechtschreibung und Silbentrennung folgen ihr). Die Gruppe gilt nur, wenn `<L>` die Länge des
gelesenen Texts ist und jeder Abschnitt den Regeln folgt, sonst gar nicht; unbekannte Merkmale werden übergangen.
Laufweite (`\expnd\expndtw`), doppelt durchgestrichen (`\striked1`) und Ligaturen aus (`\CocoaLigature0`) schreibt
und liest das RTF des Mac selbst. In Word heißen sie `w:smallCaps`, `w:caps`, `w:vanish`, `w:lang`, `w:spacing`,
`w:dstrike` und `w14:ligatures`.

## Umbruch und Füllzeichen

Je Absatz (Zusatz 6, seit dem 13. November 2026) eine Gruppe, die andere Programme überspringen:
`{\*\lexxparas v1 n=<P> <Abschnitt> …}`. `<P>` ist die Zahl der Absätze (gezählt wie beim Formatvorlagen-Datensatz),
ein Abschnitt ist `-` (keine eigenen Werte) oder die Merkmale des Absatzes mit `,` verbunden, mit `*<Anzahl>` für
mehrere gleiche hintereinander. Merkmale: `keepNext` (Nicht vom nächsten trennen), `keepLines` (Zeilen nicht trennen),
`pageBreakBefore` (Seitenumbruch oberhalb), `widowControl` (Absatzkontrolle), jeweils mit `=0` ausdrücklich aus, und
`tab<Twips>=dot|hyphen|underscore` (Füllzeichen Punkte, Striche, Linie am Tabulator dieser Stelle, 1/20 Punkt). Die
Gruppe gilt nur, wenn die Zahlen mit den Absätzen des Texts übereinstimmen, sonst gar nicht; unbekannte Merkmale werden
übergangen. Das RTF des Mac trägt nichts davon. In `project.json` hat jede Formatvorlage dazu die vier freiwilligen
Schlüssel `keepWithNext`, `keepLines`, `pageBreakBefore`, `widowControl` (fehlen sie, gilt das Bisherige:
Überschriften bleiben beim nächsten Absatz und ganz, Absatzkontrolle an). Ein eigener Wert des Absatzes geht dem der
Formatvorlage vor. In Word heißen sie `w:keepNext`, `w:keepLines`, `w:pageBreakBefore`, `w:widowControl` und
`w:tab w:leader`.

## Fassungen

`manifest.json` trägt `format` (die Fassung, in der geschrieben wurde) und `readableFrom` (ab welcher Fassung ein
Leser das Paket ohne Verlust öffnen, ändern und sichern darf). Fehlt die Datei, ist es Fassung 1. Braucht ein Paket
einen neueren Leser, lehnt Goethe Write es mit einem Satz ab; ein neueres Paket, das es lesen darf, öffnet es und
behält beim Sichern die höhere Nummer.

## Die Austauschdatei

Erster Eintrag ist `mimetype`, ungepackt, mit genau `application/vnd.goethecloud.goethex+zip` (wie bei EPUB und
OpenDocument; Programme erkennen die Datei daran), dann `manifest.json`, dann alles Übrige. Gleich sind zwei
Austauschdateien, wenn ihre ausgepackten Einträge gleich sind, nicht ihre ZIP-Bytes. Beim Lesen lehnt Goethe Write
mit einem Satz ab: Namen, die aus dem Paket führen, Verweise, Verschlüsselung, doppelte oder überlappende Einträge,
falsche Prüfsummen, ZIP64, mehr als 50.000 Einträge oder mehr als 2 GB ausgepackt. Nie ein Absturz.

## Datenschutz

Eine Austauschdatei enthält **das ganze Projekt**: auch gesicherte Fassungen, gelöschte Stellen, Kommentare mit Namen,
verfolgte Änderungen, Recherche-Dateien und die Originalbytes eingelesener Drehbücher. Nie enthalten: Fensterrahmen
und Spaltenbreiten des Geräts, Schlüssel, Passwörter, Kontodaten.

## Was in Fassung 1 fest ist und was später kommt

Fest: die beiden Formen und ihre Namen (endgültig seit Fassung 1.0), die Regeln von `manifest.json` und der
Austauschdatei, der Aufbau des Pakets, die Schlüssel von `project.json`, RTF mit sechs Zusätzen (Fußnoten,
Formatvorlagen-Datensatz, Feld-Platzhalter, Bilder, Zeichenformate, Umbruch und Füllzeichen) und wie Textstellen zählen (UTF-16; Fußnote, Feld
und Bild je ein Zeichen; ausgeblendeter Text zählt mit).

Später (je mit neuer Fassungsnummer): Texte als offenes JSON-Blockmodell statt RTF; Drehbücher als eigener Teil
`scripts/`; ein Verzeichnis aller Teile mit Prüfsumme; Wissen in eigenen Teilen für das Arbeiten zu mehreren; ZIP64;
Vorschau mit Quick Look; der MIME-Typ bei der IANA eingetragen.

## Schemas, Referenz-Leser, Prüfungen

- `schema/manifest.schema.json`, `schema/project.schema.json`: JSON-Schema (2020-12) jedes Schlüssels.
- `reference/goethe_read.py`: liest `.goethe`, `.lexwrite` und `.goethex` und gibt Gliederung und Text aus, ohne
  ausgeblendeten Text (Python 3, nur Standardbibliothek; mit `--json` auch Formatvorlagen, Zeichenformate und Umbruch je Text);
  `reference/check_schema.py` prüft gegen die Schemas; `reference/test_goethe_read.py` prüft beide.
- In Goethe Write: der Prüfschalter `-goetheFormatTest` (Zeile `goetheFormatTest` in `write/scripts/drehbuch-pruefen.sh`).

## Lizenz

Herausgeber ist die ICSL FZE, Sharjah, Vereinigte Arabische Emirate. Welche Lizenz für welche Datei gilt, steht in
[`LICENSE.md`](LICENSE.md).

- **Die Spezifikation** (die englische Fassung und diese Kurzfassung): © 2026 ICSL FZE, unter der Lizenz Creative
  Commons Namensnennung 4.0 International (CC BY 4.0):
  [Lizenz in Kürze](https://creativecommons.org/licenses/by/4.0/deed.de),
  [Lizenztext](https://creativecommons.org/licenses/by/4.0/legalcode.de). Kopieren, weitergeben, übersetzen und
  bearbeiten ist erlaubt, zu jedem Zweck, auch kommerziell, mit Nennung der Quelle, einem Link zur Lizenz und dem
  Hinweis, ob etwas geändert wurde. Vorschlag für die Nennung:
  `Goethe-Format 1, © 2026 ICSL FZE, CC BY 4.0, https://goethecloud.com/format/`.
- **Die JSON-Schemas** (`schema/`) und **der Referenz-Leser** mit seinen Tests (`reference/`): Copyright (c) 2026
  ICSL FZE, unter der MIT-Lizenz ([`schema/LICENSE`](schema/LICENSE), [`reference/LICENSE`](reference/LICENSE)). Jede
  dieser Dateien nennt ihre Lizenz in einer SPDX-Zeile.
- **Das Format selbst:** Andere Programme dürfen Dateien im Goethe-Format 1 frei lesen und schreiben.

Fragen zum Format und zu den Lizenzen: [hello@lexxington.com](mailto:hello@lexxington.com).
