Was hier liegt und warum der Quelltext danebengehoert

README.md

@@ -0,0 +1,66 @@
+# 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.