Ce que hqf-pdf crée

Des documents entiers — factures, bons de livraison, bulletins de paie, contrats — et un petit exemple pour chaque capacité dont ils sont faits, chacun créant un vrai PDF.

Chaque exemple est accompagné de son code, écrit deux fois : le même document une fois en Rust et une fois en Python. La plupart ont aussi un troisième bouton : le même document en JSON, la forme envoyée au service.

À quoi sert chaque famille Voir les PDF créés par hqf-pdf Voir pourquoi les fichiers sont deux fois plus légers la plupart du temps, souvent bien davantage, et jusqu’à douze fois plus légers

Documents d’entreprise complets

Les documents qu’une entreprise envoie tous les jours, créés par le logiciel qui détient déjà les chiffres. À quoi sert cette famille

Un bulletin de paie

Un bulletin de paie : dix-huit lignes de cotisations, avec la part du salarié et celle de l’employeur, et pour chacune le montant du mois puis le cumul depuis janvier. Chaque valeur est rattachée à sa ligne et à sa colonne, pour les logiciels qui lisent la page à voix haute.

Voir le code en : Rust Python JSON

Le détail technique

Les exemples ci-dessus sont des documents entiers. Ceux qui suivent sont rangés par sujet : chaque famille montre une seule chose qu’une page peut contenir — un tableau, un code-barres, une signature — avec le programme qui la crée, pour que le développeur qui utilise cette bibliothèque voie exactement comment elle se fait.

Pages, texte et polices

La page elle-même, les mots qui y figurent et la police, le tout contenu dans le fichier pour que la page ait la même allure partout. À quoi sert cette famille

Paragraphes, colonnes et typographie

Vous fournissez le texte ; la bibliothèque trouve où finit chaque ligne, où s’arrête chaque colonne et où se coupe chaque page. À quoi sert cette famille

Points de coupure après une barre oblique ou un trait d’union

Une colonne justifiée, quatre fois : des chemins de fichiers et des mots composés qui débordent faute de point de coupure, puis qui passent à la ligne là où une coupure est permise après une barre oblique ou un trait d’union, ensuite partout où leur ponctuation l’autorise, enfin avec des traits d’union insécables qui gardent chaque mot composé entier.

Voir le code en : Rust Python JSON

Retraits et espacement des paragraphes

Les deux mêmes paragraphes de six façons : tels quels, une première ligne rentrée, une première ligne sortie, l’espace au-dessus et au-dessous, un bloc justifié dont la dernière ligne est centrée, et l’endroit où la première et la dernière ligne se posent dans leur rectangle. Une deuxième page les compose de quatre autres façons : deux autres règles pour la première et la dernière ligne, des lettres seulement cernées d’un trait, et des lettres épaissies par un trait autour d’elles.

Voir le code en : Rust Python JSON

Les tabulations et leurs taquets

Les mêmes lignes tabulées sous chacune des trois méthodes, puis un sommaire dont les points courent jusqu’à un taquet placé à droite. Une tabulation peut avancer d’un pas depuis l’endroit où le texte s’est arrêté, tomber sur la grille régulière d’une machine à écrire, ou viser un taquet précis, sur lequel le texte qui suit commence, se centre, ou s’aligne par sa virgule.

Voir le code en : Rust Python JSON

Les tableaux

Des tableaux qui ajustent leurs colonnes au contenu, se coupent d’une page à l’autre et répètent leur ligne d’en-tête sur chaque nouvelle page. À quoi sert cette famille

Un tableau qui se pagine tout seul

Un long tableau confié d’un bloc, qui décide lui-même de son découpage en pages : son en-tête en haut de chaque page, sa note en bas de chaque page, la cellule d’un trimestre qui couvre ses lignes et se répète en haut de la page suivante quand une page la coupe, et une mention que l’on place soi-même sous chaque page, à l’endroit exact que le tableau indique.

Voir le code en : Rust Python JSON

Une page et un tampon dans des cellules de tableau

Une page de contrôle pour un dossier envoyé par quelqu’un d’autre : chaque ligne montre une de ses pages, prise entière dans le fichier où elle est arrivée, à côté d’un tampon dessiné une fois et placé dans chaque ligne à laquelle il a été attribué. Les deux sont ajustés à la cellule que le tableau leur laisse, sans réclamer de largeur à leur colonne ni de hauteur à leur ligne.

Voir le code en : Rust Python JSON

Un montant qui dit de quels titres il dépend

Les recettes de trente agences, trimestre par trimestre, sur deux pages. Chaque montant de la page est rattaché aux en-têtes sous lesquels il se trouve : l’agence à côté de lui, le trimestre au-dessus, et l’année au-dessus des quatre trimestres réunis. Lu à voix haute, un montant est annoncé par sa ville, son trimestre et son année avant la somme elle-même.

Voir le code en : Rust Python JSON

Un horaire qui rend compte de sa mise en page

Un horaire de bus dont chaque cellule encadrée contient une note qui explique sa taille, la largeur de sa colonne et la hauteur de sa ligne. Puis un tableau mis en page malgré ses défauts, une ligne coupée entre deux cadres, la place restante partagée entre les lignes, un tableau trop large pour son cadre réduit d’un bloc pour y tenir, et un même avis qui court de cellule en cellule en descendant une colonne, puis dans les deux cellules d’une ligne.

Voir le code en : Rust Python

Couleur, encres et impression

La couleur que vous demandez est celle qui part à la presse, et l’imprimeur prend le fichier tel quel. À quoi sert cette famille

Gris, couleurs écran et couleurs d’impression

Des pastilles dans chacune des trois façons de dire une couleur — un gris en un seul nombre, une couleur d’écran en trois, une couleur d’impression en quatre encres — chacune légendée par l’instruction réellement écrite dans le fichier, et un même gris moyen dit de quatre façons, la dernière dans le code hexadécimal que fournit un graphiste pour le web.

Voir le code en : Rust Python JSON

Une feuille telle qu’elle part à l’impression

Un dessin sur quatre pages : une feuille de presse qui indique jusqu’où court l’encre, où tombe la lame et ce qui mérite d’être gardé, avec les repères de coupe ; la même feuille rognée à la page finie ; une page à l’italienne qui indique un quart de tour horaire sur une feuille à la française ; et la première feuille de nouveau, comme moitié droite d’une feuille de presse large de deux pages.

Voir le code en : Rust Python JSON

Une feuille préparée pour l’imprimeur

Une feuille plus grande que la page finie : la couleur court trois millimètres au-delà de la lame, les repères de coupe se tiennent en dehors dans une encre que chaque plaque contient, chaque couleur est dite dans les quatre encres d’imprimerie, et la page nomme le papier, la limite de l’encre et la coupe. Donnez-lui le profil d’une presse et elle déclare PDF/X-4, et la feuille imprime sur elle-même le profil sur lequel elle repose.

Voir le code en : Rust Python JSON

Les mêmes nombres, exprimés pour avoir un sens

Six couleurs et un dégradé de gris peints trois fois avec exactement les mêmes nombres : d’abord laissés à la discrétion de l’appareil, puis dits de deux façons qui précisent par rapport à quel blanc ils sont mesurés, quelle courbe leur est appliquée et jusqu’où vont les couleurs de base. Une deuxième page peint des nombres nus qui ne disent rien de leur sens, et laisse la page elle-même le dire pour eux. Tout cela tient en une poignée de nombres, sans aucun profil à ranger dans le fichier.

Voir le code en : Rust Python JSON

Une règle au lieu de cent couleurs

Quatre façons d’écrire la règle que suit une couleur plutôt que les couleurs elles-mêmes : des couleurs mesurées lues dans une table, une plage coupée en bandes unies, une encre d’imprimerie montrée à l’écran, et deux règles mises bout à bout. Deux autres pages donnent à chaque opération qu’une telle règle peut employer sa propre bande de gris, puis rangent une même table à chaque précision, du seul noir et blanc à la plus fine.

Voir le code en : Rust Python JSON

Dessin, motifs et transparence

Traits, formes, dégradés et transparence tracés comme des instructions dans le fichier, et non comme des pixels — nets à toute taille, et d’un poids presque nul. À quoi sert cette famille

Dégradés en ligne droite, en cercle, et une couleur lue dans une fonction

Cinq panneaux : un bandeau dont la couleur s’éteint, le même fondu posé en diagonale, une lueur prolongée au-delà de son cercle pour que les coins se remplissent, un dégradé qui passe par une troisième couleur, et un damier dont la couleur se calcule à partir de l’endroit où se tient chaque point, plus rouge vers la droite et plus vert vers le haut.

Voir le code en : Rust Python JSON

Un plan qui montre ce qui se lit

Un plan de terrain dont les calques décident tout seuls quand apparaître. Un nom large se tient au-dessus de la parcelle tant que le plan est regardé en entier, les cotes fines des murs arrivent une fois qu’il est agrandi deux fois, et la phrase sous le plan est là en deux langues, dont le logiciel de lecture montre celle sur laquelle il est réglé.

Voir le code en : Rust Python JSON

Un dessin, placé autant de fois qu’on veut

Un badge construit comme un dessin et placé huit fois, plus une fois à demi-taille : le fichier contient le dessin une seule fois, quel que soit le nombre de placements. Une deuxième page montre un badge qui se tourne lui-même d’un quart de tour où qu’on le place, qui dit ce qu’il est, et qui contient son propre fichier : la liste des invités.

Voir le code en : Rust Python JSON

Les images

Des photographies placées à la taille et à l’endroit que vous choisissez, à partir des fichiers d’image que produisent déjà un appareil photo ou un scanner. À quoi sert cette famille

Une image ajustée à un rectangle

Une même image ajustée de huit façons dans un rectangle d’une seule taille : trois façons de la dimensionner, la même posée dans le coin en haut à gauche avec un retrait de 12 points, un quart de tour à gauche, un quart de tour à droite, une rotation de 20 degrés, et un miroir de gauche à droite — chaque panneau traçant l’image à l’endroit et à la taille que la bibliothèque a calculés. Une deuxième page en ajoute huit : l’image à sa propre taille, puis deux fois plus grande et coupée là où elle dépasse ; réduite seulement quand elle est trop grande ; posée à neuf positions à la fois ; placée au quart de la largeur et de la hauteur ; tournée d’un demi-tour ; et retournée de haut en bas.

Voir le code en : Rust Python JSON

Codes-barres et codes 2D

Les codes que lisent une caisse, une douchette d’entrepôt, une porte d’embarquement ou un téléphone, imprimés directement sur le document. À quoi sert cette famille

Formulaires, tampons et superpositions

Des cases que la personne qui reçoit le formulaire remplit à l’écran, et votre texte écrit par-dessus un modèle de page : un fichier PDF que quelqu’un d’autre a déjà créé. À quoi sert cette famille

Le filigrane d’une copie d’essai

Ce que vous obtenez avant de payer quoi que ce soit : un filigrane en travers de chaque page, et sous lui les mêmes pages, mises en page exactement comme une copie payée les met en page. C’est aussi le document qui dit ce qu’une clé de licence change, et pourquoi chaque chiffre de ce site est mesuré avec une clé.

Voir le code en : Rust Python JSON

Archivage, accessibilité et métadonnées

Des documents qui s’ouvriront encore dans des dizaines d’années, qu’un lecteur d’écran lit à voix haute, et qu’un système comptable enregistre sans ressaisie. À quoi sert cette famille

Un fichier qui explique ses entrées

La référence d’un service d’archives, le département dont le document vient, la date jusqu’à laquelle il doit être gardé et sa classification, écrits dans un fichier qu’une archive accepte encore. Aucune règle d’archivage ne sait ce qu’est une date de conservation, donc chaque entrée est accompagnée d’une description d’elle-même, et c’est cette description qui amène un contrôleur à accepter un fait que vous seul avez inventé. Une deuxième page ajoute une fiche de prêt dont les entrées sont un oui ou non, un type de fichier, un nom de personne, une mesure et deux adresses web, et donne à cette page son propre relevé caché.

Voir le code en : Rust Python JSON

Un avis balisé qui dit ce qu’est chaque partie

Un avis de livraison dont la structure cachée dit où se place chaque élément, ce que veut dire une abréviation et sous quels en-têtes se range chaque cellule du tableau, avec son en-tête courant, son numéro de page et ses numéros de ligne signalés comme décor ; puis toutes les numérotations de liste et tous les rôles qu’un élément peut recevoir.

Voir le code en : Rust Python