Un PDF minimal

Ouvrez celui-ci en premier. Deux pages identiques, chacune avec le squelette d'une facture — une bande de couleur en haut, un cadre autour de tout, et deux douzaines de rectangles vides là où iraient les lignes d'un tableau — et pas un mot de texte nulle part sur l'une ou l'autre. C'est tout ce qu'il faut à un document pour exister : des pages, et des marques dessus. Il y en a deux plutôt qu'une parce que mettre la seconde coûte une seule instruction, et cela vaut d'être vu dès le départ. Tout le reste de ce site est bâti là-dessus, jamais à la place.

C'est aussi le document à essayer sur les machines des autres avant que quoi que ce soit de plus gros ne dépende de la réponse. Envoyez-le à un collègue, ouvrez-le sur un téléphone, donnez-le à celui qui s'occupe de vos ordinateurs : il est assez petit pour voyager dans un courriel et assez simple pour s'ouvrir sur tout ce qui a un écran. Et il est léger : dix mille copies tiennent encore sur une clé USB, avec de la place en plus.

Ce que montre cet exemple

Un bandeau de couleur en haut de chaque page, et un cadre autour de tout.
Deux douzaines de rectangles vides, là où iraient les lignes d'un tableau.
Des formes et rien que des formes : le fichier ne transporte donc aucune police d'écriture.

Le code source complet

Rien n'est omis et rien n'est simplifié : c'est le programme exactement tel qu'il tourne, pour le développeur qui utilise cette bibliothèque. La troisième est la description elle-même : une simple liste de ce que la page doit dire, et c'est elle qu'on envoie au service.

Voir le code Rust Voir le code Python Voir le code JSON