Files
shuftn-plugins-editor/README.md
T

2.9 KiB

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 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.