L’adresse à partir de laquelle se lisent les liens relatifs
Dire où le document a été publié, pour que ses liens courts continuent de mener au bon endroit après un déplacement.
Le résultat dans un vrai PDF
Un manuel qui dit comment il veut être lu
Quatre pages qui disent comment elles veulent être ouvertes : quelle page se présente et quelle part de la fenêtre elle remplit, les chapitres à côté, les pages deux par deux, une boîte d’impression déjà remplie — autant de souhaits auxquels le logiciel de lecture répond comme il l’entend.
Résumé
Dans un document, un lien peut être écrit en abrégé : « conditions.html », sans le début de l’adresse. Tant que le fichier reste à côté de cette page, tout va bien ; le jour où quelqu’un le télécharge et l’ouvre chez lui, l’abréviation ne mène plus nulle part. Écrite une fois en tête du document, l’adresse complète de l’endroit d’où il vient sert de base à la lecture des abréviations, où que le fichier se trouve.
Techniquement
Écrit au premier niveau d’une requête, sous
"base_uri"
base_uri écrit /URI et son /Base dans le catalogue, l’adresse par rapport à laquelle se résolvent les liens relatifs du document. Un lien vers terms.html ne veut rien dire tant que le document n’a pas dit où il a été publié ; c’est cette déclaration qui maintient de tels liens valides une fois le fichier déplacé. Les liens absolus, eux, mènent où ils disent, quoi qu’il arrive.
Schéma de la requête
-
base_uri— chaîne, facultative, absente par défaut. L’adresse complète par rapport à laquelle se lisent les adresses relatives du document, par exemplehttps://hqf-pdf.com/en/handbook/.
Elle vaut pour toutes les adresses relatives que le document contient : celles d’un élément link avec {"uri": "..."}, et celles d’une action uri. Une adresse absolue reste lue telle quelle.
Une requête entière qui crée un PDF
{
"base_uri": "https://hqf-pdf.com/en/handbook/",
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 758 },
"content": ["Read the terms"],
"font": "sans",
"font_size": 12
},
{
"type": "link",
"rect": { "llx": 60, "lly": 738, "urx": 160, "ury": 760 },
"to": { "uri": "terms.html" }
}
]
}
Le document dans son ensemble
Les numéros que montre le logiciel de lecture Cent courriers dans un seul fichier Ce que le document dit de lui-même Ce que le document dit de lui-même, dit une seule fois Un texte que personne ne peut copier Les notes qu’un programme laisse pour lui-même Les notes qu’un programme laisse sur une page Les données qu’un programme accroche à un passage d’encre Un fichier encore lisible dans des dizaines d’années La norme d’impression que le document déclare La norme d’impression variable déclarée par le document Le mot de passe qui l’ouvre, et ce qu’on peut en faire Une facture qu’un humain et une machine lisent La version de PDF que le fichier déclare Les extensions de PDF dont le fichier dit se servir Ce qu’une image dit d’elle-même, et comment elle est lue Les pièces jointes du document, à côté de ses pages Des fichiers que le document nomme sans les contenir Les pièces jointes, présentées en portefeuille Les pièces jointes que revendique une page Les pièces jointes que revendique une police La fiche d’identité propre à une police Les pièces jointes que revendique la fiche du document Une fiche de document rédigée ailleurs Les zones d’une page où un lecteur mesure La fiche d’identité que contient une seule page La norme d’accessibilité que le document déclare Les normes contre lesquelles le document fini est mesuré
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête