Différents modèles avec rst & latex
Clone et installation
git clone http://git.chimrod.com/latex_template.git/
Pré-requis
La compilation des fichiers en PDF requiert python et docutils. Il faut bien sûr latex pour générer le pdf.
Les dépendances nécessaire peuvent être installées avec la commande suivante :
sudo apt install git make docutils texlive texlive-latex-extra \ texlive-lang-french texlive-fonts-extra texlive-lualatex
compilation
Tous les modèles peuvent être générés en une seule commande en lançant make dans le répertoire principal.
Organisation
Chaque répertoire contient un style de document. La commande make permet de générer le fichier PDF à partir du fichier source.
Pour réutiliser un modèle, il suffit de créer ces lignes dans un fichier Makefile :
MODEL = ../model_7 # Chemin vers le modèle à utiliser include $(MODEL)/../common/Makefile.common
et de créer un document texte avec l’extension .rst. La commande make va lancer la compilation du fichier en pdf.
Personalisation
Les règles de basent peuvent être personalisées en fonction des besoins.
Chaque fichier de style présent dans le répertoire du modèle peut être surchargé par un fichier de style de même nom présent dans le répertoire courant du modèle.
EXTRA_RST_OPTIONS: | |
---|---|
Cette option va donner des directives supplémentaires au compilateur rst2latex Exemple : EXTRA_RST_OPTIONS = \ --table-style=booktabs |
|
EXTRA_STYLES: | Cette option permet d’ajouter des styles supplémentaires qui sont appliqués sur le document généré. EXTRA_STYLES = fontsize\ |
FILTERS: | Cette option permet de lister les modules présents dans le modèle de base et ne devant pas être chargé. (En vue de les surcharger par exemple). FILTERS = %10_geometry.tex \ %10_title_style.tex \ %00_colors.tex \ |
Exemples
Les images ci-dessous sont construites à partir des fichiers exemples :
Model 1
Model 7
Modèle utilisé pour un mariage
Commandes fournies par ce modèle :
pageornament: | Commande appliquée en fond de page sur chaque page. Elle prend trois arguments :
|
---|---|
altColor: | la couleur altColor est utilisée pour le titre principal du document, les décoration de page, ainsi que les lignes encadrant les titres de chapitre. Valeur par défaut lightgray |
Model 8
La syntaxe
La colonne latérale
Le code suivant permet de créer une section dans la colonne :
.. sidebar:: Informations * 17 allée des cerisiers * 75001 Paris * 01 23 45 67 89 * email@example * 01/02/1980 * Permis B
Les graphiques
La ligne suivante introduit les étoiles colorées en fonction du niveau (jusque 5)
:star:`4.5`
La commande level l'affiche sous la forme d'une petite barre :
:level:`3`