title	date	id	tags
Citation et bibliographie avec LaTeX	2023-03-21T10:22:47+01:00	20230321102247	README documentation latex rdv-info

Citation et bibliographie avec LaTeX

Ce répertoire contient les sources pour le Rendez-vous de l'info sur les citations et les références bibliographiques avec LaTeX. Il contient :

• La source en markdown pour le support de cours.
• Des exemples de fichiers .tex.
• Un export de collection Zotero au format biblatex.

Le support de cours au format PDF ainsi que les fichiers d'exercice peuvent être téléchargés dans les publications de version.

Pour démarrer

Pour pouvoir utiliser ce projet, il est nécessaire :

1. De cloner le projet :
   git clone https://git.milhit.ch/igor/biblatex-zotero.git
2. D'activer le module pour reveal.js pour la présentation au format HTML :

   git submodule init
   git submodule update
   

3. Pour générer les différents fichiers, deux outils sont nécessaire :
   1. pandoc. Pour installer pandoc, voir la documentation.
   2. Une distribution \LaTeX. Une possibilité est de consulter le site web The \LaTeX project qui décline les méthodes les plus habituelles pour les principaux systèmes d'exploitation. Pour ma part, je recommande l'usage de tectonic qui est un binaire à installer : voir comment installer tectonic.

Convertir le support de cours en PDF

Avec LaTeX

Pour convertir le support de cours (polycopié.md) au format PDF, il faut utiliser la commande suivante :

pandoc --citeproc --to=pdf --pdf-engine=tectonic \
       --output=public/polycopié.pdf \
       source/polycopié/polycopié.md

• --citeproc traite les citations et génère la bibliographie.
• --to=pdf détermine le format de sortie, ici PDF.
• --pdf-engine définit le moteur de compilation a utiliser pour produire le PDF, ici tectonic, mais xelatex devrait fonctionner aussi, si il est installé.
• --output= spécifie le chemin et le nom du fichier généré.

Avec paged.js

Avec cet outil, il est possible de définir les styles des éléments dans le PDF au moyen de règles CSS (voir paged.js). Pour pouvoir l'utiliser, il faut avoir installé sur sa machine les paquets npm suivants :

npm install -g puppeteer pagedjs pagedjs-cli

Puis, on peut soit produire directement un PDF :

pandoc --standalone --embed-resource --citeproc \
       --to pdf --pdf-engine=pagedjs-cli \
       --css=source/polycopié/polycopié.css \
       --output=public/polycopié.pdf source/polycopié/polycopié.md

Pour obtenir un fichier HTML, qui peut être ensuite imprimé au format PDF :

cd sources/polycopié/
pandoc --citeproc --to=html \
       --template=template.html --css=polycopié.css \
       --output=polycopié.html polycopié.md

Puis, lancer un server web local, par exemple avec python -m http.server et charger le fichier polycopié.html dans un navigateur web.

Déroulé de la présentation

Le fichier déroulé.md décrit le déroulé de la présentation. Si une impression est nécessaire, on peut soit utiliser le rendu HTML d'un éditeur, soit le convertir au format désiré puis l'imprimer.

Pour le HTML :

pandoc -t html5 -s -o déroulé.html déroulé.md

Pour le PDF :

pandoc -t pdf --pdf-engine=tectonic -o déroulé.pdf déroulé.md

Support de présentation

⚠ Il n'y a pas encore de support de présentation. Le fichier est là à titre d'essai pour l'instant.

Convertir la présentation au format PDF

Pour obtenir la présentation au format PDF, il faut utiliser la commande suivante :

pandoc -t beamer -V theme=AnnArbor \
       -V colortheme=sidebartab presentation.md -o presentation.pdf

• -t beamer définit le format de présentation beamer.
• -V theme=Hannover permet de passer en variable (-V) le theme beamer désiré.
• -V colortheme=sidebartab définit le thème de couleur.

Une galerie des thèmes et des thèmes de couleurs est disponible en ligne : https://deic.uab.cat/~iblanes/beamer_gallery/.

Il peut être nécessaire de définir l'installation de \LaTeX, par exemple pour tectonic :

pandoc -t beamer -V theme=AnnArbor -V colortheme=sidebartab \
       --pdf-engine=tectonic presentation.md -o presentation.pdf

Pour convertir la présentation au format HTML (reveal.js)

Il faut s'assurer que pandoc soit installé et que le submodule reveal.js soit bien activé. Puis, il suffit de taper la commande suivante :

pandoc -t revealjs --self-contained -o presentation.html presentation.md

• -t revealjs définit le format de présentation reveal.js.
• --self-contained assure que tous les fichiers nécessaires à la présentation seront bien contenu dans un seul fichier HTML.