{{tag>Logiciel}}

====== dw2pdf : Exporter du contenu DokuWiki au format PDF ======

Le but de ce plugin était de fournir un convertisseur PDF simple et prêt à l'emploi qui reproduit presque fidèlement la vue d'écran de vos pages wiki (c'est-à-dire ne les convertit pas au format de document imprimé comme le plugin latex).

Il regroupe également les polices et bibliothèques nécessaires (d'où la taille de 48 Mo) afin que vous n'ayez pas besoin de faire de configuration pour le mettre en service le plus rapidement possible.

**__Caractéristiques__**
  * Utilise la bibliothèque PHP **mPDF**.
  * Gère différentes langues (il inclut la grande mais relativement complète police Unicode).
  * Personnalisation facile grâce aux en-têtes, pieds de page et CSS
  * Index automatique des signets
  * À utiliser avec le plugin BookCreator pour créer un PDF à partir des pages sélectionnées.

===== Pré-requis =====

  * Installez le paquet **[[apt>php-gd]]** ou en ligne de commande : <cli>$ sudo apt install php-gd</cli>

===== Installation =====

Recherchez et installez le plugin **dw2pdf** en utilisant le gestionnaire d'extensions

===== Configuration =====

===== Utilisation =====

Il y a trois façons d'exporter:

  ; Exporter une page
  : Il vous suffit d'appeler la page avec un paramètre <code - >do=export_pdf URL</code> supplémentaire.
  : Cela démarre l'exportation PDF de la page.
  : Certains modèles permettent au plugin d'étendre automatiquement les outils de pagination.
  : Pour d'autres modèles, vous devez l'implémenter vous-même pour ajouter un bouton ou similaire quelque part dans la conception de votre modèle.
  ; Exporter un espace de noms entier
  : Le paramètre URL do=export_pdfns permet d'exporter un espace de noms entier choisi en un seul PDF (par exemple, utilisez <code - >&do=export_pdfns&book_ns=my:namespace&book_title=Mytitle</code> (voir les options de configuration sur la façon d'exclure des pages spécifiques).
  ; Exporter la sélection de pages
  : Pour sélectionner seulement quelques pages à exporter vers un PDF, vous pouvez utiliser le plugin Bookcreator, qui offre une interface pour le plugin dw2pdf.

==== Syntaxe ====

Pour créer un lien dans n'importe quelle page wiki pour exporter n'importe quel espace de noms, vous pouvez utiliser la syntaxe suivante :<code - >~~PDFNS>namespace|pdftitle~~</code>
  ; namespace
  : l'espace de noms que vous souhaitez exporter
  ; pdftitle
  : titre du PDF généré en sortie

Vous pouvez ajouter d'autres options (comme <code - >&book_order=pagename</code>) en les ajoutant simplement au pdftitle.

Gestion des pages de démarrage : Si la page **<namespace>:start** n'existe pas, il vérifie si la page portant le nom **<namespace>** existe et s'ajoutera également au pdf.

==== Linked Images ====

Toutes les variantes de format d'image ne sont pas intégrées avec succès dans le PDF, même si elles sont correctement affichées dans DokuWiki.

Si des images manquent dans votre sortie, essayez de supprimer le canal Alpha de vos images (par exemple PNG).

==== Protection par mot de passe des documents générés ====

Pour définir un mot de passe fixe pour les documents générés, modifiez le fichier **dokuwiki/lib/plugins/dw2pdf/mpdf/config.php** en ajoutant les lignes :

<code - dokuwiki/lib/plugins/dw2pdf/mpdf/config.php>
$this->setUserRights();
$this->SetProtection(array('print','copy', 'modify'),'password','password');
</code>

où password est votre mot de passe

===== Désinstallation =====

===== Voir aussi =====

  * **(fr)** [[http://Article]]

----
//Basé sur << [[http://Article|Article]] >> par Auteur.//