From 09e0c8529e84d5df6ad8ceae45dda605c6de521a Mon Sep 17 00:00:00 2001 From: Tim Schmidt <4+timba@noreply.localhost> Date: Fri, 4 Sep 2026 06:52:15 +0000 Subject: [PATCH] Was hier liegt und warum der Quelltext danebengehoert --- README.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..af49b1a --- /dev/null +++ b/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/euro-office-.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-.zip` | das Paket | +| `euro-office--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.