Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
logiciel:internet:dokuwiki:plugins:bookcreator:start [2020/10/23 09:05] – admin | logiciel:internet:dokuwiki:plugins:bookcreator:start [2022/10/01 23:26] (Version actuelle) – modification externe 127.0.0.1 |
---|
{{tag>Logiciel}} | {{tag>Logiciel}} |
| |
====== BookCreator : créer un livre (PDF, ODT ou text) ====== | ====== bookcreator : créer un livre (PDF, ODT ou text) ====== |
| |
Le plugin bookcreator permet à l'utilisateur de sélectionner certaines pages d'un wiki, puis de les exporter pour créer un petit livre ou texte PDF. | Le plugin bookcreator permet à l'utilisateur de sélectionner certaines pages d'un wiki, puis de les exporter pour créer un petit livre ou texte PDF. |
Vous pouvez utiliser le glisser-déposer pour modifier l'ordre et déplacer des pages vers l'intérieur et vers l'extérieur. | Vous pouvez utiliser le glisser-déposer pour modifier l'ordre et déplacer des pages vers l'intérieur et vers l'extérieur. |
| |
====== Pré-requis ====== | ===== Pré-requis ===== |
| |
* l'exportation PDF nécessite le plugin **dw2pdf** | * l'exportation PDF nécessite le plugin **dw2pdf** |
* l'exportation de texte nécessitait le plugin **text** | * l'exportation de texte nécessitait le plugin **text** |
| |
====== Installation ====== | ===== Installation ===== |
| |
====== Configuration ====== | ===== Configuration ===== |
| |
===== Options de configuration disponibles ===== | ==== Options de configuration disponibles ==== |
| |
^ Nom ^ Description ^ | ^ Nom ^ Description ^ |
| skip_ids | N'affiche pas les outils si pageid contient l'un de ces identifiants. | | | skip_ids | N'affiche pas les outils si pageid contient l'un de ces identifiants. | |
| |
===== Modification du fichier généré ===== | ==== Modification du fichier généré ==== |
| |
Si vous souhaitez configurer/modifier le fichier pdf ou odt généré, vous devez vous référer respectivement aux plugins **dw2pdf** ou **odt**. | Si vous souhaitez configurer/modifier le fichier pdf ou odt généré, vous devez vous référer respectivement aux plugins **dw2pdf** ou **odt**. |
Le plugin bookcreator ne fournit que l'interface pour créer une sélection de pages qui est soumise à ces plugins pour la génération du fichier. | Le plugin bookcreator ne fournit que l'interface pour créer une sélection de pages qui est soumise à ces plugins pour la génération du fichier. |
| |
====== Utilisation ====== | ===== Utilisation ===== |
| |
===== Créer des outils de gestion de livre sur wiki:ebook ===== | ==== Créer des outils de gestion de livre sur wiki:ebook ==== |
| |
Avant d'utiliser ce plugin, vous devez créer une page avec le gestionnaire de livres. | Avant d'utiliser ce plugin, vous devez créer une page avec le gestionnaire de livres. |
* Enregistrer et restaurer des sélections sur un espace de noms spécifique (utilisez les droits d'ACL) | * Enregistrer et restaurer des sélections sur un espace de noms spécifique (utilisez les droits d'ACL) |
| |
==== Example ==== | === Example === |
| |
Mettez sur wiki:ebook la syntaxe : | Mettez sur wiki:ebook la syntaxe : |
<code - >~~BOOK~~</code> | <code - >~~BOOK~~</code> |
Et après avoir marqué au moins une page à inclure dans le livre, le gestionnaire de livres apparaît. | Et après avoir marqué au moins une page à inclure dans le livre, le gestionnaire de livres apparaît. |
{{ :logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-01.png |}} | {{ logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-01.png |}} |
| |
==== Initiate a book ==== | === Initiate a book === |
| |
Utilisez le lien ou le bouton **Ajouter/Supprimer au livre** dans votre modèle pour pointer une première page que vous souhaitez ajouter à un livre PDF. | Utilisez le lien ou le bouton **Ajouter/Supprimer au livre** dans votre modèle pour pointer une première page que vous souhaitez ajouter à un livre PDF. |
{{ :logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-02.png |}} | {{ logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-02.png |}} |
| |
L'image sur le côté gauche est le lien ajouté automatiquement au modèle **dokuwiki**, voir les instructions d'installation ci-dessous pour d'autres modèles. | L'image sur le côté gauche est le lien ajouté automatiquement au modèle **dokuwiki**, voir les instructions d'installation ci-dessous pour d'autres modèles. |
| |
Après avoir sélectionné la première page, une barre d'outils apparaît sur chaque page qui vous permet d'ajouter ou de supprimer des pages supplémentaires. Cette barre d'outils fait également référence à l'outil de gestion de livre. | Après avoir sélectionné la première page, une barre d'outils apparaît sur chaque page qui vous permet d'ajouter ou de supprimer des pages supplémentaires. Cette barre d'outils fait également référence à l'outil de gestion de livre. |
{{ :logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-03.png |}} | {{ logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-03.png |}} |
| |
L'outil de gestion de livre que vous avez créé ci-dessus (par défaut sur wiki:ebook) avec %%~~BOOK~~%% permet de réorganiser et d'exclure des pages de votre sélection. | L'outil de gestion de livre que vous avez créé ci-dessus (par défaut sur wiki:ebook) avec %%~~BOOK~~%% permet de réorganiser et d'exclure des pages de votre sélection. |
Lorsque vous disposez de suffisamment d'autorisations ACL dans l'espace de noms où les sélections sont enregistrées (au moins le **changement**), vous pouvez également enregistrer et sélectionner ces sélections. | Lorsque vous disposez de suffisamment d'autorisations ACL dans l'espace de noms où les sélections sont enregistrées (au moins le **changement**), vous pouvez également enregistrer et sélectionner ces sélections. |
| |
==== Afficher les sélections enregistrées ==== | === Afficher les sélections enregistrées === |
| |
Sous le gestionnaire de livres, une liste s'affiche avec les sélections enregistrées. | Sous le gestionnaire de livres, une liste s'affiche avec les sélections enregistrées. |
Les autorisations pour cet espace de noms et les pages peuvent être définies comme d'habitude via le gestionnaire ACL. | Les autorisations pour cet espace de noms et les pages peuvent être définies comme d'habitude via le gestionnaire ACL. |
| |
==== Exemple ==== | === Exemple === |
| |
Liste 5 sélections, triées par date | Liste 5 sélections, triées par date |
<code - >~~ARCHIVEBOOK:5&date~~</code> | <code - >~~ARCHIVEBOOK:5&date~~</code> |
{{ :logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-04.png |}} | {{ logiciel:internet:dokuwiki:plugins:bookcreator:bookcreator-04.png |}} |
| |
===== Changer l'ordre des pages du wiki ===== | ==== Changer l'ordre des pages du wiki ==== |
| |
Pour changer l'ordre des pages wiki dans votre livre, déplacez simplement les pages dans la liste. | Pour changer l'ordre des pages wiki dans votre livre, déplacez simplement les pages dans la liste. |
Relâchez le bouton de la souris pour terminer le déplacement de la page vers son nouvel emplacement. | Relâchez le bouton de la souris pour terminer le déplacement de la page vers son nouvel emplacement. |
| |
===== Sauvegarder des livres ===== | ==== Sauvegarder des livres ==== |
| |
Format des pages de livre enregistrées: lorsque vous enregistrez un livre, il est enregistré dans le format indiqué ci-dessous. | Format des pages de livre enregistrées: lorsque vous enregistrez un livre, il est enregistré dans le format indiqué ci-dessous. |
* Pour créer un livre à partir de zéro, démarrez une nouvelle page telle que wiki:ebook:mybookname (par défaut). L'espace de noms peut être modifié lors de la configuration côté administrateur. | * Pour créer un livre à partir de zéro, démarrez une nouvelle page telle que wiki:ebook:mybookname (par défaut). L'espace de noms peut être modifié lors de la configuration côté administrateur. |
| |
====== Désinstallation ====== | ===== Désinstallation ===== |
| |
====== Voir aussi ====== | ===== Voir aussi ===== |
| |
* **(en)** [[https://www.dokuwiki.org/plugin:bookcreator]] | * **(en)** [[https://www.dokuwiki.org/plugin:bookcreator]] |