La taille des pages

En mots de tous les jours

Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.

Une feuille de papier a une largeur et une hauteur. Ici c'est pareil : on donne la largeur, on donne la hauteur, et toutes les pages sortent à cette taille. Si on ne dit rien, on obtient la feuille de l'imprimante du bureau, celle qu'on trouve partout en Europe. La mesure ne se compte pas en centimètres mais en points : il en faut un peu plus de 28 pour faire un centimètre. La feuille de bureau fait ainsi 595 points de large et 842 de haut.

Pour un développeur

Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.

page fixe la taille de toutes les pages du document, en points typographiques (un point vaut un soixante-douzième de pouce). L'origine des coordonnées est le coin bas-gauche de la feuille, et les éléments se positionnent depuis là. Les deux nombres sont obligatoires dès que l'objet est présent. Une page qui veut une taille à elle passe par page_sizes, qui la nomme par son numéro et prend le dessus. Les expressions de coordonnées {page_width} et {page_height} valent ces deux nombres.

Chaque clé, avec son défaut

La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.

• page — objet, facultatif. Absent, la feuille vaut 595 × 842 points (A4).
• page.width — nombre, obligatoire dès que page est présent. Largeur en points.
• page.height — nombre, obligatoire dès que page est présent. Hauteur en points.

Portée : toutes les pages du document. page_sizes reprend la main page par page, par numéro à partir de 1. Les clés inconnues d'un objet sont ignorées ; une même clé écrite deux fois dans le même objet est refusée à la lecture.

Une requête entière qui le dessine

Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.

{
  "page": { "width": 420, "height": 595 },
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 40, "lly": 530, "urx": 380, "ury": 555 },
      "content": ["A5 upright"],
      "font": "sans",
      "font_size": 18
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

point typographique

L'unité avec laquelle l'imprimerie mesure, un peu plus d'un tiers de millimètre : soixante-douze d'entre eux font un pouce. Le papier, les marges et la hauteur des lettres se comptent tous dedans, et chaque mesure écrite dans un fichier PDF aussi.

Tous les mots que le site explique