README.md

La classe livrelitt permet de rédiger un livre littéraire (Roman).

Avec cette classe, vous pouvez, à partir d'un fichier .tex et un fichier Scribus (.sla) générer :

• le fichier avec le contenu du livre, au format classique attendu par un imprimeur (*.pdf) ;
• un fichier pour l'impression de la couverture (*.cover.pdf) ;
• un fichier de brouillon, contenant l'ensemble du texte, permettant une impression pour d'éventuelles relectures (*.draft.pdf) ;
• un fichier contenant une version numérique du livre (*.epub).

Pour débuter un nouveau livre, n'hésitez pas à vous inspirer de l'exemple livré.

Pré-requis

En plus d'une installation complète de LaTeX (contenant pdflatex, mk4ht, htlatex et latexmk), l'utilisation de cette classe nécessite également :

• perl ;
• Scribus ;
• gimp ;
• pdftoppm ;
• Calibre.

Rédaction du livre

Le fichier .tex est attendu en UTF-8 et rédigé directement en français, y compris pour les accents ou les caractères particuliers (guillemets français, par exemple). À cause d'une limitation dans les paquets utilisés, les guillemets français ne doivent toutefois pas être suivis ou précédés d'espaces insécables, mais d'espaces classiques. Il est bien entendu également possible d'utiliser les commandes particulières du LaTeX (tel que \og et \fg si votre clavier ne vous permet pas de faire les guillemets français).

Afin de détecter quelques fautes qui ne sont normalement pas visibles, la génération n'aura pas lieu si, dans le corps du document .tex (après le préambule) :

• des guillemets ouvrants sont suivis d'une espace insécable ; pour passer outre le contrôle, utiliser «~ ;
• des guillemets fermants sont précédés d'une espace insécable ; pour passer outre le contrôle, utiliser ~» ;
• des tirets quadratins en début de ligne (donc, en principe, lors d'une ouverture de dialogue) ; pour passer outre ce contrôle, utiliser ---.

Paramètres de la classe

La classe accepte les paramètres suivants :

• petitlivre, peut être utilisé avec un livre ayant peu de contenu, afin de « gonfler » artificiellement le nombre de pages ;
• lettrine ajoute une lettrine au début de chaque chapitre classique (pas pour les chapitres définis avec *).

Paramètres du préambule

Différentes commandes, utilisables uniquement dans le préambule du document, permettent de fixer les paramètres du livre :

• \Titre{titre du livre} permet d'indiquer le titre du livre. Si vous ne précisez pas ce paramètre, le titre sera « ?Titre? ».
• \Auteur{Nom, Prénom \et AutreNom} défini le ou les auteurs du livre. La partie fournie avant la virgule est celle sur laquelle le tri doit s'effectuer, il s'agit en général du nom ; la partie après la virgule se présente, au naturel, avant la partie qui précède. Il s'agit en général du prénom. La virgule n'est pas obligatoire (cas d'un pseudonyme, par exemple), et doit être suivie d'une espace si elle est présente. Le \et permet de définir plusieurs auteurs au livre. Il est suivi et précédé d'une espace. Si aucun auteur n'est spécifié, « ?Auteur? » apparaitra.
• \Contributeur{[code rôle/Rôle] Nom, Prénom \et …} peut être utilisé pour indiquer un ou plusieurs contributeurs supplémentaires, tel qu'un illustrateur, un photographe, etc. Le Rôle est le nom du rôle en clair (par exemple Illustratrice ou Illustrations) tandis que code rôle est l'un des codes spécifiés par la norme OPF (par exemple ill). Les rôle et code rôle sont encadrés de crochets et séparés par une barre oblique. Une espace doit séparer le crochet final du nom de l'auteur. Excepté pour le rôle, la syntaxe est la même que pour l'auteur. L'utilisation de cette commande est facultative.
• \Resume{Résumé} permet de rédiger le résumé (quatrième de couverture) du livre. Ce résumé apparaitra sur la couverture et sur la version brouillon du livre. Le résumé doit uniquement contenir du texte et pas de commande LaTeX. Il peut toutefois faire plusieurs paragraphes. Si le résumé n'est pas spécifié, il sera identique au titre.
• \Categorie{Catégorie} fixe la catégorie du livre (Policier, Science fiction, ou tout simplement Roman). Sans cette commande, la catégorie indiquée est « Roman ».
• \Editeur{Éditeur} vous permet d'indiquer l'éditeur du livre. Si vous n'utilisez pas cette commande, la valeur sera « Auteur-Éditeur ».
• \DroitsDAuteur{Licence} peut être utilisée pour donner la licence du livre. C'est une commande facultative mais recommandée. Si elle n'est pas spécifiée, la mention « © » suivie de la date sera insérée.
• \Isbn{Version papier}{Version numérique} est une commande pour indiquer le numéro ISBN du livre. En principe, un même livre sous deux formats différents devrait avoir deux numéros d'ISBN différents. Le premier numéro est utilisé pour la version papier du livre, tandis que le deuxième est utilisé dans la version numérique. La version brouillon n'utilise pas de numéro ISBN. Chacun des numéros est facultatif, la commande elle-même n'est pas nécessaire.
• \InfoImpression{Détails} peut être utilisée pour ajouter des détails sur l'imprimeur (par exemple, nom de l'imprimeur, date de l'impression). La commande est facultative.
• \DepotLegal{Date} vous permet de spécifier la date du dépôt légal du livre. En principe, on ne spécifie que le mois et l'année (par exemple juin 2017). La commande est facultative.
• \PresseEtrangere peut être utilisé pour ne pas afficher « imprimé en France » dans la version papier du livre. C'est une commande facultative.
• \DuMemeAuteur{Autres publications} est une commande facultative qui permet d'afficher les autres livres écrits par le même auteur. Le paramètre fourni peut contenir plusieurs paragraphes ainsi que des commandes LaTeX.

Mise en forme

Cette classe hérite de la classe standard « book ». Vous pouvez donc utiliser toutes les commandes de mise en forme de cette classe. Vous pouvez également utiliser les commandes spécifiques :

• \— pour démarrer un dialogue (c'est un tiret quadratin, et non un signe moins) ;
• \dial pour démarrer un dialogue (pour le cas où votre clavier ne permet pas de faire des —) ;
• \barre{texte} pour afficher un texte barré ;
• \etranger{texte} pour du texte en langue étrangère ;
• \separateurpar qui ajoute un astérisme afin de séparer deux paragraphes logiques ;
• \pageillustr{image} pour ajouter une illustration pleine page (l'illustration sera placée sur l'intégralité de la prochaine page) ; pour plus d'informations sur les formats d'image, voir ci-dessous.

Des environnements supplémentaires peuvent également être utilisés :

• \begin{dedicace}…\end{dedicace} permet de délimiter la dédicace du livre ; cette dédicace s'affiche sur une page vide, les paragraphes alignés à droite ;
• \begin{narrateur}…\end{narrateur} permet d'encadrer une zone dans lequel le narrateur n'est pas l'un des personnages du livre ; ces zones ont une mise en forme différente ;
• \begin{manuscrit}…\end{manuscrit} peut être utilisée pour identifier une zone écrite avec une police de caractères imitant l'écriture manuscrite.

Par défaut, l'en-tête du livre contiendra le nom de l'auteur sur les pages de gauche et le titre du livre sur les pages de droite. Les pieds de page contiennent le numéro de la page. Notez que, conformément aux normes esthétiques dans l'industrie du livre, en-têtes et pieds de page ne s'affichent qu'au « milieu » d'un chapitre en cours.

Les valeurs par défaut peuvent être modifiées par les commandes, utilisables uniquement dans le préambule :

• \Entete[position]{valeur} pour positionner les en-têtes ;
• \PiedPage[position]{valeur} pour indiquer les pieds de page.

Ces commandes acceptent en premier paramètre, optionnel, entre crochets, une lettre pour indiquer si l'on souhaite modifier les pages de droite (avec un D) ou les pages de gauche (avec un G). Si cette valeur n'est pas indiquée, ou est différente de D ou G (en lettres capitales), les deux côtés sont modifiés. Les définitions suivantes peuvent être utiles pour ces commandes :

• \LeTitre, qui sera remplacé par le titre du livre ;
• \LAuteur, qui sera remplacé par l'auteur du livre ;
• \LaPartie{marque} pour extraire le nom de la partie en cours ;
• \LeChapitre{marque} pour extraire le nom du chapitre en cours.

Pour ces deux dernières commandes, il faut spécifier la marque à utiliser, parmi \topmark, \botmark et \firstmark pour respectivement le dernier élément de la page précédente, le dernier élément de la page en cours ou le premier élément de la page en cours (cf. manuel d'utilisation de TeX).

Images

Les images à insérer dans le livre doivent se trouver dans le même répertoire que le document LaTeX. Ces images doivent être au format PNG ou JPEG et avoir respectivement l'extension .png ou .jpg.

Les images peuvent être en couleur et doivent avoir la meilleure résolution possible. Pour une image à utiliser en pleine page (avec \pageillustr), la taille doit être de 600×800 ou proportionnelle.

Les images sont automatiquement modifiées comme suit :

• pour la version numérique du livre, les images sont rabaissées à une résolution maximale de 600×800 ;
• pour la version imprimable du livre, les images sont converties en niveaux de gris.

Important ! Des répertoires images et pictures sont automatiquement créés par le processus automatique pour gérer les images utilisées dans le livre électronique et dans la version imprimable. Ne créez surtout pas de tels répertoires vous-même, car ils seront supprimés dès l'exécution d'un make clean.

Création de la couverture

La couverture doit être créée avec Scribus. Il est conseillé de faire déborder vos images, couleurs, etc. de quelques millimètres et définir un « fond perdu ». Il est également possible d'indiquer des traits de coupe. La taille du fond perdu et la longueur des traits de coupe peuvent se régler dans le menu Fichier/Réglage du document, onglet Export PDF. Demandez à votre imprimeur les paramètres dont il a besoin.

Votre document doit obligatoirement contenir des champs ayant les noms suivants. Vous pouvez toutefois jouer sur la position, la taille et la couleur de ces champs afin qu'ils ne soient pas visibles :

• Auteur pour le nom de l'auteur (ou des auteurs) sur la première de couverture ;
• AuteurDos qui contiendra également le nom de l'auteur, est prévu pour le dos du livre ;
• AuteurTranche, toujours pour le nom de l'auteur, est prévu pour la tranche du livre ;
• Titre avec le titre du livre sur l'avant du livre ;
• TitreDos, également pour le titre, mais sur le dos du livre ;
• TitreTranche, encore pour le titre, prévu pour la tranche du livre ;
• Contributeur contiendra le nom des éventuels contributeurs ;
• Éditeur, pour la face avant du livre, contiendra la nom de l'éditeur ;
• ÉditeurDos est également pour le nom de l'éditeur, mais prévu pour le dos du livre ;
• Résumé, prévu pour le résumé de quatrième de couverture ;
• ISBN qui contient le code à barre du livre lié à son numéro ISBN.

À chaque fois que la couverture est générée, le contenu de ces champs est modifié dans le fichier .sla en fonction des données fournies dans le fichier .tex.

Génération

Un fichier Makefile est fourni à titre de modèle pour votre projet de livre. Il se trouve, avec un exemple, dans le répertoire exemple. Ce fichier doit être copié dans le répertoire contenant les sources du projet, puis adapté en modifiant les variables qui se trouvent au début du fichier :

• BASENAME doit contenir la « racine » du nom du projet ; c'est le nom, hors extension, de tous les fichiers concernant le projet (fichier .tex et .sla, ainsi que fichiers générés) ;
• LATEXFILES contient le chemin vers le répertoire contenant les fichiers de livrelitt ;
• COVERRES doit contenir, en points par pouce, la résolution de l'image qui sera extraite de la couverture papier pour être insérée dans le livre numérique ;
• COVERCUT contient la taille, en millimètres, de la partie de couverture qui doit être coupée (fond perdu, traits de coupe, etc.)

Il est également possible de spécifier des polices de caractères qui seront intégrées dans le livre électronique. Ces polices doivent être installées sur l'ordinateur servant à générer le livre.

• FONT_SERIF est la police de caractères utilisée par défaut ;
• FONT_CURSIVE est la police de caractères utilisée pour l'écriture cursive.

Les valeurs fournies ici seront directement utilisées dans le fichier .css généré. Il est donc également possible d'y indiquer une taille. Exemple :

FONT_CURSIVE=My Own Handwriting; font-size: 120%

Lorsque le fichier Makefile est prêt, vous pouvez utiliser, si l'outil Make est installé sur votre poste (c'est le cas sur la plupart des distributions Linux) :

• make sans argument, qui exécutera par défaut la cible all et générera la couverture et l'intérieur du livre papier, la version brouillon et la version numérique du livre ;
• make draft pour générer la version brouillon (mode révision) du livre ;
• make print pour générer la couverture et l'intérieur du livre papier ;
• make ebook pour générer le livre numérique ;
• make clean pour supprimer les fichiers intermédiaires ;
• make mrproper pour faire le ménage et supprimer tous les fichiers générés.

Bien sûr, vous pouvez également appeler make pour générer n'importe quel fichier, définitif ou intermédiaire, selon votre désir…

À faire

• Générer automatiquement le code barre pour la couverture.
• Gérer les guillemets en les rendant actifs pour autoriser les espaces insécables.