Les numéros que le lecteur affiche

Faire repartir la numérotation à un endroit du document, en chiffres romains, en lettres, ou derrière un préfixe.

Écrit au premier niveau d'une requête, sous "renumber"

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 livre, les premières pages — la préface, le sommaire — sont numérotées en petits chiffres romains, et le vrai texte repart à la page 1. L'annexe, elle, porte souvent A-1, A-2. On peut demander exactement ça : à partir de telle feuille, la numérotation repart à tel nombre, écrite de telle façon. C'est le numéro que le logiciel de lecture affiche dans sa petite case, celui qu'on tape pour aller directement à une page.

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.

renumber porte les reprises de numérotation : chaque entrée fait repartir, à partir d'une feuille, le numéro que le lecteur affiche. Ce numéro est distinct de la position physique de la feuille dans le fichier ; il vit dans l'étiquette de page. Six façons de l'écrire existent, dont une qui n'écrit qu'un préfixe et aucun chiffre. Le substituant {page_label} dans un texte dessine cette étiquette telle qu'un lecteur la montre.

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.

  • renumber — tableau, facultatif, vide par défaut.
  • renumber[].from_page — entier, obligatoire. La feuille à partir de laquelle la reprise prend effet ; les feuilles se comptent à partir de 1.
  • renumber[].value — entier ≥ 1, obligatoire. Le numéro affiché sur cette feuille. Zéro est refusé : la numérotation d'un lecteur ne sait pas l'écrire.
  • renumber[].style — chaîne, facultative, decimal par défaut. Six valeurs : decimal (1, 2, 3), upper_roman (I, II, III), lower_roman (i, ii, iii), upper_letters (A, B, C puis AA, BB), lower_letters (a, b, c puis aa, bb), prefix_only (le préfixe seul, sans chiffre).
  • renumber[].prefix — chaîne, facultative, vide par défaut. Ce que chaque page de la suite affiche avant son numéro : A- pour une annexe en A-1, A-2.

Une requête entière qui le dessine

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

{
  "renumber": [
    { "from_page": 1, "value": 1, "style": "lower_roman" },
    { "from_page": 3, "value": 1, "style": "decimal" }
  ],
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "text",
      "rect": { "llx": 60, "lly": 60, "urx": 535, "ury": 74 },
      "content": ["Page {page_label}"],
      "font": "sans",
      "font_size": 10,
      "align": "center"
    },
    {
      "type": "text",
      "pages": [4],
      "rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
      "content": ["The annex"],
      "font": "sans",
      "font_size": 14
    }
  ]
}

La ligne qui l'envoie, en trois langages

Le document dans son ensemble

Cent courriers dans un seul fichier Ce que le document dit de lui-même Un fichier lisible dans trente ans Une facture qu'un humain et une machine lisent L'adresse contre laquelle les liens se lisent La version de PDF que le fichier déclare Ce qu'une image dit d'elle-même

Où aller ensuite

Chaque clé d'une requête, en une page Les trente-deux autres réglages d'une requête

Voir les prix Voir les exemples

Glossaire

étiquette de page
Le numéro qu'un lecteur affiche pour une page, qui n'est pas sa place dans le fichier. C'est ce qui permet à une préface de courir en i, ii, iii et au corps de repartir à 1.

Tous les mots que le site explique