Fichiers Scribus .sla, réalisés avec le vrai Scribus
Ne jamais rendre approximativement un document Scribus et n'écrivez jamais un fichier .sla entier à la main.
Cette compétence installe le vrai Scribus (1.6.3 par défaut) et une petite commande sla autour de lui.
Les exports réalisés de cette manière ont été vérifiés par rapport aux PDF exportés depuis l'application de bureau Scribus 1.6.3 :
11 documents (simples, avec images et formulaires remplissables) correspondaient pixel pour pixel.
1. Installation (une fois par session, 2-4 minutes la première fois)
[ -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
- Autre version de Scribus :
bash /opt/sla/kit/scripts/setup.sh 1.6.5(également1.6.1,native). Utilisez la version que l'utilisateur exécute ; un fichier sauvegardé par le moteur porte la version du moteur. - Nécessite
root,aptet un accès réseau àgithub.cometarchive.ubuntu.com. Se termine par une ligne commençant par[sla-setup] ready :. Si un avertissement indique qu'il est revenu à une autre version, prévenez l'utilisateur. - Le moteur ne voit que les fichiers sous
/home,/tmp,/mnt,/root. Travaillez là.
2. Commandes
sla inspect FICHIER.sla -v # pages, polices (installées ?), images (trouvées ?), éléments nommés, {{placeholders}}, champs de formulaire
sla export FICHIER.sla # PDF à côté du .sla, en utilisant les paramètres PDF enregistrés du document
sla export FICHIER.sla -f pdf,png,svg,eps,ps,jpg --dpi 300 -d SORTIE --pages 1,3-5
sla export FICHIER.sla --pdf-version x4 --crop-marks --bleed 8.5 # PDF d'impression (x1a, x3, x4 ; --cmyk ; --profile)
sla fill MODELE.sla SORTIE.sla --set nom=Valeur --text cadre_texte="Nouveau texte" --image cadre_image=nouvelle.png
sla resave ENTREE.sla SORTIE.sla # ouvre dans Scribus et enregistre : prouve que le fichier se charge, le normalise
sla run SCRIPT.py [args] # exécute un script Python (greffon) Scribus ; c'est ainsi que les nouveaux documents sont créés
sla compare A.pdf B.pdf --out REP # comparaison pixel, même moteur de rendu et DPI pour les deux ; écrit les images de différence
sla fonts --grep sans # noms exacts des polices tels que Scribus les orthographie
sla fonts --add FICHIER_OU_REP # installe les fichiers de polices de l'utilisateur
sla fonts --google "Comic Relief" # familles sous licence ouverte de Google Fonts
sla <commande> -h liste toutes les options.
3. Règles pour une sortie identique à l'application de bureau
- Les polices ou images manquantes bloquent l'export. Scribus remplace silencieusement une police manquante et
le décalage de mise en page.
sla exportrefuse et nomme ce qui manque. Installez la police (sla fonts --add/--google) ou corrigez le chemin de l'image. Ne passez--allow-missingque si l'utilisateur l'accepte. Les noms de polices doivent correspondre exactement, ex.Latin Modern Sans 10 Bold,DejaVu Sans Book. - Les liens d'images sont relatifs au fichier
.sla. Gardez un document et ses ressources dans la même disposition relative que sur l'ordinateur de l'utilisateur, sinon les cadres s'exportent vides. - L'export utilise les paramètres PDF enregistrés du document (compression, version PDF, polices). Remplacez-les
uniquement sur demande :
--lossless,--outline-fonts,--pdf-version,--pdf-option CLE=VALEUR. - Les PDF remplissables fonctionnent simplement. Pour les documents avec champs de formulaire, l'outil intègre la police du champ en totalité, comme le fait la boîte de dialogue d'export de l'application de bureau. (L'export scripté simple plante sur ceux-ci ; ne contournez pas avec des polices en contours.)
- Regardez le résultat. Après toute création/remplissage/édition :
sla export FICHIER.sla -f png --dpi 72 -d /tmp/previewet visualisez le PNG. Lorsqu'un PDF de référence existe, exécutezsla compareet attendezMATCHà 0.0000%. - Remarques sur les formats. PNG/JPG proviennent de la fonction "Enregistrer sous image" de Scribus (utilisez
--raster-via pdfpour pixelliser le PDF à la place ; les tailles peuvent différer d'un pixel). SVG et PS sont convertis à partir du PDF exporté (le texte devient des contours dans SVG). EPS est le propre format de Scribus, un fichier par page.
4. Remplir un modèle
- Placez
{{nom}}dans le texte du modèle ;--set nom=valeurle remplace partout. Un espace réservé doit se trouver dans un seul bloc de formatage (saisissez-le en une fois, même police et même taille tout du long). --text ELEMENT=valeurremplace tout le texte du cadre nommé ELEMENT, en conservant le formatage de son premier bloc ;\ncommence un nouveau paragraphe. Les noms sont les noms des éléments affichés parsla inspect -v(Scribus : Propriétés > Nom).--image ELEMENT_OU_ANCIEN_NOM_FICHIER=nouvelle.pngrelie une image et l'ajuste à son cadre. Ajoutez--keep-image-scalepour conserver l'échelle précédente.--data fichier.jsonprend{"placeholders" : {}, "text" : {}, "images" : {}}.--strictéchoue si une clé ne correspond à rien.- Le résultat est réenregistré par Scribus, c'est donc un fichier Scribus authentique.
5. Créer un nouveau document
Écrivez un script greffon et exécutez-le avec sla run. Un exemple complet et testé est installé dans
/opt/sla/kit/examples/new_document.py (mise en page, couleurs, styles, texte, formes, lignes, image,
enregistrement). Copiez-le et adaptez-le. Éléments essentiels :
- Encapsulez le script dans
try : ... finally : os._exit(0)ou Scribus ne se ferme jamais. - Définissez d'abord les couleurs et les styles ; nommez chaque objet (
createText(x, y, w, h, "nom")). \rsépare les paragraphes danssetText. Les unités sont celles données ànewDocument(utilisez les points).setScaleImageToFrame(True, True, nom)ajuste une image à son cadre, en conservant les proportions.- Enregistrez avec
saveDocAs(chemin), puissla inspectet prévisualisez (règle 5). - Pour correspondre à une charte graphique existante, inspectez d'abord un document de l'utilisateur avec
sla inspect -vet réutilisez sa taille de page, ses polices, ses couleurs et ses épaisseurs de ligne.
6. Modifier un document existant
Préférez un script greffon (openDoc, modifier les objets par nom, saveDocAs). Les petites modifications d'attributs
dans le XML sont acceptables ; exécutez ensuite sla resave et prévisualisez. Informations utiles sur le XML (Scribus 1.6) :
- Racine
SCRIBUSUTF8NEW, unDOCUMENT. Les objets sontPAGEOBJECT(pages),MASTEROBJECT(pages maîtresses),FRAMEOBJECT(incorporé).PTYPE: 2 image, 4 texte, 5 ligne, 6 forme, 7 polyligne, 12 groupe. - Les pages sont empilées sur un seul canevas : les
XPOS/YPOSd'un objet incluent lesPAGEXPOS/PAGEYPOSde sa page. - Le texte se trouve dans
StoryText: blocsITEXT CH="...",para,trail. Les polices sont des attributsFONT="...". - Images :
PFILE(chemin relatif au .sla).SCALETYPE="0"ajuste au cadre (Scribus recalcule l'échelle au chargement),SCALETYPE="1"échelle libre avecLOCALSCX/LOCALSCY/LOCALX/LOCALY;RATIO="1"conserve les proportions. - Les
path/copathd'un cadre de texte contiennent sa forme : modifiez-les ensemble avecWIDTH/HEIGHT(ou redimensionnez dans un script greffon avecsizeObject, qui le fait pour vous). - Champs de formulaire : un cadre de texte avec
ANNOTATION="1",ANTYPE3 texte, 4 case à cocher, 5 zone de liste déroulante, 6 liste. - Ne sauvegardez pas par-dessus l'original de l'utilisateur ; écrivez un nouveau fichier sauf demande contraire.
7. En cas d'échec
- "Scribus a quitté ... planté" : exécutez
sla inspect, corrigez les polices/images manquantes, essayezsla resavepour voir si le fichier se charge, puis exportez page par page (--pages N) pour trouver l'objet. - Échec de la construction du moteur :
bash /opt/sla/kit/scripts/setup.sh nativeinstalle à la place le Scribus de la distribution (les exports correspondaient également aux références lors des tests ; les fichiers sauvegardés portent cette version). - Polices nécessaires au document de l'utilisateur qui ne sont pas sous licence ouverte (ex. Arial, Calibri) : demandez les fichiers de polices à l'utilisateur.