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(auch1.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,
aptund Netzwerkzugriff aufgithub.comundarchive.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,/rootsehen. 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
- Fehlende Schriftarten oder Bilder stoppen den Export. Scribus ersetzt eine fehlende Schriftart
stillschweigend und das Layout verschiebt sich.
sla exportlehnt 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. - 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. - 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. - 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.)
- Überprüfen Sie das Ergebnis. Nach jedem Erstellen/Ausfüllen/Bearbeiten:
sla export DATEI.sla -f png --dpi 72 -d /tmp/vorschauund das PNG ansehen. Wenn ein Referenz-PDF existiert, führen Siesla compareaus und erwarten SieMATCHbei 0,0000 %. - 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=wertersetzt ihn überall. Ein Platzhalter muss in einem Formatierungslauf stehen (in einem Zug eingeben, gleiche Schriftart und -größe). --text ELEMENT=wertersetzt den gesamten Text des Rahmens namens ELEMENT und behält die Formatierung des ersten Laufs;\nbeginnt einen neuen Absatz. Namen sind die Elementnamen, die vonsla inspect -vangezeigt werden (Scribus: Eigenschaften > Name).--image ELEMENT_ODER_ALTER_DATEINAME=neu.pngverknüpft ein Bild neu und passt es in seinen Rahmen ein. Fügen Sie--keep-image-scalehinzu, um die alte Skalierung beizubehalten.--data datei.jsonnimmt{"placeholders": {}, "text": {}, "images": {}}entgegen.--strictschlä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")). \rtrennt Absätze insetText. Einheiten sind, wasnewDocumentübergeben wurde (Punkte verwenden).setScaleImageToFrame(Wahr, Wahr, name)passt ein Bild in seinen Rahmen ein, unter Beibehaltung der Proportionen.- Speichern Sie mit
saveDocAs(pfad), dannsla inspectund Vorschau (Regel 5). - Um einen vorhandenen Corporate Design-Stil zu treffen, führen Sie
sla inspect -vauf 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, einDOCUMENT. Objekte sindPAGEOBJECT(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/YPOSeines Objekts enthalten diePAGEXPOS/PAGEYPOSseiner Seite. - Text lebt in
StoryText:ITEXT CH="..."-Läufe,para,trail. Schriftarten sindFONT="..."-Attribute. - Bilder:
PFILE(Pfad relativ zur .sla).SCALETYPE="0"passt in Rahmen (Scribus berechnet die Skalierung beim Laden neu),SCALETYPE="1"freie Skalierung mittelsLOCALSCX/LOCALSCY/LOCALX/LOCALY;RATIO="1"behält Proportionen bei. path/copatheines Textrahmens enthalten seine Form: Ändern Sie sie zusammen mitWIDTH/HEIGHT(oder in einem Scripter-Skript mitsizeObject, das dies für Sie erledigt).- Formularfelder: ein Textrahmen mit
ANNOTATION="1",ANTYPE3 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 inspectaus, beheben Sie fehlende Schriftarten/Bilder, versuchen Siesla 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 nativeinstalliert 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.