Communitygithub.com

scribus-sla

Scribus-.sla-Dateien erstellen, bearbeiten, ausfüllen und exportieren – mit der echten Scribus-Engine für pixelgenaue Ausgabe (PDF, PDF/X, ausfüllbare PDFs, PNG/JPG, SVG, EPS, PS).

Was ist scribus-sla?

Diese Fähigkeit nutzt die echte Scribus-Desktop-Engine (Standard 1.6.3) zum Arbeiten mit .sla-Dateien. Sie stellt einen Befehl `sla` bereit, mit dem sich Seitenlayouts inspizieren, als PDF/PNG/SVG exportieren, mit Platzhaltern befüllen und neue Dokumente mittels Scribus-Python-Skripten (Scripter) erstellen lassen. Die Ausgabe ist pixelgenau mit der Desktop-App abgeglichen – perfekt für Druckvorstufe, ausfüllbare PDFs und Vorlagen ohne manuelle Nacharbeit. Die Fähigkeit installiert bei erstmaliger Nutzung über Git und apt die Scribus-Engine. Sie unterstützt 1.6.1, 1.6.3, 1.6.5 und die nativen Distributionen. Alle Exporte respektieren die gespeicherten PDF-Einstellungen des Dokuments. Fehlende Schriften oder Bilder werden gemeldet, bevor der Export abbricht, um Layoutverschiebungen zu vermeiden. Die Befehle `sla fill` und `sla run` erlauben das automatisierte Befüllen von Vorlagen und die Neuerstellung von Dokumenten. Bei Fehlern wird die Engine zurückgesetzt oder auf die native Scribus-Version ausgewichen. Plattformen: Claude Code, Cursor, Codex, Devin, Aider – alle Umgebungen mit Bash, apt und Python.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JessNco/scribus-sla/tree/HEAD

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Scribus .sla-Dateien – erstellt mit echtem Scribus

Rendern oder approximieren Sie nie von Hand ein Scribus-Dokument und schreiben Sie niemals eine ganze .sla von Hand. Diese Fähigkeit installiert den echten Scribus (Standard 1.6.3) und einen kleinen sla-Befehl darum herum. So erstellte Exporte wurden gegen PDFs geprüft, die aus der Scribus-1.6.3-Desktop-App exportiert wurden: 11 Dokumente (einfach, mit Bildern und mit ausfüllbaren Formularen) stimmten pixelgenau überein.

1. Installation (einmal pro Sitzung, 2–4 Minuten beim ersten Mal)

[ -d /opt/sla/kit/.git ] || git clone --depth 1 https://github.com/JessNco/scribus-sla /opt/sla/kit
bash /opt/sla/kit/scripts/setup.sh
  • Andere Scribus-Version: bash /opt/sla/kit/scripts/setup.sh 1.6.5 (auch 1.6.1, native). Verwenden Sie die Version, die der Benutzer ausführt; eine von der Engine gespeicherte Datei trägt die Engine-Version.
  • Benötigt root, apt und Netzwerkzugriff auf github.com und archive.ubuntu.com. Beendet mit einer Zeile, die mit [sla-setup] ready: beginnt. Falls eine Warnung erscheint, dass auf eine andere Version zurückgegriffen wurde, informieren Sie den Benutzer.
  • Die Engine kann nur Dateien unter /home, /tmp, /mnt, /root sehen. Arbeiten Sie dort.

2. Befehle

sla inspect DATEI.sla -v            # Seiten, Schriftarten (installiert?), Bilder (gefunden?), benannte Elemente, {{Platzhalter}}, Formularfelder
sla export DATEI.sla                # PDF neben der .sla, mit den im Dokument gespeicherten PDF-Einstellungen
sla export DATEI.sla -f pdf,png,svg,eps,ps,jpg --dpi 300 -d AUSGABEVERZ --pages 1,3–5
sla export DATEI.sla --pdf-version x4 --crop-marks --bleed 8.5      # Druck-PDF (x1a, x3, x4; --cmyk; --profile)
sla export DATEI.sla --raster-über-pdf                                 # PNG/JPG über PDF-Rasterisierung
sla fill VORLAGE.sla AUSGABE.sla --set name=Wert --text rahmenname="Neuer Text" --image rahmenname=neu.png
sla resave EINGABE.sla AUSGABE.sla  # In Scribus öffnen und speichern: beweist, dass die Datei lädt, normalisiert sie
sla run SKRIPT.py [Argumente]       # Ein Scribus-Python-Skript (Scripter) ausführen; so werden neue Dokumente erstellt
sla compare A.pdf B.pdf --out VERZ  # Pixelvergleich, gleicher Renderer und gleiche DPI für beide; schreibt Diff-Bilder
sla fonts --grep sans              # Exakte Schriftartnamen, wie Scribus sie schreibt
sla fonts --add DATEI_ODER_VERZ    # Die Schriftdateien des Benutzers installieren
sla fonts --google "Comic Relief"  # Frei lizenzierte Schriftfamilien von Google Fonts

sla <befehl> -h listet alle Optionen.

3. Regeln, die die Ausgabe mit der Desktop-App identisch halten

  1. Fehlende Schriftarten oder Bilder stoppen den Export. Scribus ersetzt eine fehlende Schriftart stillschweigend und das Layout verschiebt sich. sla export lehnt die Ausführung ab und nennt, was fehlt. Installieren Sie die Schriftart (sla fonts --add/--google) oder korrigieren Sie den Bildpfad. Nur --allow-missing übergeben, wenn der Benutzer es akzeptiert. Schriftartnamen müssen exakt übereinstimmen, z. B. Latin Modern Sans 10 Bold, DejaVu Sans Book.
  2. Bildverweise sind relativ zur .sla-Datei. Behalten Sie ein Dokument und seine Assets in der gleichen relativen Anordnung wie auf dem Rechner des Benutzers, sonst exportieren die Rahmen leer.
  3. Export verwendet die gespeicherten PDF-Einstellungen des Dokuments (Komprimierung, PDF-Version, Schriftarten). Nur auf Anfrage überschreiben: --lossless, --outline-fonts, --pdf-version, --pdf-option SCHLÜSSEL=WERT.
  4. Ausfüllbare PDFs funktionieren einfach. Bei Dokumenten mit Formularfeldern bettet das Werkzeug die Feld-Schriftart vollständig ein, wie es auch der Desktop-Exportdialog tut. (Einfacher skriptgesteuerter Export stürzt bei diesen ab; umgehen Sie dies nicht mit umrandeten Schriftarten.)
  5. Überprüfen Sie das Ergebnis. Nach jedem Erstellen/Ausfüllen/Bearbeiten: sla export DATEI.sla -f png --dpi 72 -d /tmp/vorschau und das PNG ansehen. Wenn ein Referenz-PDF existiert, führen Sie sla compare aus und erwarten Sie MATCH bei 0,0000 %.
  6. Format-Hinweise. PNG/JPG stammen von Scribus' eigener „Als Bild speichern“-Funktion (verwenden Sie --raster-über-pdf, um stattdessen das PDF zu rasterisieren; Größen können um ein Pixel abweichen). SVG und PS werden aus dem exportierten PDF konvertiert (Texte werden in SVG zu Pfaden). EPS ist Scribus-eigen, eine Datei pro Seite.

4. Ausfüllen einer Vorlage

  • Setzen Sie {{name}} in den Vorlagentext; --set name=wert ersetzt ihn überall. Ein Platzhalter muss in einem Formatierungslauf stehen (in einem Zug eingeben, gleiche Schriftart und -größe).
  • --text ELEMENT=wert ersetzt den gesamten Text des Rahmens namens ELEMENT und behält die Formatierung des ersten Laufs; \n beginnt einen neuen Absatz. Namen sind die Elementnamen, die von sla inspect -v angezeigt werden (Scribus: Eigenschaften > Name).
  • --image ELEMENT_ODER_ALTER_DATEINAME=neu.png verknüpft ein Bild neu und passt es in seinen Rahmen ein. Fügen Sie --keep-image-scale hinzu, um die alte Skalierung beizubehalten.
  • --data datei.json nimmt {"placeholders": {}, "text": {}, "images": {}} entgegen. --strict schlägt fehl, wenn ein Schlüssel nichts gefunden hat.
  • Das Ergebnis wird von Scribus erneut gespeichert, ist also eine echte Scribus-Datei.

5. Erstellen eines neuen Dokuments

Schreiben Sie ein Scripter-Skript und führen Sie es mit sla run aus. Ein vollständiges, getestetes Beispiel ist unter /opt/sla/kit/beispiele/neues_dokument.py installiert (Seiteneinrichtung, Farben, Stile, Text, Formen, Linien, Bild, Speichern). Kopieren und anpassen. Wichtig:

  • Wickeln Sie das Skript in try: ... finally: os._exit(0) ein, sonst beendet Scribus nie.
  • Definieren Sie zuerst Farben und Stile; benennen Sie jedes Objekt (createText(x, y, b, h, "name")).
  • \r trennt Absätze in setText. Einheiten sind, was newDocument übergeben wurde (Punkte verwenden).
  • setScaleImageToFrame(Wahr, Wahr, name) passt ein Bild in seinen Rahmen ein, unter Beibehaltung der Proportionen.
  • Speichern Sie mit saveDocAs(pfad), dann sla inspect und Vorschau (Regel 5).
  • Um einen vorhandenen Corporate Design-Stil zu treffen, führen Sie sla inspect -v auf einem der Benutzerdokumente aus und übernehmen dessen Seitengröße, Schriftarten, Farben und Linienstärken.

6. Bearbeiten eines vorhandenen Dokuments

Bevorzugen Sie ein Scripter-Skript (openDoc, Objekte nach Namen ändern, saveDocAs). Kleine Attributänderungen im XML sind in Ordnung; führen Sie danach sla resave aus und machen Sie eine Vorschau. Nützliche XML-Fakten (Scribus 1.6):

  • Wurzel SCRIBUSUTF8NEW, ein DOCUMENT. Objekte sind PAGEOBJECT (Seiten), MASTEROBJECT (Musterseiten), FRAMEOBJECT (inline). PTYPE: 2 Bild, 4 Text, 5 Linie, 6 Form, 7 Polylinie, 12 Gruppe.
  • Seiten sind auf einer Leinwand gestapelt: XPOS/YPOS eines Objekts enthalten die PAGEXPOS/PAGEYPOS seiner Seite.
  • Text lebt in StoryText: ITEXT CH="..."-Läufe, para, trail. Schriftarten sind FONT="..."-Attribute.
  • Bilder: PFILE (Pfad relativ zur .sla). SCALETYPE="0" passt in Rahmen (Scribus berechnet die Skalierung beim Laden neu), SCALETYPE="1" freie Skalierung mittels LOCALSCX/LOCALSCY/LOCALX/LOCALY; RATIO="1" behält Proportionen bei.
  • path/copath eines Textrahmens enthalten seine Form: Ändern Sie sie zusammen mit WIDTH/HEIGHT (oder in einem Scripter-Skript mit sizeObject, das dies für Sie erledigt).
  • Formularfelder: ein Textrahmen mit ANNOTATION="1", ANTYPE 3 Text, 4 Kontrollkästchen, 5 Kombinationsfeld, 6 Liste.
  • Überschreiben Sie nicht das Original des Benutzers; schreiben Sie eine neue Datei, es sei denn, der Benutzer bittet darum.

7. Bei einem Fehler

  • „Scribus beendet … abgestürzt“: Führen Sie sla inspect aus, beheben Sie fehlende Schriftarten/Bilder, versuchen Sie sla resave, um zu sehen, ob die Datei überhaupt lädt, dann exportieren Sie Seite für Seite (--pages N), um das Objekt zu finden.
  • Engine-Build fehlgeschlagen: bash /opt/sla/kit/scripts/setup.sh native installiert stattdessen die Scribus-Version der Distribution (auch deren Exporte stimmten in Tests mit den Referenzen überein; gespeicherte Dateien tragen diese Version).
  • Schriftarten, die das Benutzerdokument benötigt und die nicht frei lizenziert sind (z. B. Arial, Calibri): Fragen Sie den Benutzer nach den Schriftartdateien.

Verwandte Skills