# SHUFTN-Plugin: Editor

Hier liegt das Paket `euro-office` — der eingebaute Dokumenteneditor von
SHUFTN. Es ist ein **nachinstallierbares Plugin**, kein Teil des Programms:
SHUFTN läuft ohne es, kann dann aber Anhänge nur ansehen und nicht
bearbeiten.

## Einspielen

In SHUFTN: **Einstellungen → Erweiterungen**, unter *Quelle* die Adresse des
Pakets aus der neuesten Veröffentlichung eintragen, auf **Einspielen**, dann
SHUFTN neu starten.

Die Adresse steht bei jeder Veröffentlichung unter *Assets* und hat die Form

    .../releases/download/v<fassung>/euro-office-<fassung>.zip

Der Neustart ist keine Umständlichkeit: Ein Plugin bekommt seinen eigenen
Ursprung über ein eigenes Protokoll, und Protokolle meldet die Hülle beim
Start an.

Eingespielt wird in dieser Reihenfolge — **erst entpacken, dann prüfen, dann
umhängen**. Geht das Prüfen schief, bleibt die vorige Fassung unberührt.
Jede Datei steht mit ihrer Prüfsumme in `dateien.sha256`, und diese Liste
steht mit ihrer eigenen Summe im Manifest.

## Was in einer Veröffentlichung liegt

| Datei | Was |
|---|---|
| `euro-office-<fassung>.zip` | das Paket |
| `euro-office-<fassung>-quelltext.zip` | der zugehörige Quelltext |

**Warum beides.** Das Paket ist ein Fork von ONLYOFFICE und steht unter der
GNU Affero General Public License v3. Wer ein AGPL-Programm von einem Server
zum Herunterladen anbietet, muss den zugehörigen Quelltext auf demselben Weg
am selben Ort anbieten (Abschnitt 6d) — ein „auf Anfrage“ reicht dort nicht.
Deshalb liegt er daneben und nicht hinter einer Adresse.

Im Quelltext-Archiv: die Änderungen gegen die Tags der Ursprungsrepositorien
als Patch-Dateien, das vollständige Baurezept und eine Anleitung zum
Nachbauen. Die unveränderten Teile stehen öffentlich unter
[Euro-Office](https://github.com/Euro-Office) in den genannten Fassungen.

## Was das Paket enthält

Die Desktop-Editoren für Text, Tabelle, Präsentation und PDF, dazu `x2t` als
WebAssembly für die Umwandlung. **Kein Dokumentenserver** — alles rechnet auf
dem Rechner des Nutzers, und der Ursprung, in dem der Editor läuft, kennt
weder `http:` noch `https:`.

Beigelegt ist ein Schriften-Grundstock aus sieben Familien, alle unter freien
Lizenzen. Die Microsoft-Kernschriften sind **nicht** dabei; an ihrer Stelle
stehen metrisch gleiche Ersatzschriften, damit ein Dokument seine Zeilen- und
Seitenumbrüche behält. Die Schriften des eigenen Rechners kann SHUFTN
dazunehmen — Einstellungen → Erweiterungen → *Schriften einlesen*.

Welche Bestandteile unter welcher Lizenz stehen, steht vollständig in der
`LIZENZEN.md` im Paket; SHUFTN zeigt sie unter **Einstellungen → Über** im
Wortlaut an.

## Ein eigenes Plugin bauen

Das Paketformat ist allgemein und nicht auf diesen Editor zugeschnitten.
Manifest, Prüfliste, Protokollvertrag und Grenzen sind in `PLUGINS.md` im
SHUFTN-Quelltext beschrieben, samt einem Beispiel, das läuft.