L'adresse contre laquelle les liens se lisent
Dire où le document a été publié, pour que ses liens courts continuent de mener au bon endroit après un déplacement.
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 est ce à partir de quoi les abréviations se lisent, 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 contre laquelle les liens relatifs du document se résolvent. 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 garde de tels liens vivants 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 contre laquelle les adresses relatives du document se lisent, 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 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 revendique 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 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 Les pièces jointes, présentées en portefeuille Les pièces jointes d'une page 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