====== Ajouter des signets à un PDF ======

Source : [[https://maniacgeek.net/linux-open-source/creez-des-signets-pour-votre-pdf-avec-pdftk/#Ajout_de_signets|Créez des signets pour votre PDF avec pdftk]]

===== Récupérer les méta-données existantes =====
<note important>Ne sautez cette étape que si vous savez exactement ce que vous faites((Même un document produit par un scanner peut contenir des données et méta-données très utiles : date du scan, géométrie et orientation des pages, nombre de pages, etc.)).</note>
Si l'on souhaite conserver ou modifier les méta-données préexistantes (y compris les signets) il faut extraire ces données. Sinon, on peut directement passez à l'opération suivante en partant d'un fichier vide.

<code>
$ pdftk fichier-origine.pdf data_dump output metadata.txt
</code>

===== Ajouter ou modifier les signets =====
Éditer le fichier obtenu (dans l'exemple : metadata.txt((Obtenu par extraction ou en créant un fichier vide.))).

Les signets y sont déclarés à l'aide de blocs ayant la structure et la syntaxe suivantes :

<code>
BookmarkBegin
BookmarkTitle: Premier signet
BookmarkLevel: 1
BookmarkPageNumber: 2
</code>
La signification de chaque champ est immédiate, pas de surprise.

Pour ajouter des signets, créer autant de blocs de déclaration qu'on le souhaite. On peut sauter une ligne entre chaque bloc si on préfère.

Pour modifier les signets existants, utiliser la fonction de recherche de l'éditeur((Sur "BookmarkBegin", par exemple…)).

===== Incorporer les modifications =====
Il reste à incorporer les méta-données modifiées dans un nouveau document PDF.

<code>
$ pdftk fichier-origine.pdf update_info metadata.txt output fichier-destination.pdf
</code>

Le fichier obtenu contient les pages du document d'origine et les méta-données que l'on vient de modifier ou de créer.