Les chapitres

Pour chacun de vos chapitres, vous aurez à créer un document.

Ce document utilise une structure spécifique que nous allons voir ensemble.

Support du Markdown

Vous avez également théoriquement la possibilité d’utiliser du markdown, mais vous limiterez les fonctionnalités notamment pour l’export HTML. Vous pouvez aller sur la documentation (en anglais) de Pollen pour avoir un aperçu du fonctionnement : https://docs.racket-lang.org/pollen/second-tutorial.html.

Base d’un document de chapitre

Voici la base d’un document :

pollen

#lang pollen

◊(define-meta title "Votre titre de chapitre")

— Euh… C’est tout ?

Oui ! C’est tout ! Le reste, c’est à vous de décider ce que vous voulez mettre. Voici un exemple :

pollen

#lang pollen

◊(define-meta title "Votre titre de chapitre")
◊livre-chapitre-titre{Titre affiché dans le corps}

◊livre-chapitre-corps{Bonjour, voici le début de ce chapitre.

Pour créer un paragraphe, vous devez faire deux retours à la ligne.}

— C’est quoi ◊livre-chapitre-titre et ◊livre-chapitre-corps * ?*

C’est ce que nous appellerons des balises.

Elles encapsulent du texte pour leur donner un sens, une intention. ◊livre-chapitre-titre permet par exemple à Fabrilivre de savoir que l’on veut afficher un titre du chapitre. ◊livre-chapitre-corps marque un passage avec du corps de texte principal ; c’est ce que vous utiliserez quasiment tout le temps normalement (sauf s’il n’y a pas de texte dans votre roman…).

Vous pouvez prendre connaissance des balises existantes ici : Référence des balises.

Gérer la navigation des chapitres

Une fois que le document est prêt, il faut l’inclure dans une liste. Cette liste permet de relier les chapitres, de créer la navigation. Le fichier qui contient cette liste est différent pour chaque format d’export, car l’expérience a démontré que les différents exports n’incorporaient pas forcément les mêmes chapitres et contenus.

La gestion des chapitres se fait au niveau de ces fichiers :

• Export web/HTML : index.ptree
• Export EPUB : epub/index_epub_text.ptree
• Export LuaLaTeX : latex/modele.tex

Générer les fichiers

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

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 raco pollen render. Cela permettra d’obtenir tous les fichiers d’un coup.

Par exemple, cela permet de régénérer tous les fichiers HTML.

Mais attention ! Cela ne créera que les fichiers de base ; vous n’aurez pas les fichiers CSS recréés si vous les avez modifiés.

à faire  : ajouter une liste de commandes lancées communément. à faire  : documentation de ligne de commande.

Suite de la documentation

Maintenant que vous savez créer des chapitres et générer les fichiers, vous pouvez commencer à travailler vos documents pour l’export HTML.

Vous pouvez prendre connaissance des balises existantes ici : Référence des balises.

Ou vous pouvez continuer votre lecture pour savoir comment déployer vos fichiers sur votre hébergement. (à faire)

Ou vous pouvez voir comment créer les autres exports :

• EPUB (à faire)
• PDF (à faire)