Documentation PDFLang — Français
Guide complet du langage .pdfl et de l'outil en ligne de commande pdfl —
version 0.6.0.
Chaque exemple de cette documentation est du code exécutable et commenté. Si vous découvrez le langage, commencez par le manuel du chapitre 1 ; les autres chapitres se consultent comme une référence.
La langue de l'outil. Les messages de
pdfl(diagnostics, erreurs, aide en ligne de commande, libellés des rapports) sont en anglais, comme le veut l'usage pour les outils en ligne de commande. Cette documentation est en français, mais un contrôle qui échoue affichera quelque chose commepage 7: 324% ink (limit 300%). Les messages que vous écrivez vous-même dans vos scripts sortent tels quels, dans la langue que vous avez employée.
Sommaire
| Chapitre | Contenu |
|---|---|
| 1. Le langage | Manuel complet : checks, assertions, types, unités, blocs, fonctions, import, rule |
| 2. Types du document | doc, page, font, image, region — toutes les propriétés et méthodes |
3. text:: |
Texte : extraction, normalisation, recherche, validations brésiliennes, données personnelles |
4. struct:: |
Structure et métadonnées : objets, XMP, sécurité, empreintes |
5. visual:: |
Images : résolution, comparaison visuelle, pHash, SSIM, qualité |
6. prepress:: |
Prépresse : encrage total, séparations, tons directs, polices, boîtes |
7. codes:: |
Codes-barres et QR codes : détection, décodage, vérification |
8. fix:: |
Normalisation : boîtes, pages, filigranes, fusion/découpe, optimisation |
9. data:: |
Données externes : glossaires, jeux de données, tables de consultation |
| 10. Bibliothèque standard | Méthodes de listes et de chaînes, fonctions globales |
| 11. Ligne de commande | run, compare, watch, fix, inspect, lint, fmt, doc, pack, add |
| 12. Recettes | Cas complets : imprimerie, édition juridique, laboratoire, CI/CD |
Démarrer en 30 secondes
Créez mon_profil.pdfl :
// Chaque script est un ensemble de checks. Un check regroupe des
// validations qui vont ensemble et devient une section du rapport.
check "Basic structure" {
// require : le message est produit automatiquement à partir de l'expression
require doc.page_count > 0
// assert : avec le message que vous écrivez vous-même
assert doc.title != "", "PDF has no title in its metadata"
}
Exécutez :
pdfl run mon_profil.pdfl document.pdf
Le rapport sort en JSON sur la sortie standard. Le code de sortie dit le
résultat : 0 tout est passé, 1 seulement des avertissements, 2 erreurs de
validation, 3 erreur de syntaxe.
Conventions de cette documentation
- Chaque fonction indique sa signature, ce qu'elle fait, ce qu'elle retourne et un exemple commenté.
- Les arguments entre crochets sont facultatifs :
calculate_tac([page]). - « à partir de 1 » signifie que la première page est
1, pas0— le langage compte comme comptent les gens, pas comme comptent les programmeurs. - Les dimensions sont toujours en points (1 pt = 1/72 pouce). Les littéraux
d'unité (
3mm,1in) font la conversion pour vous.
Autres langues : English · Português (Brasil) · Espagnol · 日本語 · 中文 · العربية · Deutsch