Bases de la génération des fichiers

Maintenant que nous avons créé un chapitre, il nous faut maintenant générer les fichiers dans le format souhaité.

Si vous avez suivi le document d’utilisation, vous avez sans doute utilisé le serveur local avec la commande raco pollen start.

Sachez que vous pouvez aussi générer les fichiers avec la commande suivante :

raco pollen render

Cela permettra de générer tous les fichiers qui se trouvent à la racine du projet. Par exemple, cela permet de générer tous les fichiers .html et .tex.

Attention

Seuls les fichiers à la racine du projet seront générés. Par exemple, concernant l'export web, vous n’aurez pas les fichiers CSS recréés de cette manière. Vous devrez soit allumer le serveur web de test et afficher la page qui les contient, soit effectuer la manipulation indiquée dans la section qui suit.

Régénérer spécifiquement un (ou plusieurs) fichier(s)

Vous pouvez (ré)générer spécifiquement des fichiers avec la commande suivante :

raco pollen render [<nom du fichier> ...]

Par exemple, s'il vous manque le fichier votre-chapitre.html :

raco pollen render 'votre-chapitre.html'

Info

Les guillemets ne sont pas obligatoires si vous n'avez pas d'espaces dans le nom du fichier.

Vous pouvez cumuler plusieurs fichiers dans la même commande :

raco pollen render 'votre-chapitre.html' './styles/accueil.css'

Si malgré cette commande, le fichier désiré ne se met pas à jour, il vous faudra déclencher un enregistrement sans modification. Vous pouvez suivre la procédure suivante :

WindowsLinuxMacOS

1. Ouvrir le fichier <nom du fichier> dans votre éditeur de texte.
2. Ajouter une lettre dans le texte.
3. Sauvegarder.
4. Retirer la lettre.
5. Sauvegarder.
6. Refaire la commande raco pollen render <nom du fichier>.

touch <nom du fichier>; raco pollen render <nom du fichier>

touch <nom du fichier>; raco pollen render <nom du fichier>

Régénérer tous les fichiers

Lorsque les fichiers ont déjà été générés une fois, la commande raco pollen render peut vous donner un résultat qui n'est pas à jour.

Vous pouvez régénérer tous les fichiers avec la suite de commandes suivante :

raco pollen reset; raco pollen setup; raco pollen render

Explications :

• reset va supprimer les fichiers transitoires ainsi que les fichiers de cache.
• setup va repréparer le projet.
• render va générer les fichiers se situant à la racine du projet.

Cette opération est plus longue que la régénération spécifique d'un fichier, mais cela a l'avantage de tout régénérer, notamment lorsque vous apportez une modification qui touche toutes les pages, comme par exemple la modification du template HTML ou l'ajout d'un chapitre au livre (cela a en effet pour conséquence de changer la liste des chapitres présente sur toutes les pages ainsi que la navigation entre chapitres).

Suite de la documentation

Vous avez peut-être constaté que les valeurs telles que le nom du livre ou le nom d'auteur / d'autrice n'étaient par corrects dans les diverses pages affichées. Nous allons tout de suite voir comment modifier ces valeurs dans Personnalisation du livre.