iGor milhit
f66b54aee1
- Ignore certains fichiers temporaires (html) et les générations en PDF. - Documnente les règles CSS les moins évidentes ou celles pour lesquels des points d'attention sont nécessaires. - Ajoute des règles pour éviter que les exemples de codes ou les figures ne soient séparées sur deux pages. - Supprime la tables des matières manuelle dans la source au format markdown et ajoute des règles CSS pour mettre en forme la table des matières générée par pandoc, avec une numérotation des chapitres. - Adapte la documentation pour l'utilisation de ce projet, afin qu'elle soit plus en accord avec ce qui est réellement possible. Co-Authored-by: iGor milhit <igor@milhit.ch> |
||
---|---|---|
exercice | ||
sources | ||
.gitignore | ||
.gitmodules | ||
LICENSE | ||
README.md | ||
déroulé.md |
README.md
title | date | id | tags | ||||
---|---|---|---|---|---|---|---|
Citation et bibliographie avec LaTeX | 2023-03-21T10:22:47+01:00 | 20230321102247 |
|
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 (
sources/policopié/
). - Des exemples de fichiers
.tex
(exercice/exercice.tex
). - Un export de collection Zotero au format biblatex
(
exercice/references-exercices.bib
).
Le support de cours au format PDF ainsi que les fichiers d'exercice peuvent être téléchargés dans les publications de version.
Prérequis
Pour pouvoir utiliser ce projet, il est nécessaire :
- De cloner le projet :
git clone https://git.milhit.ch/igor/biblatex-zotero.git
- Pour générer les différents fichiers, les outils suivants sont nécessaires :
- Soit
pagedjs
. Pour installerpagedjs
: \npm install -g puppeteer pagedjs pagedjs-cli
. - Soit
pandoc
et LaTex. Pour installerpandoc
, voir la documentation. Pour la 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 detectonic
qui est un binaire à installer : voir comment installer tectonic.
- Soit
Convertir le support de cours en PDF
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). Dans le dossier
sources/polycopié/
se trouvent un template.html
utilisé par pandoc
pour
produire un fichier HTML avec les classes et les identifiants désirés. Le
fichier polycopié.css
contient pour sa part la mise en forme permettant
d'obtenir un fichier suivant en bonne partie la charte de l'UNIGE.
Pour pouvoir utiliser pagedjs
, il faut avoir installé sur sa machine les
paquets npm
suivants :
npm install -g puppeteer pagedjs pagedjs-cli
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 depuis la racine du projet, par exemple avec
python -m http.server
et charger le fichier polycopié.html
dans un
navigateur web, de préférence Chromium (ou Google Chrome), car la gestion des
liens est mieux supportée.
Avec LaTeX
L'usage de LaTeX suppose une distribution LaTeX. Le résultat obtenu n'est pas adapté à la charte de l'UNIGE.
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, icitectonic
, maisxelatex
devrait fonctionner aussi, si il est installé.--output=
spécifie le chemin et le nom du fichier généré.
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