Table des matières
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 php-gd ou en ligne de commande :
$ sudo apt install php-gd
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
do=export_pdf URL
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
&do=export_pdfns&book_ns=my:namespace&book_title=Mytitle
(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 :
~~PDFNS>namespace|pdftitle~~
- 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
&book_order=pagename
) 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 :
- dokuwiki/lib/plugins/dw2pdf/mpdf/config.php
$this->setUserRights(); $this->SetProtection(array('print','copy', 'modify'),'password','password');
où password est votre mot de passe