Communitygithub.com

scribus-sla

Créez, remplissez, éditez et exportez des fichiers Scribus .sla en utilisant le véritable moteur Scribus pour une sortie identique à l'application de bureau (PDF, PDF remplissable, PDF/X, PNG/JPG, SVG, EPS, PS). Utilisez pour toute tâche liée aux fichiers .sla ou à Scribus.

Qu'est-ce que scribus-sla ?

Cette compétence installe le véritable moteur Scribus (1.6.3 par défaut) et une commande `sla` légère qui l'encapsule, garantissant que tous les exports correspondent exactement à ce que l'application de bureau Scribus produirait – idéal pour la mise en page professionnelle où la fidélité pixel par pixel est cruciale. Elle prend en charge toutes les tâches : inspecter les documents (polices, images, champs de formulaire), exporter vers PDF (y compris PDF/X, PDF remplissables), PNG/JPG, SVG, EPS et PS, remplir des modèles avec des textes et des images, créer de nouveaux documents via des scripts Python du greffon Scribus, et éditer les fichiers .sla existants soit par scripts soit directement dans le XML pour des modifications mineures. La compétence applique des règles strictes comme le refus d'exporter si des polices ou images sont manquantes, et elle conserve les paramètres PDF enregistrés du document sauf si l'utilisateur les surcharge. En cas d'échec, elle fournit des diagnostics clairs (polices/images manquantes, plantages) et des solutions de repli. Fonctionne sur tout système avec `apt`, accès réseau à GitHub et archive.ubuntu.com, et les droits root.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 (également 1.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, apt et un accès réseau à github.com et archive.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

  1. Les polices ou images manquantes bloquent l'export. Scribus remplace silencieusement une police manquante et le décalage de mise en page. sla export refuse et nomme ce qui manque. Installez la police (sla fonts --add/--google) ou corrigez le chemin de l'image. Ne passez --allow-missing que si l'utilisateur l'accepte. Les noms de polices doivent correspondre exactement, ex. Latin Modern Sans 10 Bold, DejaVu Sans Book.
  2. 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.
  3. 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.
  4. 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.)
  5. Regardez le résultat. Après toute création/remplissage/édition : sla export FICHIER.sla -f png --dpi 72 -d /tmp/preview et visualisez le PNG. Lorsqu'un PDF de référence existe, exécutez sla compare et attendez MATCH à 0.0000%.
  6. Remarques sur les formats. PNG/JPG proviennent de la fonction "Enregistrer sous image" de Scribus (utilisez --raster-via pdf pour 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=valeur le 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=valeur remplace tout le texte du cadre nommé ELEMENT, en conservant le formatage de son premier bloc ; \n commence un nouveau paragraphe. Les noms sont les noms des éléments affichés par sla inspect -v (Scribus : Propriétés > Nom).
  • --image ELEMENT_OU_ANCIEN_NOM_FICHIER=nouvelle.png relie une image et l'ajuste à son cadre. Ajoutez --keep-image-scale pour conserver l'échelle précédente.
  • --data fichier.json prend {"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")).
  • \r sépare les paragraphes dans setText. 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), puis sla inspect et prévisualisez (règle 5).
  • Pour correspondre à une charte graphique existante, inspectez d'abord un document de l'utilisateur avec sla inspect -v et 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, un DOCUMENT. Les objets sont PAGEOBJECT (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/YPOS d'un objet incluent les PAGEXPOS/PAGEYPOS de sa page.
  • Le texte se trouve dans StoryText : blocs ITEXT CH="...", para, trail. Les polices sont des attributs FONT="...".
  • Images : PFILE (chemin relatif au .sla). SCALETYPE="0" ajuste au cadre (Scribus recalcule l'échelle au chargement), SCALETYPE="1" échelle libre avec LOCALSCX/LOCALSCY/LOCALX/LOCALY ; RATIO="1" conserve les proportions.
  • Les path/copath d'un cadre de texte contiennent sa forme : modifiez-les ensemble avec WIDTH/HEIGHT (ou redimensionnez dans un script greffon avec sizeObject, qui le fait pour vous).
  • Champs de formulaire : un cadre de texte avec ANNOTATION="1", ANTYPE 3 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, essayez sla resave pour 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 native installe à 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.

Skills associés