Une taille propre à certaines 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.

Dans un dossier relié, il arrive qu'une feuille soit plus grande que les autres : un plan, un grand tableau de chiffres. C'est exactement ce qu'on fait ici. On nomme la page par son numéro, on lui donne sa largeur et sa hauteur, et elle seule change. Toutes les autres gardent la taille commune du document.

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_sizes est une liste d'entrées, chacune nommant une page par son numéro à partir de 1 et lui donnant ses deux dimensions en points. Une entrée dit la taille d'une page, elle ne la crée pas : nommer une page au-delà de la fin du document laisse le document aussi long qu'il était. Une page nommée deux fois prend la dernière taille écrite pour elle.

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_sizes — tableau, facultatif, vide par défaut.
• page_sizes[].page — entier ≥ 1, obligatoire. Le numéro de la page visée.
• page_sizes[].width — nombre, obligatoire. Largeur en points.
• page_sizes[].height — nombre, obligatoire. Hauteur en points.

Une entrée prend le pas sur page pour la seule page qu'elle nomme. Pour qu'une page existe, un élément la nomme dans son pages, ou le contenu coule jusqu'à elle. Les autres pages gardent la taille de page, A4 par défaut.

Une requête entière qui le dessine

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

{
  "page_sizes": [{ "page": 2, "width": 841.89, "height": 595.28 }],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "pages": [1],
      "rect": { "llx": 60, "lly": 760, "urx": 535, "ury": 785 },
      "content": ["Page one, upright"],
      "font": "sans",
      "font_size": 14
    },
    {
      "type": "text",
      "pages": [2],
      "rect": { "llx": 60, "lly": 540, "urx": 780, "ury": 565 },
      "content": ["Page two, wider than it is tall"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

La ligne qui l'envoie, en trois langages