Le module freedom-book rassemble trois familles : le livre, le chapitre et l'assemblage. Ce module permet de concaténer un ensemble de textes ou de fichiers afin de composer un fichier PDF final qui sera le résultat de l'assemblage de ces chapitres.

Cet assemblage peut se faire de deux façons différentes. La première avec des textes écrits en lignes et la deuxième avec des fichiers que l'on aura téléchargés.

Le livre est un famille qui permet de construire un documents en rassemblant un ensemble de chapitres. Ces chapitres contiennent un texte formaté que le livre devra assembler suivant l'ordre choisi.

Le livre permet deux façons de réaliser votre mise en pages. La première consiste a renseigner les paramètres d'entêtes défini dans le cadre “mise en pages. Pour les entêtes et les pieds de pages vous pouvez utiliser les mots-cles ##PAGE## pour désigner la page courante et '##PAGES##' pour désigner le nombre total de pages.

Si vous choisissez de mettre une table des matières cette-ci sera inséré après la page de garde. Cette table des matières ne sera visible que sur le fichier PDF produit.

La deuxième méthode de mise en page consiste à fournir un fichier au format openDocument Text pour définir les différents styles (style des titres, des entêtes, etc.). Si le fichier est présent les autres informations de mise en pages sont ignorées.

Pour créer un chapitre, il faut cliquer sur le menu “Insérer un nouveau chapitre”

Cela va associer un nouveau chapitre aux livre. La numérotation permet d'ordonner le chapitre dans le livre. Le chapitre un devra avoir le numéro 1. Le numéro zéro est réservé à la page de garde. Vous pouvez aussi définir des sous-chapitres ; mettez 1.2 pour désigner le sous chapitre deux du chapitre un. Dans le cas de sous chapitre, il ne faut pas mettre de style de titre de niveau supérieur. Par exemple pour un chapitre de niveau deux il ne faut pas mettre de style “titre 1”.

Grâce à l'éditeur intégré vous pouvez écrire directement votre texte et ajouter des images.

Il est aussi possible de renseigner des valeurs d'attributs du livre en utilisant les noms d'attributs en majuscules et entre crochets.

Pour voir l'ensemble des chapitres constitués vous cliquez sur le menu “Ouvrir” du livre. Vous pouvez ensuite cliquer sur les liens à droite pour voir les chapitres. Si vous cliquez sur l'icone vous ouvrez directement le chapitre en édition. Vous pouvez éditer plusieurs chapitres en même temps; si vous cliquez sur un autre chapitre vous pouvez revenir au précédent sans perdre votre édition.

Une fois vos chapitres écrit vous pouvez voir une pré-assemblage en cliquant sur le menu “Visualisation” du livre. Cela vous donne un aperçu HTML de l'assemblage des chapitres.

Pour construire la version PDF, le serveur de transformation doit être installé et configuré. Cliquer sur le menu “Génération PDF” pour lancer l'assemblage.

Le livre fournit par le module est la base pour l'assemblage de texte. Il peut être dérivé pour vos besoins spécifiques en ajoutant vos propres attributs. Les chapitres peuvent aussi êtres soumis à des cycles de vies. Vous pouvez aussi autoriser certains groupes d'utilisateur à modifier des chapitres de tel type et pas à d'autre. A vous d'imaginer ce que vous pouvez en faire pour l'adapter à votre besoin.

L'assemblage de fichiers permets de constituer un fichier PDF unique qui rassemble un ensemble de fichiers. Cet assemblage de fichier est réalisé avec la famille Assemblage. Cette famille va définir un ensemble de fichiers qui seront une succession de chapitre de niveau un. Au contraire du livre, avec cette famille l'assemblage de sous-chapitres n'est pas possible. Chaqu'un des fichiers chapitre est un fichier au format openDocument Text ou Microsoft Word. Si vous voulez insérer des feuilles de tableurs, il faudra les insérer par copier/coller (sans faire de liens) dans un fichier texte.

La sélection des fichiers à insérer comme chapitre se fait par une sélection de documents qui contiennent au moins un fichier. Pour cela dans le tableau “chapitres”, vous sélectionnez d'abord la famille dans la première colonne, ensuite vous sélectionnez le document de la famille voulu. Ensuite, de manière optionnelle vous pouvez choisir l'attribut fichier dans le cas ou le document en possède plusieurs. Attention, les tableaux de fichiers ne sont pas supportés par l'assembleur. Ensuite si votre document chapitre est contraint par un cycle de vie vous pouvez sélectionner l'état dans lequel vous voulez votre chapitre. Si un état est sélectionné, l'assembleur choisira le dernier fichier dans l'état désigné. Cet état est forcément figé, cela signifie que le fichier n'est pas modifiable. Si vous faite une modification au document chapitre (forcément dans l'état courant) il faudra ré-appliquer un changement d'état pour que le fichier soit pris en compte par l'assembleur. Si le document n'est pas disponible dans l'état souhaité, le fichier n'apparaitra pas. S'il n'y as pas d'état, par défaut c'est la révision du document utilisé lors de son insertion qui sera utilisé. Si le document chapitre est révisé après son insertion, les modifications ne seront pas prise en compte par l'assembleur. Si vous voulez toujours la dernière révision, il faut alors choisir “La plus récente”.

Une fois les documents choisis, l'assembleur vous affiche des liens pour consulter les fichiers et les documents dont sont issus les fichiers qui vont être utilisés pour l'assemblage.

Afin d'assembler les chapitres, il est nécessaire aussi de renseigner le fichier principal au format openDocument Text, qui contiendra le style général du fichier assemblé. Il peut être utilisé pour définir les entêtes et les pieds de pages ainsi que la table des matières.

:!:Pour la tables des matières, il est nécessaire d'avoir utilisé des textes avec les styles “titre 1”, “titre 2” et “titre 3” pour que cette table soit correctement produite. Une fois utilisé, vous pouvez effacer les textes si vous n'en avez pas usage dans le fichier de garde.

Pour lancer l'assemblage, le serveur de transformation doit être installé et configuré. Lorsqu'il est configuré il faut cliquer sur le menu “Assembler” pour lancer la procédure d'assemblage. Cette procédure se déroule en deux temps. Vous verrez d'abord apparaître le fichier assemblé dans le format “openDocument Text” puis dans un second temps la version PDF sera disponible. Voici un exemple du pdf produit avec la table des matières et les entêtes de pages.