projet: mets à jour pour le printemps 2026

- Restructure le projet selon ma nouvelle façon de travailler pour les
  documents avec `pagedjs`.
- Adapte le polycopié à la nouvelle structure.
- Mets à jour les fichiers du modèle (`v1.0.1`).
- Améliore le style (appel de citation et logos).
- Ajoute le Makefile depuis le modèle.
- Documente l'usage du Makefile.
- Mets à jour les fichiers des références bibliographiques (.bib et
  .ris).
- Ajoute un exemple avec un fichier Markdown pour montrer que la même
  logique s'applique dans plusieurs contexte.
- TODO: Simplifier la documentation sur la génération des fichiers.
- TODO: Remplacer TeXmaker par TeXstudio, plus moderne.

Co-Authored-by: iGor milhit <igor@milhit.ch>

.gitignore

@@ -1,6 +1,6 @@
 *.pdf
-polycopié.html
+*.html
-test.html
+!template.html
 watched-files.txt
 public/
 *.bib

Makefile

@@ -0,0 +1,61 @@
+SOURCE_FOLDER := sources
+OUTPUT_FILENAME := document
+
+TEMPLATE_REPOSITORY := https://git.milhit.ch/igor/bunige-pagedjs-template/releases/download
+
+# Liste les fichiers sources.
+MD_UNSORTED := $(wildcard $(SOURCE_FOLDER)/*.md)
+# Ordonne les fichiers sources sur la base du début numérique du nom des
+# fichiers.
+MD_SORTED := $(shell printf '%s\n' $(MD_UNSORTED) | sort -t- -k1,1n)
+
+.PHONY: all
+all: pdf
+
+# Construit le fichier HTML.
+.PHONY: html 
+html: $(MD_SORTED)
+	pandoc \
+	--to=html --standalone \
+	--template=static/template.html --css=static/style.css \
+	-V static='./static' \
+	--citeproc \
+	--bibliography=./static/references.json --csl=./static/heg-iso-690.csl \
+	--toc --toc-depth=2 \
+	--out=$(OUTPUT_FILENAME).html $(MD_SORTED)
+
+# Construit le fichier PDF.
+.PHONY: pdf 
+pdf: $(MD_SORTED)
+	pandoc \
+	--to=pdf --pdf-engine=pagedjs-cli --embed-resources=true \
+	--template=static/template.html --css=static/style.css \
+	-V noscript=true -V static='./static' \
+	--citeproc \
+	--bibliography=./static/references.json --csl=./static/heg-iso-690.csl \
+	--toc --toc-depth=2 \
+	--out=$(OUTPUT_FILENAME).pdf $(MD_SORTED)
+
+# Reconstruit le fichier HTML à la modification des autres fichiers.
+.PHONY: watch
+watch:
+	watchexec -r -w . -i document.html \
+	-- make html
+
+# Supprime les fichiers construits lorsqu'ils ne sont plus nécessaire.
+.PHONY: clean
+clean:
+	rm -f *.html *.pdf
+
+# Lance un serveur web pour servir le HTML.
+.PHONY: serve
+serve:
+	watchexec -r -w . "python -m http.server"
+
+# Mets à jour le modèle de document
+# Usage : make update VERSION=v1.0.0
+.PHONY: update
+update:
+	curl -o modèle.zip $(TEMPLATE_REPOSITORY)/$(VERSION)/$(VERSION).zip
+	unzip -f -o modèle.zip
+	rm modèle.zip

README.md

@@ -2,12 +2,12 @@
 title: Citation et bibliographie avec LaTeX
 date: 2023-03-21T10:22:47+01:00
 id: 20230321102247
-tags: [README, documentation, latex, rdv-info]
+tags: ["README", "documentation", "latex", "rdv-info"]
 ---
 
 ## [Citation et bibliographie avec LaTeX][1]
 
-Ce répertoire contient les sources pour le *Rendez-vous de l'info* sur les
+Ce répertoire contient les sources pour le [*Rendez-vous de l'info*][8] sur les
 citations et les références bibliographiques avec LaTeX. Il contient :
 
 - La source en markdown pour le support de cours (`sources/`).
@@ -119,6 +119,25 @@ Pour le PDF :
 pandoc -t pdf --pdf-engine=tectonic -o déroulé.pdf déroulé.md
 ```
 
+## Makefile
+
+Dépendances :
+
+- `pandoc`.
+- `watchexec`.
+- `gnu-make`.
+- `python`.
+
+Le projet contient un Makefile avec les commandes suivantes :
+
+- `make` : construit le PDF à partir des fichiers `.md` du dossier `sources`.
+- `make html` : construit le HTML (sur la base des mêmes fichiers) pour
+  prévisualiser le résultat dans un navigateur.
+- `make watch` : construit le HTML à chaque fois qu'un fichier dans le
+  répertoire est modifié.
+- `make serve` : lance un serveur web local dans le répertoire courant (avec le
+  module pour python) sur le port 8000.
+
 <!-- références -->
 [1]: ./
 [2]: https://git.milhit.ch/igor/biblatex-zotero/releases/latest
@@ -127,3 +146,4 @@ pandoc -t pdf --pdf-engine=tectonic -o déroulé.pdf déroulé.md
 [5]: https://tectonic-typesetting.github.io/en-US/install.html
 [6]: https://pagedjs.org/
 [7]: ./déroulé
+[8]: https://www.unige.ch/biblio/index.php?cID=3844

déroulé.md

@@ -38,8 +38,9 @@ tags: [latex, déroulé, rdv-info]
 ### Exercice
 
 1. Proposer d'importer `references-exercice.ris`.
-1. Export Zotero.
+1. Export Zotero « classique ».
-1. Better BibTeX. Exporter et montrer la liste des exportations.
+1. Better BibTeX. Exporter au format BibLaTeX et montrer la liste des
+   exportations.
 1. Ouvrir le fichier `exercice.tex` avec Texmaker.
 1. Montrer :
     1. Commentaires, dont l'insertion de la bibliographie.
@@ -50,19 +51,22 @@ tags: [latex, déroulé, rdv-info]
 1. Montrer comment configurer la compilation dans Texmaker.
     1. `biber %` pour BibLaTeX.
     1. Compilation rapide avec :
-        1. Soit préconfiguration PdfLaTeX, Biber, PdfLaTeX 2x et affichage du
+        1. Soit préconfiguration PdfLaTeX, Biber, 2x PdfLaTeX et affichage du
-           PDF.
+           PDF (ne fonctionne pas avec `polyglossia` et `fontenc`).
-        1. Soit, avec l'assistant XeLaTeX, Biber, XeLaTeX 2x et affichage du
+        1. Soit, avec l'assistant XeLaTeX, Biber, 2x XeLaTeX et affichage du
            PDF.
 1. Compiler le fichier tel quel.
 1. **Laisser faire.**
 1. Montrer les fichiers auxiliaires.
 1. Montrer qu'on peut les supprimer avec *Outils / nettoyer* dans Texmaker.
-1. Ajouter un appel à citation simple (`\cite`), décommenter l'insertion de la
+1. Ajouter un appel à citation simple (`\cite{}`), décommenter :
-   bibliographie.
+    - Le chargement du package BibLaTeX avec les options.
+    - L'insertion de la bibliographie.
 1. Compiler et **Laisser faire.**
-1. Changer le `\cite` en `\autocite`.
+1. Montrer qu'on peut changer les options de `hyperref`, par exemple
-1. Essayer d'autres commandes de citation via la cheatsheet.
+   `[colorlinks=true]` ou `[colorlinks=true, citecolor=red]`
+1. Changer le `\cite{}` en `\autocite{}`.
+1. Essayer d'autres commandes de citation via l'aide mémoire.
     1. Ajouter des options à `\autocite` et souligner que les deux options
        doivent être affichées :
        `\autocite[voir][]{bohemierBibTeXNatbibBiblatex}`.
@@ -75,3 +79,4 @@ tags: [latex, déroulé, rdv-info]
 1. Passer à un style `numeric`, `apa`, `vancouver`. Signaler qu'il faudra
    peut-être installer un style. Mentionner le topic biblatex.
 1. Compiler et **Laisser faire.**
+1. Montrer l'exemple avec le fichier Markdown si le temps le permet.

exercice/exercice.md

@@ -0,0 +1,54 @@
+---
+title: Notre pseudo-article
+date: Printemps 2026
+creation_date: 2026-03-13T12:04:37+0100
+id: 20260313120437
+lang: fr
+tags: ["biblatex", "zotero", "better bibtex"]
+author:
+  - "Vincent Huber"
+  - "Igor Milhit"
+bibliography: ./references-exercice.bib
+pdf-engine: xelatex
+link-citations: true
+colorlinks: true
+---
+
+## Introduction
+
+Dans ce pseudo-travail, nous prétendons introduire notre sujet, comme la
+littérature le conseille généralement [@bohemier_bibtex_nodate].
+
+Une bonne introduction annonce aux lecteurs et lectrices un certain
+nombre d'éléments indispensables au sujet de l'article qu'elles et ils vont
+lire, comme le suggèrent @bosma_code-switching_2019 et @sauvayre_les_2013.
+
+## Première partie
+
+Dans *cette première partie*, nous pouvons insérer une "citation en
+ligne" et le bloc de citation suivante :
+
+> The results showed that different reference managers require different
+> levels of effort, and users generally prefer the tools that involve
+> less effort. We also found that although reference managers share
+> similar features, differences in presentation and organization matter.
+> We conclude this work by providing a set of guidelines for both users and
+> developers of reference managers [@cai_what_2021].
+
+## Et les maths ?
+
+L'équation de la relativité restreinte est :
+
+$$
+E = mc^2
+$$
+
+Une équation plus complexe, comme la distribution normale :
+
+$$
+f(x) = \frac{1}{\sigma\sqrt{2\pi}} e^{-\frac{1}{2}\left(\frac{x-\mu}{\sigma}\right)^2}
+$$
+
+\newpage
+
+## Références

exercice/references-exercice.bib

@@ -1,16 +1,17 @@
-@online{bohemierBibTeXNatbibBiblatex,
+@online{bohemier_bibtex_nodate,
-  title = {{{BibTeX}}, Natbib, Biblatex: {{Managing}} Citations in {{LaTeX}}: {{BibTeX}} and Natbib.},
+  title = {{{BibTeX}}, Natbib, Biblatex: {{Managing}} Citations in {{LaTeX}}},
   shorttitle = {Yale University Library Research Guides},
   author = {Bohemier, Kayleigh},
-  url = {https://guides.library.yale.edu/bibtex/bibtex-natbib},
+  location = {New Haven, CT},
-  urldate = {2022-05-17},
+  url = {https://guides.library.yale.edu/bibtex},
+  urldate = {2026-03-13},
   abstract = {A short guide linking to documentation, resources for bibliographic citation styles, and other useful tools to use when citing sources using .bib files and associated packages.},
   langid = {english},
-  organization = {{Yale University Library Research Guides}},
+  organization = {Yale University Library Research Guides},
-  keywords = {biblatex-zotero-exercice,cmu,non lu}
+  keywords = {biblatex-zotero-exercice,cmu}
 }
 
-@article{bosmaCodeswitchingAsymmetryBilingual2019,
+@article{bosma_code-switching_2019,
   title = {A Code-Switching Asymmetry in Bilingual Children: {{Code-switching}} from {{Dutch}} to {{Frisian}} Requires More Cognitive Control than Code-Switching from {{Frisian}} to {{Dutch}}},
   author = {Bosma, Evelyn and Blom, Elma},
   date = {2019-12},
@@ -25,14 +26,14 @@
   keywords = {biblatex-zotero-exercice,cmu,non lu}
 }
 
-@inproceedings{caiWhatMakesGood2021,
+@inproceedings{cai_what_2021,
   title = {What Makes {{A}} Good Reference Manager? {{A}} Quantitative Analysis of Bibliography Management Applications},
   shorttitle = {What Makes {{A}} Good Reference Manager?},
   booktitle = {Asian {{CHI}} Symposium 2021},
   author = {Cai, Tongan and Chen, Chacha and Huang, Ting-Hao and Ritter, Frank E},
   date = {2021-05-08},
   pages = {64--69},
-  publisher = {{ACM}},
+  publisher = {ACM},
   doi = {10.1145/3429360.3468183},
   url = {https://dl.acm.org/doi/10.1145/3429360.3468183},
   urldate = {2022-07-21},
@@ -41,27 +42,27 @@
   keywords = {biblatex-zotero-exercice,cmu,non lu}
 }
 
-@book{sauvayreMethodesEntretienSciences2013,
+@book{sauvayre_les_2013,
   title = {Les Méthodes de l'entretien En Sciences Sociales},
   author = {Sauvayre, Romy},
   date = {2013},
   series = {Psycho Sup. {{Psychologie}} Sociale},
-  publisher = {{Dunod}},
+  publisher = {Dunod},
-  location = {{Paris}},
+  location = {Paris},
   isbn = {978-2-10-057970-9},
   pagetotal = {138},
   keywords = {biblatex-zotero-exercice,cmu,Enquêtes sociologiques,Entretiens,non lu,Sociologie}
 }
 
-@incollection{slaweckiParadigmsQualitativeResearch2018,
+@incollection{slawecki_paradigms_2018,
   title = {Paradigms in Qualitative Research},
   booktitle = {Qualitative Methodologies in Organization Studies},
   author = {Sławecki, Bartosz},
   editor = {Ciesielska, Malgorzata and Jemielniak, Dariusz},
   date = {2018},
   pages = {7--26},
-  publisher = {{Springer International Publishing}},
+  publisher = {Springer International Publishing},
-  location = {{Cham}},
+  location = {Cham},
   url = {http://link.springer.com/10.1007/978-3-319-65217-7_2},
   urldate = {2022-11-08},
   isbn = {978-3-319-65217-7},

exercice/references-exercice.ris

@@ -3,13 +3,13 @@ TI  - BibTeX, natbib, biblatex: Managing citations in LaTeX
 AU  - Bohemier, Kayleigh
 T2  - Yale University Library Research Guides
 AB  - A short guide linking to documentation, resources for bibliographic citation styles, and other useful tools to use when citing sources using .bib files and associated packages.
-LA  - eng
+CY  - New Haven, CT
+LA  - en
 ST  - Yale university library research guides
 UR  - https://guides.library.yale.edu/bibtex
-Y2  - 2022/05/17/
+Y2  - 2026/03/13/
-KW  - cmu
-KW  - non lu
 KW  - biblatex-zotero-exercice
+KW  - cmu
 ER  - 
 
 TY  - CONF

sources/polycopié.md

@@ -1,14 +1,14 @@
 ---
 title: "Citer ses références et créer une bibliographie avec LaTeX et Zotero"
-date: Printemps 2025
+date: Printemps 2026
 creation_date: 2023-03-24T08:25:47+0100
 id: 20230324082557
 logo:
-  - ./static/latex-logo.svg
+  - ./static/images/latex-logo.svg
-  - ./static/zotero-logo.png
+  - ./static/images/zotero-logo.png
 lang: fr
-bibliography: references.json
+bibliography: ./static/references.json
-csl: heg-iso-690.csl
+csl: ./static/heg-iso-690.csl
 nocite: '@*'
 link-citations: true
 ---
@@ -34,7 +34,7 @@ Au terme de cet atelier, vous serez en mesure de :
 
 <!-- références -->
 
-[1]: ./static/by-sa.svg
+[1]: ./static/images/by-sa.svg
 [2]: https://creativecommons.org/licenses/by-sa/4.0/deed.fr "Texte de la licence en français"
 [3]: https://git.milhit.ch/igor/biblatex-zotero "Projet git du document"
 
@@ -45,30 +45,31 @@ Au terme de cet atelier, vous serez en mesure de :
 
 Pour générer des documents avec LaTeX, il faut :
 
-- Rédiger un document dans un fichier `.tex` à l'aide du *langage de balisage*,
+- Rédiger un document structuré à l'aide du *langage de balisage* LaTeX, dans
-  afin de le structurer.
+  un fichier `.tex`.
 - Compiler ce fichier avec un *système (ou moteur) de composition*, par exemple
   LaTeX, PdfLaTeX ou XeLaTeX.
 
 Pour disposer d'un tel système de composition, le plus souvent on installe un
 *environnement ou une distribution* LaTeX, par exemple TeX Live pour Linux,
 MacTex pour Mac OS ou MiKTeX pour Windows[^0]. Il est aussi possible
-d'installer des distributions plus minimales, comme `tectonic` ou TinyTeX[^6].
+d'installer des distributions plus minimales, comme Tectonic ou TinyTeX[^6].
 
-Afin de faciliter la collaboration ou pour s'éviter une installation parfois
+Afin de faciliter la collaboration ou pour s'éviter une installation
-laborieuse, des services en ligne sont préférés, comme
+laborieuse, des services en ligne peuvent être préférés, comme
 <https://www.overleaf.com/>.
 
-Enfin, un éditeur est nécessaire pour travailler sur les sources (le ou les
+Enfin, un éditeur est nécessaire pour modifier les sources (le ou les fichiers
-fichiers `.tex`). N'importe quel éditeur de texte suffit, mais des aides comme
+`.tex`). N'importe quel éditeur de texte suffit, mais des aides comme la
-la coloration syntaxique, la complétion des commandes ou la gestion de la
+coloration syntaxique, la complétion des commandes ou la gestion de la
 compilation autrement que dans une console sont très utiles. Parmi une liste
-plutôt riche, les éditeurs suivants peuvent être mentionnés :
+riche, les éditeurs suivants peuvent être mentionnés :
 
-- Texmaker, libre, multiplatforme, <https://www.xm1math.net/texmaker/>.
+- Texmaker, libre, multiplatforme (Linux, MacOS, Windows),
+  <https://www.xm1math.net/texmaker/>.
 - TeXworks, libre, multiplatforme, <https://www.tug.org/texworks/>.
 - Visual Studio Code, gratuit, multiplatforme,
-  <https://code.visualstudio.com/>, avec les extensions nécessaires.
+  <https://code.visualstudio.com/>, avec les extensions nécessaires[^7].
 
 Afin de pouvoir insérer des citations et créer des bibliographies avec LaTeX,
 un fichier contenant les références bibliographiques est nécessaire. Il s'agit
@@ -86,6 +87,9 @@ préciser son chemin dans le fichier `.tex`.
 [^0]: Voir le site <https://www.latex-project.org/get/>.
 [^6]: Voir le site <https://tectonic-typesetting.github.io> ou
     le site <https://yihui.org/tinytex/>.
+[^7]: Par exemple *LaTeX Workshop*.
+<https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop>.
+
 
 ### BibTeX VS BibLaTeX {#bibtex-vs-biblatex .newpage}
 
@@ -130,10 +134,10 @@ Les lignes suivantes correspondent aux champs de la référence, sous la forme
 `champ = {valeur}`, séparées par une virgule.
 
 La documentation BibLaTeX détaille l'ensemble des types et des champs
-[@lehmanBiblatexPackageProgrammable2023, p. 7]. Une *cheatsheet* les liste
+[@lehmanBiblatexPackageProgrammable2023, p. 7]. Un aide-mémoire les liste
 également [voir @reesBibLaTeXBiberCheat2017].
 
-Il est possible de créer et de mettre à jour un fichier `.bib` à la main, à
+Il est possible de créer et de mettre à jour un fichier `.bib` « à la main », à
 l'aide d'un éditeur de texte. Un grand nombre de bases de données, de sites de
 revues ou de catalogues de bibliothèques permettent de télécharger une ou
 plusieurs références dans un fichier `.bib`, mais le plus souvent dans la
@@ -163,10 +167,10 @@ Il suffit de :
 - Faire un clic-droit et sélectionner *Exporter la collection / les documents*.
 - Choisir le format BibTeX ou BibLaTeX.[^3]
 
-Ce procédé très simple a néanmoins un inconvénient : le fichier créé est
+Ce procédé très simple a un inconvénient : le fichier créé est **statique**. Il
-statique. Il ne sera pas mis à jour automatiquement si la collection est
+ne sera pas à jour si la collection est complétée, ou si les références sont
-complétée, ou si les références sont corrigées dans Zotero. Il faudra générer à
+corrigées dans Zotero. Il faudra générer à nouveau et écraser le fichier `.bib`
-nouveau et écraser le fichier `.bib` pour qu'il soit à jour.
+pour qu'il soit à jour.
 
 [^3]: Il est également possible d'exporter une bibliothèque au format
     BibTeX depuis d'autres logiciels bibliographiques, notamment
@@ -178,18 +182,25 @@ nouveau et écraser le fichier `.bib` pour qu'il soit à jour.
 
 ### L'extension *Better BibTeX for Zotero*
 
+::: {.warning}
+
+Il est fortement conseillé d'utiliser un Zotero à jour (`>= 8`) !
+
+:::
+
 L'extension *Better BibTeX for Zotero* résout deux problèmes des fichiers
 `.bib` générés par Zotero :
 
-1. Elle permet d'exporter **un fichier `.bib` dynamique, c'est-à-dire que le
+1. Elle permet d'exporter un fichier `.bib` **dynamique**, c'est-à-dire que le
-   contenu de celui-ci sera mis à jour automatiquement lorsque la collection
+   contenu de celui-ci sera mis à jour **automatiquement** lorsque les données
-   correspondante dans Zotero sera modifiée**. Pour cela, il faut choisir le
+   correspondantes dans Zotero seront modifiées. Pour cela, il faut choisir le
    format d'exportation *Better BibTeX* ou *Better BibLaTeX* et sélectionner
    l'option *Garder à jour*. (Figure 1) \
 1. Elle permet de **modifier une clé de citation (citekey) manuellement ou de
    créer un format de citekey par défaut.**
 
-![Fenêtre de dialogue de Better BibTex](./static/better-bibtex-a-jour.png)
+![Fenêtre de dialogue de Better
+BibTex](./static/images/better-bibtex-a-jour.png){height=300px}
 
 Pour installer l'extension (au format `.xpi`) *Better BibTeX* :
 
@@ -200,17 +211,28 @@ Pour installer l'extension (au format `.xpi`) *Better BibTeX* :
   from file* (Figure 3).
 - Sélectionner le fichier téléchargé.
 
-![Menu « outils » de Zotero](./static/menu-outils.png)
+![Menu « outils » de Zotero](./static/images/menu-outils.png){height=200px}
 
-![Installer un fichier `.xpi`](./static/install-add-on.png)
+![Installer un fichier `.xpi`](./static/images/install-add-on.png){height=180px}
+
+::: {.warning}
+
+Il existe une extension pour Zotero qui facilite grandement la gestion des
+extensions, leur installation et leur mise à jour : \
+<https://github.com/syt2/zotero-addons>.
+
+:::
 
 ### Autres fonctionnalités de Better BibTeX
 
 *Better BibTeX* propose des fonctionnalités plus avancées :
 
-- Création et gestion de clés uniques.
+- Paramétrage du format des clés de citation.
-- Conversion des caractères UTF-8 et des éventuels balisages HTML
+- Conversion des caractères UTF-8 et des éventuels balisages HTML,
-  présents dans les références.
+  présents dans les références, particulièrement nécessaire avec BibTeX.
+- Paramétrage du comportement de la citation rapide (glisser-déposer une
+  référence depuis Zotero dans votre document) : est-ce que vous voulez obtenir
+  une référence rédigée au format LaTeX, une clé de citation, etc. ?
 - Génération de champs supplémentaires absents de Zotero.
 - Création de types de documents n'existant pas dans Zotero.
 
@@ -222,10 +244,10 @@ Les informations supplémentaires à ce sujet sont disponibles sur le site
 
 Pour générer le fichier PDF à partir des sources `.tex` et `.bib`, il est
 nécessaire de configurer le système de composition que l'on va utiliser. Il
-peut être appelé en ligne de commande dans une console ou, à l'inverse, pris en
+peut être appelé en ligne de commande dans une console ou pris en charge
-charge presque entièrement par une plateforme comme Overleaf. Et entre les
+presque entièrement par une plateforme comme Overleaf. Et entre les deux, des
-deux, des éditeurs de texte dédiés à LaTeX offrent un certain nombre d'options
+éditeurs de texte dédiés à LaTeX offrent un certain nombre d'options de
-de compilation ou de composition.
+compilation ou de composition.
 
 L'exemple donné ci-dessous est adapté à l'exercice et à l'utilisation de
 l'éditeur Texmaker, mais le principe est similaire dans les différents
@@ -239,10 +261,10 @@ Il faut donc lui préciser lequel on utilise :
 1. Dans l'onglet *Commandes*, chercher l'entrée *Bib(la)tex* et entrer
    `biber %` (Figure 4).
 
-![Configuer Biber pour BibLaTeX dans Texmaker](./static/texmaker-biber.png)
+![Configuer Biber pour BibLaTeX dans Texmaker](./static/images/texmaker-biber.png)
 
 Lorsque l'on compile avec des références bibliographiques, il est nécessaire de
-le faire quatre fois :
+le faire quatre fois (cinq étapes avec l'affichage du PDF) :
 
 1. XeLaTeX.
 1. Biber.
@@ -262,12 +284,12 @@ Dans le cas de l'exercice présenté, une bonne solution est d'utiliser XeLaTeX.
 Pour cela, il faut choisir l'option *Utilisateur* et utiliser l'assistant
 (figure 5).
 
-![Assistant de configuration de compil rapide](./static/compil-rapide-assistant.png)
+![Assistant de configuration de compil rapide](./static/images/compil-rapide-assistant.png)
 
 Puis, dans l'assistant, sélectionner les commandes à ajouter, une à une, dans
 l'ordre (figure 6).
 
-![Ajout des commandes dans l'assistant](./static/compil-rapide-liste.png)
+![Ajout des commandes dans l'assistant](./static/images/compil-rapide-liste.png)
 
 Les services web comme Overleaf ou les outils comme `tectonic`[^5] prennent
 eux-mêmes en charge ce genre de complexité.
@@ -278,7 +300,7 @@ fonction de ce qui est indiqué dans le préambule, ce qui évite d'installer un
 distribution de LaTeX volumineuse. À l'exception de Biber qui doit être
 installé sur le système.
 
-## Utilisation de BibLaTeX
+## Utilisation de BibLaTeX {.newpage}
 
 ### Préambule : options de style et lien avec les références {#preambule} 
 
@@ -319,7 +341,7 @@ le placer dans le même répertoire que le fichier `.tex`.
 ### Insérer des citations
 
 Pour insérer des citations, il existe un ensemble de commandes possibles (voir
-la *cheatsheet*), pour les différents cas. La syntaxe est la suivante :
+l'aide-mémoire), pour les différents cas. La syntaxe est la suivante :
 
 ```latex
 \cite[<pre>][<post>]{<key>}
@@ -331,6 +353,8 @@ la *cheatsheet*), pour les différents cas. La syntaxe est la suivante :
   exemple `[voir]` permet d'obtenir `(voir Auteur, date)`.
 - `[<post>]`, optionnel, ajoute du texte après l'appel à citation, comme un
   numérotation de pages.
+- Si on ajoute une option (`pre` ou `post`), il faut toujours ajouter l'autre
+  option, même si on la laisse vide : `\cite[voir][]{citationKey}`.
 - `{<key>}`, obligatoire, est la clé de citation indiquant de quelle référence
   il s'agit. Par exemple `{slaweckiParadigmsQualitativeResearch2018}`.
 
@@ -358,10 +382,9 @@ Elle peut prendre un certain nombre d'options, par exemple :
 Cet exemple définit le titre de la bibliographie. Par défaut, le titre est
 *Références* en français.
 
-À l'aide de la *cheatsheet* ou de la documentation il est possible de
+À l'aide de l'aide-mémoire ou de la documentation il est possible de comprendre
-comprendre comment réaliser une bibliographie pour une section du document, ou
+comment réaliser une bibliographie pour une section du document, ou une
-une bibliographie ne contenant que les références liées à un mot clé
+bibliographie ne contenant que les références liées à un mot clé particulier.
-particulier.
 
 ### Enrichir BibLaTeX
 
@@ -387,4 +410,84 @@ Sous Windows la commande ne prend qu'un tiret pour le paramètre :
 kpsewhich -var-value TEXMFLOCAL
 ```
 
+## LaTeX, mais sans LaTeX ?
+
+Il est possible de produire un document au format PDF avec un rendu identique à
+LaTeX avec un fichier source rédigé non pas avec la syntaxe LaTeX, mais avec
+Markdown[^8]. Il s'agit d'un langage de balisage *léger*, plus simple à
+maîtriser. Surtout, le mécanisme pour les citations et la bibliographie est
+très similaire. C'est pourquoi il en est très brièvement question ici.
+
+Le principe de base est le suivant :
+
+1. La source est un ou plusieurs fichiers texte en Markdown.
+1. La base de donnée des références bibliographiques est également un fichier
+   texte, par exemple au format BibLaTeX (`.bib`) ou CSL Json (`.json`).
+1. Dans les deux cas, *Better BibTeX* est en mesure de le créer (et de le
+   mettre à jour automatiquement).
+1. La conversion de la source en PDF se fait avec Pandoc[^9] (et Pandoc Citeproc
+   qui est intégré à Pandoc).
+1. Pandoc s'appuie sur un moteur pour LaTeX, par exemple XeLaTeX.
+
+Dans le fichier source, pour insérer une citation on peut le faire avec les
+syntaxes suivantes :
+
+- `[@citationKey]`, équivalent à `\parencite{citationKey}`.
+- `[@citationKey1; @citationKey2]`, équivalent à `\parencites{...}`.
+- `@citationKey`, équivalent à `\textcite{citationKey}`.
+
+La bibliographie sera insérée après le dernier titre de section (vide) du
+document.
+
+Pour convertir au format PDF la source, on peut utiliser la commande suivante
+dans un terminal :
+
+```bash
+pandoc --citeproc --bibliography="references.bib" \
+       --pdf-engine="xelatex" \
+       --output="document.pdf" source.md
+```
+
+Cette commande demande au logiciel `pandoc` de convertir le fichier `source.md`
+vers le fichier `document.pdf` (donc au format PDF), en utilisant XeLaTeX, en
+traitant les références bibliographiques (`--citeproc`) sur la base de la liste
+de références du fichier `references.bib`.
+
+Rien n'empêche d'ajouter des configurations et des paramètres. Une solution est
+d'ajouter un « frontmatter » à notre fichier Markdown, autrement dit un entête
+au format YAML pour préciser des métadonnées et des paramètres, un peu comme on
+le ferait avec un préambule pour LaTeX. Par exemple :
+
+```yaml
+title: Notre pseudo-article
+date: Printemps 2026
+lang: fr
+author:
+  - "Auteur 1"
+  - "Auteur 2"
+pdf-engine: xelatex
+bibliography: ./references-exercice.bib
+csl-style: ./vancouver.csl
+link-citations: true
+colorlinks: true
+```
+
+`csl-style` spécifie le style de citation utilisé au moyen d'un fichier CSL, à
+savoir les styles utilisés par Zotero. `link-citations` et `colorlinks`
+indiquent que les appels à citation sont des liens hypertextes, et que les
+liens hypertextes doivent être en couleur.
+
+La commande de conversion peut être simplifiée :
+
+```bash
+pandoc --citeproc --output="document.pdf" source.md
+```
+
+
+
+<!-- références -->
+
+[^8]: <https://commonmark.org/>
+[^9]: <https://pandoc.org>
+
 ## Bibliographie {.newpage}

static/style.css

@@ -28,7 +28,7 @@
          * bibliothèque de l'UNIGE. */
         @top-right {
                 content: "";
-                background-image: url("static/bibliotheque-logo.svg");
+                background-image: url("images/bibliotheque-logo.svg");
                 background-position: right;
                 background-repeat: no-repeat;
                 background-size: 25%;
@@ -81,11 +81,11 @@
     .logo {
         display: inline-flex;
         justify-content: center;
-        /* width: 60%; */
+        width: 60%;
         margin: 2em auto 1em auto;
     }
     .logo img {
-        max-width: 50%;
+        max-height: 7rem;
         padding: .5em;
     }
 
@@ -178,6 +178,10 @@
         text-decoration: none;
         padding-left: 2px;
     }
+    .footnote-ref sup {
+        vertical-align: text-top;
+        font-size: smaller;
+    }
     .footnote-back {
         font-size: small;
         text-decoration: none;
@@ -196,6 +200,7 @@
     figure img {
         max-width: 85%;
         margin: 0 auto;
+        max-height: 35vh;
     }
     figcaption {
         text-align: center;
@@ -207,13 +212,28 @@
         content: "Figure " counter(figureNumber) " : ";
     }
 
-    .exercise {
+    .exercise,
+    .warning {
         background-color: #f2f1f1;
         width: 90%;
         margin: 0 auto;
         border: 2px solid #d80669;
         border-radius: .5em;
-        padding: 0 .5em;
+        padding: .5em;
+        display: flex;
+        align-items: center;
+    }
+
+    .exercice > p,
+    .warning > p {
+        margin: 0;
+        padding-left: .5em;
+    }
+
+    .exercice::before,
+    .warning::before {
+        content: "⚠️";
+        font-size: larger;
     }
 
     blockquote {

static/template.html

@@ -31,9 +31,9 @@ $endfor$
      when they are unnecessary. -->
 $if(noscript)$
 $else$
-  <link href="/interface.css" rel="stylesheet" type="text/css" />
+  <link href="$static$/interface.css" rel="stylesheet" type="text/css" />
-  <script src="/paged.polyfill.js"></script>
+  <script src="$static$/paged.polyfill.js"></script>
-  <script src="/reload-in-place.js"></script>
+  <script src="$static$/reload-in-place.js"></script>
 $endif$
 $for(header-includes)$
   $header-includes$