Ce répertoire contient les sources pour le Rendez-vous de l'info sur les citations et les références bibliographiques avec LaTeX.
 
 
 
 
Go to file
iGor milhit f66b54aee1
policopié: améliore le policopié après le cours
- 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>
2024-03-07 15:45:35 +01:00
exercice policopié: améliore le policopié après le cours 2024-03-07 15:45:35 +01:00
sources policopié: améliore le policopié après le cours 2024-03-07 15:45:35 +01:00
.gitignore policopié: améliore le policopié après le cours 2024-03-07 15:45:35 +01:00
.gitmodules policopié: améliore le policopié après le cours 2024-03-07 15:45:35 +01:00
LICENSE documentation: ajoute la licence CC BY-SA 4.0 2023-03-30 14:49:29 +02:00
README.md policopié: améliore le policopié après le cours 2024-03-07 15:45:35 +01:00
déroulé.md documentation: déroule la présentation 2023-03-30 08:48:22 +02:00

README.md

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 (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:

  1. De cloner le projet:
    git clone https://git.milhit.ch/igor/biblatex-zotero.git
  2. Pour générer les différents fichiers, les outils suivants sont nécessaires:
    1. Soit pagedjs. Pour installer pagedjs : \ npm install -g puppeteer pagedjs pagedjs-cli.
    2. Soit pandoc et LaTex. Pour installer pandoc, 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 de tectonic qui est un binaire à installer: voir comment installer tectonic.

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, ici tectonic, mais xelatex 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