Compétence PDF (aislessonio/open-source-skills)

Compétence PDF

Quand l'utiliser

• Lire ou réviser le contenu d'un PDF lorsque la mise en page et les visuels sont importants.
• Créer des PDF de manière programmatique avec un formatage fiable.
• Valider le rendu final avant la livraison.

Workflow

1. Privilégier la révision visuelle : convertir les pages PDF en PNG et les inspecter.
   • Utiliser pdftoppm si disponible.
   • S'il n'est pas disponible, installer Poppler ou demander à l'utilisateur de réviser la sortie localement.
2. Utiliser reportlab pour générer des PDF lors de la création de nouveaux documents.
3. Utiliser pdfplumber (ou pypdf) pour l'extraction de texte et les contrôles rapides ; ne pas s'y fier pour la fidélité de la mise en page.
4. Après chaque mise à jour significative, re-rendre les pages et vérifier l'alignement, l'espacement et la lisibilité.

Conventions de répertoires temporaires et de sortie

• Utiliser tmp/pdfs/ pour les fichiers intermédiaires ; les supprimer une fois terminé.
• Écrire les artefacts finaux dans output/pdf/ lorsque vous travaillez dans ce dépôt.
• Garder les noms de fichiers stables et descriptifs.

Dépendances (installer si manquantes)

Préférer uv pour la gestion des dépendances.

Paquets Python :

uv pip install reportlab pdfplumber pypdf

Si uv n'est pas disponible :

python3 -m pip install reportlab pdfplumber pypdf

Outils système (pour le rendu) :

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

Si l'installation n'est pas possible dans cet environnement, indiquer à l'utilisateur quelle dépendance manque et comment l'installer localement.

Environnement

Aucune variable d'environnement requise.

Commande de rendu

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

Exigences de qualité

• Maintenir une conception visuelle soignée : typographie, espacement, marges et hiérarchie des sections cohérents.
• Éviter les problèmes de rendu : texte rogné, éléments qui se chevauchent, tableaux cassés, carrés noirs ou glyphes illisibles.
• Les graphiques, tableaux et images doivent être nets, alignés et clairement étiquetés.
• Utiliser uniquement des traits d'union ASCII. Éviter U+2011 (trait d'union insécable) et autres tirets Unicode.
• Les citations et références doivent être lisibles par un humain ; ne jamais laisser de jetons d'outil ou de chaînes de substitution.

Vérifications finales

• Ne pas livrer tant que la dernière inspection PNG ne montre aucun défaut visuel ou de formatage.
• Confirmer que les en-têtes/pieds de page, la numérotation des pages et les transitions de sections sont soignés.
• Garder les fichiers intermédiaires organisés ou les supprimer après l'approbation finale.