diff --git a/_extensions/linogaliana/rev-history/rev-history.lua b/_extensions/linogaliana/rev-history/rev-history.lua
index 20f9269c36..01c046181b 100644
--- a/_extensions/linogaliana/rev-history/rev-history.lua
+++ b/_extensions/linogaliana/rev-history/rev-history.lua
@@ -33,10 +33,13 @@ return {
-- return as string
if tags ~= nil then
+ -- "-citations": un message de commit contenant "@user" ne doit pas
+ -- être lu comme une clé bibliographique (erreur fatale en Typst)
return pandoc.read(
"" ..
header .. divider .. tags ..
- "
\n\n"
+ "\n\n",
+ "markdown-citations"
).blocks
else
return pandoc.Null()
diff --git a/_quarto-prod.yml b/_quarto-prod.yml
index b3642acbc6..52a2b1a9c9 100644
--- a/_quarto-prod.yml
+++ b/_quarto-prod.yml
@@ -92,6 +92,11 @@ website:
format:
html:
+ # gitlink ne sert qu'au HTML (widget): en Typst il plante sur `bibliography`
+ # (pandoc.utils.references lit un nom de fichier vide)
+ filters:
+ - path: gitlink
+ at: post-quarto
include-after-body: build/js/mac.html
respect-user-color-scheme: true
theme:
@@ -108,6 +113,26 @@ format:
mainfont: "Open Sans"
monofont: "JetBrains Mono"
linestretch: 1.65
+ typst:
+ # Mise en forme des chapitres en PDF: voir styles/typst/README.md
+ font-paths:
+ - fonts
+ - _extensions/quarto-ext/fontawesome/assets/webfonts
+ papersize: a4
+ fontsize: 10.5pt
+ toc: true
+ toc-depth: 2
+ linkcolor: "#447099"
+ highlight-style: atom-one-dark
+ date-format: long
+ filters:
+ - styles/typst/inline-code.lua
+ template-partials:
+ - styles/typst/typst-template.typ
+ - styles/typst/typst-show.typ
+ - styles/typst/page.typ
+ include-in-header:
+ - styles/typst/style.typ
ipynb: default
@@ -124,8 +149,6 @@ filters:
- build/replace-title.lua
- _extensions/linogaliana/details-iframe/details.lua
- _extensions/linogaliana/lang-switch/button.lua
- - path: gitlink
- at: post-quarto
extensions:
gitlink:
enabled: false
diff --git a/_quarto-test.yml b/_quarto-test.yml
index 170853733e..839fe277a8 100644
--- a/_quarto-test.yml
+++ b/_quarto-test.yml
@@ -68,6 +68,26 @@ format:
code-overflow: wrap
include-in-header:
- build/toggle.js
+ typst:
+ # Mise en forme des chapitres en PDF: voir styles/typst/README.md
+ font-paths:
+ - fonts
+ - _extensions/quarto-ext/fontawesome/assets/webfonts
+ papersize: a4
+ fontsize: 10.5pt
+ toc: true
+ toc-depth: 2
+ linkcolor: "#447099"
+ highlight-style: atom-one-dark
+ date-format: long
+ filters:
+ - styles/typst/inline-code.lua
+ template-partials:
+ - styles/typst/typst-template.typ
+ - styles/typst/typst-show.typ
+ - styles/typst/page.typ
+ include-in-header:
+ - styles/typst/style.typ
ipynb: default
diff --git a/_quarto.yml b/_quarto.yml
index 65770751d8..113879c607 100644
--- a/_quarto.yml
+++ b/_quarto.yml
@@ -67,6 +67,11 @@ website:
format:
html:
+ # gitlink ne sert qu'au HTML (widget): en Typst il plante sur `bibliography`
+ # (pandoc.utils.references lit un nom de fichier vide)
+ filters:
+ - path: gitlink
+ at: post-quarto
include-after-body: build/js/mac.html
respect-user-color-scheme: true
theme:
@@ -84,6 +89,26 @@ format:
mainfont: "Open Sans"
monofont: "JetBrains Mono"
linestretch: 1.65
+ typst:
+ # Mise en forme des chapitres en PDF: voir styles/typst/README.md
+ font-paths:
+ - fonts
+ - _extensions/quarto-ext/fontawesome/assets/webfonts
+ papersize: a4
+ fontsize: 10.5pt
+ toc: true
+ toc-depth: 2
+ linkcolor: "#447099"
+ highlight-style: atom-one-dark
+ date-format: long
+ filters:
+ - styles/typst/inline-code.lua
+ template-partials:
+ - styles/typst/typst-template.typ
+ - styles/typst/typst-show.typ
+ - styles/typst/page.typ
+ include-in-header:
+ - styles/typst/style.typ
ipynb: default
@@ -101,8 +126,6 @@ filters:
- build/replace-title.lua
- _extensions/linogaliana/details-iframe/details.lua
- _extensions/linogaliana/lang-switch/button.lua
- - path: gitlink
- at: post-quarto
extensions:
gitlink:
enabled: false
diff --git a/build/append-environment/_meta_info.qmd b/build/append-environment/_meta_info.qmd
index fb4e88f10d..af3b5f5745 100644
--- a/build/append-environment/_meta_info.qmd
+++ b/build/append-environment/_meta_info.qmd
@@ -18,6 +18,8 @@ Pour utiliser exactement le même environnement (version de `Python` et _package
+::: {.content-visible when-format="html"}
+
::: {.callout-note collapse="true"}
## Historique du fichier {{< fa brands git-alt >}}
@@ -40,6 +42,8 @@ html`${git_history_graph}
`
:::
+:::
+
::::
:::: {.content-visible when-profile="en"}
@@ -59,6 +63,8 @@ To use exactly the same environment (version of `Python` and _packages_), please
:::
+::: {.content-visible when-format="html"}
+
::: {.callout-note collapse="true"}
## File history {{< fa brands git-alt >}}
@@ -82,12 +88,16 @@ html`${git_history_graph}
`
:::
+:::
+
::::
+::: {.content-visible when-format="html"}
+
```{ojs}
//| echo: false
creation = d3.min(
@@ -179,26 +189,19 @@ git_history_graph = {
}
const isFirst = i === 0
const isLast = i === commits.length - 1
- rows.push(html`
-
-
- ${isFirst ? html`
${labels.latest}` : ""}
- ${isLast ? html`
${labels.created}` : ""}
-
${c.sha}
-
${c.message}
- ${c.pr ? html`
#${c.pr}` : ""}
-
${fmt.format(c.date)} · ${labels.by} ${c.author}
- `)
+ const head = isFirst ? html`${labels.latest}` : ""
+ const root = isLast ? html`${labels.created}` : ""
+ const pr = c.pr ? html`#${c.pr}` : ""
+ const title = html``
+ const meta = html`${fmt.format(c.date)} · ${labels.by} ${c.author}
`
+ rows.push(html`${title}${meta}`)
})
- return html`
-
-
- ${labels.plain}
- ${labels.pr}
-
-
@@ -25,7 +25,7 @@ Il existe des *workflows* plus complexes, notamment le `Git Flow` que j'utilise
pour développer ce cours. [Ce tutoriel](https://www.atlassian.com/fr/git/tutorials/comparing-workflows/gitflow-workflow), très bien fait,
illustre avec un graphique la complexité accrue de ce flow :
-
+
Cette fois, une branche intermédiaire, par exemple une branche `development`,
intègre des modifications à tester avant de les intégrer dans la version
@@ -57,7 +57,7 @@ The _Github flow_ corresponds to this characteristic tree shape:
3. When the changes are complete, they are merged into `main`;
the branch in question disappears:
-
+
@@ -71,7 +71,7 @@ There are more complex *workflows*, notably the `Git Flow` that I use
to develop this course. [This tutorial](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow), very well done,
illustrates with a graph the increased complexity of this flow:
-
+
This time, an intermediate branch, for example a `development` branch,
gathers changes to be tested before integrating them into the
diff --git a/content/git/index.qmd b/content/git/index.qmd
index 4259497f03..5e26146036 100644
--- a/content/git/index.qmd
+++ b/content/git/index.qmd
@@ -74,7 +74,7 @@ Scroll down to read the _slides_ below or [click here](https://inseefrlab.github
La démarche naturelle quand on commence à travailler longuement sur un projet pour lequel on veut éviter d'effacer et perdre son code à cause d'une erreur humaine est de dupliquer les fichiers et créer des __versions multiples d'un même code qui sont des instantanés à un moment donné__ :
-{#fig-version-control-inferno}
+{#fig-version-control-inferno}
Ceci est une manière de sauvegarder l'évolution de son code et donc la vie d'un projet. Néanmoins c'est une manière très artisanale de procéder qui n'efface pas l'erreur humaine puisqu'il est toujours possible de faire une erreur lors de la duplication du fichier ou d'oublier de sauvegarder une version qui nous satisfaisait.
@@ -98,7 +98,7 @@ Si on ajoute la dimension collaborative du travail sur le code, on voit rapideme
The natural approach when you start working for a long time on a project for which you want to avoid erasing and losing your code because of a human error is to duplicate files and create __multiple versions of the same code that are snapshots at a given point in time__:
-{#fig-version-control-inferno}
+{#fig-version-control-inferno}
This is a way of saving the evolution of your code and therefore the life of a project. Nevertheless, it is a very artisanal way of proceeding that does not eliminate human error, since it is always possible to make a mistake when duplicating the file or to forget to save a version that satisfied us.
diff --git a/content/git/introgit/_branches.qmd b/content/git/introgit/_branches.qmd
index 44db207b62..bd08a3a12a 100644
--- a/content/git/introgit/_branches.qmd
+++ b/content/git/introgit/_branches.qmd
@@ -24,7 +24,7 @@ L'utilisation des branches est une fonctionnalité déjà avancée de `Git`. Ce
Parmi les pratiques techniquement possibles mais non recommandables, il faut **absolument** bannir les usages de `push force` qui peuvent déstabiliser les copies locales des collaborateurs. S'il est nécessaire de faire un `push force`, c'est qu'il y a un problème dans la branche, à identifier et régler **sans** faire `push force`.
-
+
:::
@@ -208,7 +208,7 @@ Using branches is already an advanced feature of `Git`. It is a wonderful techni
Among the practices that are technically possible but not recommended, you must **absolutely** ban the use of `push force`, which can destabilise collaborators' local copies. If a `push force` is necessary, it means there is a problem in the branch, which must be identified and fixed **without** a `push force`.
-
+
:::
diff --git a/content/git/introgit/_commit.qmd b/content/git/introgit/_commit.qmd
index 3e1b2d4ac8..fc52243361 100644
--- a/content/git/introgit/_commit.qmd
+++ b/content/git/introgit/_commit.qmd
@@ -66,6 +66,8 @@ des fichiers `Changed`, il faudra le modifier à nouveau
:::
+::: {.content-visible when-format="html"}
+
```{ojs}
containerQuestionGit1
```
@@ -123,6 +125,8 @@ messageQuestion1 = {
}
```
+:::
+
::: {.callout-note}
Si vous utilisiez la ligne de commande, la manière équivalente de faire
serait
@@ -209,6 +213,8 @@ of `Changed` files, you will have to modify it again
:::
+::: {.content-visible when-format="html"}
+
```{ojs}
containerQuestionGit1
```
@@ -266,6 +272,8 @@ messageQuestion1 = {
}
```
+:::
+
::: {.callout-note}
If you were using the command line, the equivalent way of doing this
would be
diff --git a/content/git/introgit/_gitignore.qmd b/content/git/introgit/_gitignore.qmd
index c13138239f..4107020ef1 100644
--- a/content/git/introgit/_gitignore.qmd
+++ b/content/git/introgit/_gitignore.qmd
@@ -41,6 +41,8 @@ de `Jupyter`, cliquer sur `View -> Show Hidden Files`
:::
+::: {.content-visible when-format="html"}
+
```{ojs}
//| echo: false
html`${containerQuestionGit2}`
@@ -51,13 +53,7 @@ html`${containerQuestionGit2}`
//| output: false
containerQuestionGit2 = {
// The container div for all the elements
- let container = html`
-
-
${textQuestion2}
-
${viewof questionGit2}
-
${messageQuestion2Response}
-
${textQuestion2}
${viewof questionGit2}
${messageQuestion2Response}
-
${textQuestion2}
-
${viewof questionGit2}
-
${messageQuestion2Response}
-
${textQuestion2}
${viewof questionGit2}
${messageQuestion2Response}
:::
@@ -121,7 +121,7 @@ Reminder: The Decision Tree of `Scikit` Methods
-
+
:::
@@ -173,7 +173,7 @@ L'objectif des *k-means* est de partitionner l'espace des observations en trouva
L'algorithme *k-means* fonctionne par itération, en initialisant les centroïdes puis en les mettant à jour à chaque
itération, jusqu'à ce que les centroïdes se stabilisent. Quelques exemples de *clusters* issus de la méthode *k-means* :
-
+
::: {.callout-tip}
@@ -198,7 +198,7 @@ d'imports de packages, pour gagner du temps.
The objective of *k-means* is to partition the observation space by finding points (*centroids*) that act as centers of gravity around which nearby observations can be grouped into homogeneous classes.
The *k-means* algorithm works iteratively, initializing the centroids and then updating them at each iteration until the centroids stabilize. Here are some examples of *clusters* resulting from the *k-means* method:
-
+
::: {.callout-tip}
diff --git a/content/modelisation/6_pipeline.qmd b/content/modelisation/6_pipeline.qmd
index fafe185dd5..0cf7c8ab26 100644
--- a/content/modelisation/6_pipeline.qmd
+++ b/content/modelisation/6_pipeline.qmd
@@ -435,7 +435,7 @@ règle d'agrégation pour en tirer une règle moyennisée et donc une prédictio
Le _boosting_ fonctionne selon un principe différent, basé sur
l'optimisation de combinaisons de classifieurs faibles.
-
+
L'un des intérêts
des *random forest* est qu'il existe des méthodes pour déterminer
diff --git a/content/modelisation/index.qmd b/content/modelisation/index.qmd
index c99da0d9f9..47c987bff5 100644
--- a/content/modelisation/index.qmd
+++ b/content/modelisation/index.qmd
@@ -590,7 +590,7 @@ pour pouvoir appliquer des métriques simples et stables.
En résumé, l'aide-mémoire suivante, issue de l'aide de `Scikit-Learn`, peut déjà donner de premiers enseignements sur les différentes familles de modèles :
::: {#fig-algos-scikit}
-
+
Une _cheatsheet_ des algorithmes disponibles dans [`Scikit-Learn`](https://scikit-learn.org)
:::
@@ -618,7 +618,7 @@ Performance metrics typically use the proportion of correct or incorrect classif
In summary, the following cheat sheet, taken from `Scikit-Learn` documentation, provides an initial overview of the different model families:
::: {#fig-algos-scikit}
-
+
A cheatsheet of algorithms available in [`Scikit-Learn`](https://scikit-learn.org)
:::
diff --git a/content/visualisation/01_matplotlib/_matplotlib_principle.qmd b/content/visualisation/01_matplotlib/_matplotlib_principle.qmd
index eb0f4aea8a..63727c7f71 100644
--- a/content/visualisation/01_matplotlib/_matplotlib_principle.qmd
+++ b/content/visualisation/01_matplotlib/_matplotlib_principle.qmd
@@ -7,7 +7,7 @@
[^chatGPT]: Heureusement, comme il existe un énorme corpus de code en ligne utilisant `matplotlib`, les assistants de code comme `ChatGPT` ou `Github Copilot` sont précieux pour construire un graphique à partir d'instructions.
-)](https://matplotlib.org/stable/_images/anatomy.png){#fig-matplotlib width=50%}
+)](https://minio.lab.sspcloud.fr/lgaliana/ensae/python/img/matplotlib-anatomy.png){#fig-matplotlib width=50%}
En pratique, il existe deux manières de créer et mettre à jour sa figure selon qu'on préfère passer par:
@@ -24,7 +24,7 @@ En pratique, il existe deux manières de créer et mettre à jour sa figure selo
[^chatGPT-en]: Thankfully, with a vast amount of online code using `matplotlib`, code assistants like `ChatGPT` or `Github Copilot` are invaluable for creating charts based on instructions.
-)](https://matplotlib.org/stable/_images/anatomy.png){#fig-matplotlib}
+)](https://minio.lab.sspcloud.fr/lgaliana/ensae/python/img/matplotlib-anatomy.png){#fig-matplotlib}
In practice, there are two ways to create and update your figure, depending on your preference:
diff --git a/content/visualisation/01_matplotlib/_plotnine.qmd b/content/visualisation/01_matplotlib/_plotnine.qmd
index f36934c5f4..4b050fdb91 100644
--- a/content/visualisation/01_matplotlib/_plotnine.qmd
+++ b/content/visualisation/01_matplotlib/_plotnine.qmd
@@ -5,7 +5,7 @@
Dans cette approche, un graphique est vu comme une succession de couches qui, une fois superposées, donneront la figure suivante. En soi, ce principe n'est pas différent de celui de `matplotlib`. Néanmoins, la grammaire utilisée par `plotnine` est beaucoup plus intuitive et normalisée, ce qui offrira beaucoup plus d'autonomie pour modifier sa figure.
-{target="_blank"}](https://datavizf24.classes.andrewheiss.com/slides/img/03/ggplot-layers@4x.png){width=60%}
+{target="_blank"}](https://minio.lab.sspcloud.fr/lgaliana/ensae/python/img/datavizf24-ggplot-layers-4x.png){width=60%}
Avec `plotnine`, il n'y a plus de point d'entrée dual figure-axe. Comme l'illustrent les slides ci-dessous :
@@ -20,7 +20,7 @@ Avec `plotnine`, il n'y a plus de point d'entrée dual figure-axe. Comme l'illus
`plotnine` is the newcomer to the `Python` visualization ecosystem. This library is developed by `Posit`, the company behind the `RStudio` editor and the _tidyverse_ ecosystem, which is central to the `R` language. This library aims to bring the logic of `ggplot` to `Python`, meaning a standardized, readable, and flexible grammar of graphics inspired by @wilkinson2011grammar.
In this approach, a chart is viewed as a succession of layers that, when combined, create the final figure. This principle is not inherently different from that of `matplotlib`. However, the grammar used by `plotnine` is far more intuitive and standardized, offering much more autonomy for modifying a chart.
-{target="_blank"}](https://datavizf24.classes.andrewheiss.com/slides/img/03/ggplot-layers@4x.png){width=60%}
+{target="_blank"}](https://minio.lab.sspcloud.fr/lgaliana/ensae/python/img/datavizf24-ggplot-layers-4x.png){width=60%}
With `plotnine`, there is no longer a dual figure-axis entry point. As illustrated in the slides below:
diff --git a/content/visualisation/02_maps/_intro.qmd b/content/visualisation/02_maps/_intro.qmd
index 7d5e9b42fd..18b5b58f89 100644
--- a/content/visualisation/02_maps/_intro.qmd
+++ b/content/visualisation/02_maps/_intro.qmd
@@ -7,7 +7,7 @@ La cartographie est l'une des plus anciennes représentations d'informations sou
D'après @chen2008brief, la première représentation de ce type a été proposée par Charles Dupin en 1826 [@fig-dupin] pour représenter les niveaux d'instruction sur le territoire français. L'émergence des cartes choroplèthes est en effet indissociable de l'organisation du pouvoir sous forme d'entités politiques supposées unitaires. Par exemple, les cartes du monde représentent souvent des aplats de couleurs à partir des nations, les cartes nationales à partir d'échelons administratifs (régions, départements, communes, mais aussi États ou _Länder_).
-{#fig-dupin width="50%" fig-align="center"}
+{#fig-dupin width="50%" fig-align="center"}
On peut voir l'émergence pendant le XIXe siècle de la carte choroplèthe comme un moment important de la cartographie, un glissement de l'usage militaire vers l'usage politique. Il ne s'agissait plus exclusivement de représenter le territoire physique mais aussi la réalité socioéconomique, dans des bornes administratives connues de tous.
@@ -33,7 +33,7 @@ Cartography is one of the oldest forms of graphical representation of informatio
According to @chen2008brief, the first representation of this type was proposed by Charles Dupin in 1826 [@fig-dupin] to illustrate literacy levels across France. The rise of choropleth maps is closely linked to the organization of power through unitary political entities. For instance, world maps often use color shades to represent nations, while national maps use administrative divisions (regions, departments, municipalities, as well as states or _Länder_).
-{#fig-dupin width="50%" fig-align="center"}
+{#fig-dupin width="50%" fig-align="center"}
The emergence of choropleth maps during the 19th century marks an important shift in cartography, transitioning from military use to political application. No longer limited to depicting physical terrain, maps began to represent socioeconomic realities within well-defined administrative boundaries.
diff --git a/fonts/JetBrainsMono-Bold.ttf b/fonts/JetBrainsMono-Bold.ttf
new file mode 100644
index 0000000000..9dfca3287f
Binary files /dev/null and b/fonts/JetBrainsMono-Bold.ttf differ
diff --git a/fonts/JetBrainsMono-BoldItalic.ttf b/fonts/JetBrainsMono-BoldItalic.ttf
new file mode 100644
index 0000000000..ee9298ba68
Binary files /dev/null and b/fonts/JetBrainsMono-BoldItalic.ttf differ
diff --git a/fonts/JetBrainsMono-Italic.ttf b/fonts/JetBrainsMono-Italic.ttf
new file mode 100644
index 0000000000..b0cb4c3acc
Binary files /dev/null and b/fonts/JetBrainsMono-Italic.ttf differ
diff --git a/fonts/JetBrainsMono-Regular.ttf b/fonts/JetBrainsMono-Regular.ttf
new file mode 100644
index 0000000000..3a4195e995
Binary files /dev/null and b/fonts/JetBrainsMono-Regular.ttf differ
diff --git a/fonts/NotoColorEmoji.ttf b/fonts/NotoColorEmoji.ttf
new file mode 100644
index 0000000000..fa652d40a5
Binary files /dev/null and b/fonts/NotoColorEmoji.ttf differ
diff --git a/fonts/README.md b/fonts/README.md
new file mode 100644
index 0000000000..429ba598c4
--- /dev/null
+++ b/fonts/README.md
@@ -0,0 +1,18 @@
+# Polices pour la sortie Typst / PDF
+
+Typst n'embarque ni JetBrains Mono ni de police d'emoji (le texte courant utilise
+Libertinus Serif, intégrée à Typst). Ce dossier est
+référencé par `font-paths` dans la section `format: typst` de `_quarto.yml`
+(et de `_quarto-prod.yml`, `_quarto-test.yml`). Voir `styles/typst/README.md`.
+
+- `JetBrainsMono-*.ttf` (Regular, Italic, Bold, BoldItalic):
+ [JetBrains Mono](https://www.jetbrains.com/lp/mono/), licence SIL OFL 1.1.
+ Police du code, comme sur le site.
+- `NotoColorEmoji.ttf`: [Noto Color Emoji](https://github.com/googlefonts/noto-emoji)
+ (v2.051), licence SIL OFL 1.1. Twemoji Mozilla, plus légère (1,4 Mo), a été
+ écartée: elle n'affiche pas les emoji-chiffres (1️⃣, 2️⃣…) utilisés dans les
+ exercices.
+
+Les icônes `Font Awesome` des encadrés viennent de Quarto (Typst les charge
+avec ses polices intégrées); l'extension `quarto-ext/fontawesome` ne gère pas
+le shortcode `{{< fa >}}` en Typst.
diff --git a/reference.bib b/reference.bib
index 683d0a4312..61eae90b1d 100644
--- a/reference.bib
+++ b/reference.bib
@@ -192,15 +192,6 @@ @book{geron2022hands
publisher={" O'Reilly Media, Inc."}
}
-@article{chen2008brief,
- title={A brief history of data visualization},
- author={Chen, Chun-houh and H{\"a}rdle, Wolfgang and Unwin, Antony and Friendly, Michael},
- journal={Handbook of data visualization},
- pages={15--56},
- year={2008},
- publisher={Springer}
-}
-
@article{breiman2001random,
title={Random forests},
author={Breiman, Leo},
diff --git a/styles/typst/README.md b/styles/typst/README.md
new file mode 100644
index 0000000000..afcc0e9320
--- /dev/null
+++ b/styles/typst/README.md
@@ -0,0 +1,52 @@
+# Template Typst des chapitres (PDF)
+
+Mise en forme des chapitres compilés avec `quarto render --to typst`. La config
+est dans `format: typst:` de `_quarto.yml`, `_quarto-prod.yml` et
+`_quarto-test.yml` (les trois doivent rester alignées).
+
+| Fichier | Rôle |
+|---|---|
+| `typst-template.typ` | Partial Quarto `typst-template.typ`: palette (`ds-*`), polices, titres, bloc de titre (titre, filet, auteur·date, description en chapeau), table des matières |
+| `typst-show.typ` | Partial Quarto `typst-show.typ`: transmet les métadonnées, dont `description`, à `article()` |
+| `page.typ` | Partial Quarto `page.typ`: A4, en-tête (titre du chapitre + adresse du site, sauf page 1), pied de page « n / N », marges de notes |
+| `style.typ` | Chargé via `include-in-header`: blocs de code, code en ligne, encadrés, notes, figures, tableaux, citations |
+| `inline-code.lua` | Filtre (Typst uniquement): envoie le code en ligne à `ds-inline` de `style.typ` |
+
+## Choix
+
+- Typographie d'article scientifique: Libertinus Serif (intégrée à Typst) en
+ 10,5 pt, texte justifié avec césure, titres en gras sans filet, bloc de titre
+ centré avec la description en résumé. Code en JetBrains Mono (`fonts/`, repli
+ sur DejaVu Sans Mono).
+- Page A4, marges symétriques de 3 cm (texte de 15 cm). Les `.aside` du site,
+ que Quarto émet comme notes de marge (`#note` de marginalia, avec une colonne
+ réservée à droite), sont redéfinis en encadrés discrets dans le texte.
+- Tableaux à 7 colonnes ou plus (DataFrame de `pandas`): ils débordent de 1,5 cm
+ dans chaque marge puis sont réduits à la largeur disponible.
+ Sans cela, les colonnes `auto` ne peuvent pas passer à la ligne au milieu d'un
+ nombre et les valeurs se chevauchent. Ils ne sont pas sécables d'une page à l'autre.
+- Encadrés (`callout`) sécables d'une page à l'autre: sans cela un encadré plus
+ haut que la page débordait sur le pied de page.
+
+- Première page: titre, auteur, « Version du » (`date: today` au moment du
+ rendu, `date-format: long`), résumé, puis un avertissement (PDF généré
+ automatiquement, renvoi vers pythonds.linogaliana.fr) avant la table des matières.
+- Blocs de code sur fond sombre (thème `atom-one-dark`, réglé par `highlight-style`
+ dans `format: typst`, et fond fixé dans `Skylighting` de `style.typ`). Le code en
+ ligne est en rouge sur fond gris clair: comme la coloration de pandoc utilise les
+ couleurs du thème sombre (invisibles sur la page blanche), `inline-code.lua`
+ l'écrit lui-même au lieu de la laisser faire. Si on change de thème, ajuster le
+ fond de `Skylighting` et la couleur de base du texte qui y est définie.
+
+## Points d'attention
+
+- `callout` est redéfini dans `style.typ`. Quarto réassemble le titre des encadrés
+ numérotés en parcourant sa structure (`body.children`): ne pas y ajouter de
+ `#set` ni d'enveloppe autour du titre.
+- Les constantes `ds-*` sont définies dans `typst-template.typ`, avant
+ `page.typ` et `style.typ` dans l'ordre d'assemblage de Quarto, et ne sont
+ visibles que par ce qui est défini après elles.
+- Dans une partial Pandoc, un `$` littéral doit s'écrire `$$`.
+- Le PDF d'un fichier absent de la liste `render:` s'obtient avec
+ `--profile prod`: sinon Quarto le traite comme un rendu isolé et Typst refuse
+ `../../reference.bib`.
diff --git a/styles/typst/inline-code.lua b/styles/typst/inline-code.lua
new file mode 100644
index 0000000000..3fc3aa8bee
--- /dev/null
+++ b/styles/typst/inline-code.lua
@@ -0,0 +1,19 @@
+-- Sortie Typst: le code en ligne (`toto`) est confié à `ds-inline` (styles/typst/style.typ)
+-- plutôt qu'à la coloration syntaxique de pandoc, dont les couleurs sont celles du
+-- thème sombre des blocs de code.
+if not quarto.doc.is_format("typst") then
+ return {}
+end
+
+local function typst_string(s)
+ s = s:gsub("\\", "\\\\"):gsub('"', '\\"'):gsub("\n", " ")
+ return '"' .. s .. '"'
+end
+
+return {
+ {
+ Code = function(el)
+ return pandoc.RawInline("typst", "#ds-inline(" .. typst_string(el.text) .. ")")
+ end,
+ },
+}
diff --git a/styles/typst/page.typ b/styles/typst/page.typ
new file mode 100644
index 0000000000..3a8c3fc5cf
--- /dev/null
+++ b/styles/typst/page.typ
@@ -0,0 +1,36 @@
+#set page(
+ paper: $if(papersize)$"$papersize$"$else$"a4"$endif$,
+$if(margin)$
+ margin: ($for(margin/pairs)$$margin.key$: $margin.value$,$endfor$),
+$else$
+ margin: (x: 3cm, y: 2.4cm),
+$endif$
+ numbering: $if(page-numbering)$"$page-numbering$"$else$"1"$endif$,
+ columns: $if(columns)$$columns$$else$1$endif$,
+ // En-tête (sauf page de titre): titre du chapitre et adresse du site
+ header: context {
+ if counter(page).get().first() > 1 {
+ set text(size: 8pt, fill: ds-muted)
+ grid(
+ columns: (1fr, auto),
+ column-gutter: 1em,
+$if(title)$
+ [$title$],
+$else$
+ [],
+$endif$
+ [pythonds.linogaliana.fr],
+ )
+ v(-0.5em)
+ line(length: 100%, stroke: 0.4pt + ds-rule)
+ }
+ },
+ header-ascent: 35%,
+ footer: context {
+ set text(size: 8pt, fill: ds-muted)
+ align(center)[#counter(page).display() / #counter(page).final().first()]
+ },
+)
+$if(logo)$
+#set page(background: align($logo.location$, box(inset: $logo.inset$, image("$logo.path$", width: $logo.width$$if(logo.alt)$, alt: "$logo.alt$"$endif$))))
+$endif$
diff --git a/styles/typst/style.typ b/styles/typst/style.typ
new file mode 100644
index 0000000000..3550e92273
--- /dev/null
+++ b/styles/typst/style.typ
@@ -0,0 +1,133 @@
+// Mise en forme des éléments du corps du texte (inclus via `include-in-header`,
+// donc après les définitions de Quarto et avant le contenu). Les redéfinitions
+// `#let` ci-dessous remplacent celles de Quarto pour tout ce qui suit.
+
+// Blocs de code (coloration de pandoc, thème `atom-one-dark` défini dans
+// `highlight-style`): fond sombre. Les sorties de cellules restent sur fond clair.
+#let Skylighting(fill: none, number: false, start: 1, sourcelines) = {
+ let blocks = []
+ let lnum = start - 1
+ for ln in sourcelines {
+ if number {
+ lnum = lnum + 1
+ blocks = blocks + box(width: if start + sourcelines.len() > 999 { 30pt } else { 24pt }, text(fill: rgb("#636D83"), [ #lnum ]))
+ }
+ blocks = blocks + ln + EndLine()
+ }
+ block(
+ fill: rgb("#282C34"),
+ width: 100%,
+ inset: (x: 10pt, y: 9pt),
+ radius: 3pt,
+ above: 1em,
+ below: 1em,
+ text(fill: rgb("#ABB2BF"), blocks),
+ )
+}
+
+// Sorties de cellules et blocs de code sans coloration
+#show raw.where(block: true): set block(
+ fill: rgb("#F6F8FA"),
+ stroke: 0.5pt + ds-rule,
+ width: 100%,
+ inset: (x: 10pt, y: 8pt),
+ radius: 3pt,
+)
+
+// Code en ligne (`toto`): couleur et léger fond, sécable en fin de ligne.
+// Appelé par le filtre inline-code.lua, qui court-circuite la coloration de
+// pandoc (dont les couleurs, prévues pour fond sombre, seraient invisibles ici).
+#let ds-inline(s) = highlight(
+ fill: rgb("#F3F4F6"),
+ extent: 1.5pt,
+ radius: 2pt,
+ text(fill: rgb("#B0304F"), raw(s)),
+)
+
+// Encadrés (callouts): même structure que celle de Quarto (sa règle d'assemblage
+// des titres en dépend: ne pas ajouter de `set` ni d'enveloppe), mais sécables d'une page à l'autre (sinon
+// un encadré plus haut que la page déborde) et avec plus d'espace autour.
+#let callout(body: [], title: "Callout", background_color: rgb("#dddddd"), icon: none, icon_color: black, body_background_color: white) = {
+ block(
+ breakable: true,
+ above: 1.2em,
+ below: 1.2em,
+ fill: background_color,
+ stroke: (paint: icon_color, thickness: 0.6pt, cap: "round"),
+ width: 100%,
+ radius: 3pt,
+ block(
+ inset: 1pt,
+ width: 100%,
+ below: 0pt,
+ block(
+ fill: background_color,
+ width: 100%,
+ inset: (x: 10pt, y: 7pt))[#if icon != none [#text(icon_color, weight: 900)[#icon] ]#title]) +
+ if(body != []){
+ block(
+ inset: 1pt,
+ width: 100%,
+ block(fill: body_background_color, width: 100%, inset: (x: 10pt, y: 8pt), body))
+ }
+ )
+}
+
+// Figures: légende discrète et centrée
+#show figure: set block(above: 1.4em, below: 1.4em)
+#show figure.caption: set text(size: 0.88em, fill: ds-muted)
+
+// Citations en bloc
+#show quote.where(block: true): it => block(
+ width: 100%,
+ inset: (left: 1em, y: 0.3em),
+ stroke: (left: 3pt + ds-rule),
+ text(fill: ds-muted, it.body),
+)
+
+// Tableaux: en-tête grisé, filets horizontaux fins
+#set table(
+ inset: (x: 8pt, y: 5pt),
+ stroke: (x, y) => (
+ top: if y == 0 { 0.8pt + ds-ink } else { none },
+ bottom: if y == 0 { 0.6pt + ds-ink } else { 0.4pt + ds-rule },
+ ),
+ fill: (x, y) => if y == 0 { ds-soft } else { none },
+)
+#show table.cell.where(y: 0): set text(weight: "semibold")
+#show table: set text(size: 0.92em)
+
+// Notes de marge (`.aside` du site): Quarto les émet comme `#note(...)[...]` de
+// marginalia, qui réserve une colonne à droite de toutes les pages. On les rend
+// en encadré discret dans le texte, pour garder des marges symétriques.
+#let note(body, ..args) = block(
+ width: 100%,
+ above: 0.9em,
+ below: 0.9em,
+ inset: (left: 0.9em, y: 0.3em),
+ stroke: (left: 2.5pt + ds-rule),
+ {
+ set text(size: 0.9em, fill: ds-muted)
+ set par(justify: false)
+ body
+ },
+)
+
+// Tableaux larges (DataFrame de `pandas` à une dizaine de colonnes): sans cela
+// les colonnes `auto` ne peuvent pas passer à la ligne au milieu d'un nombre et
+// les valeurs se chevauchent. On les laisse déborder de 1,5 cm dans chaque marge,
+// puis on les réduit s'ils sont encore trop larges.
+#show table: it => {
+ let ncols = if type(it.columns) == int { it.columns } else if type(it.columns) == array { it.columns.len() } else { 1 }
+ if ncols < 7 { return it }
+ pad(x: -1.5cm, layout(size => {
+ let small = { set text(size: 0.85em, hyphenate: false); it }
+ let natural = measure(small)
+ if natural.width > size.width {
+ let k = size.width / natural.width
+ scale(x: k * 100%, y: k * 100%, origin: top + left, reflow: true, small)
+ } else {
+ small
+ }
+ }))
+}
diff --git a/styles/typst/typst-show.typ b/styles/typst/typst-show.typ
new file mode 100644
index 0000000000..ff93549a2f
--- /dev/null
+++ b/styles/typst/typst-show.typ
@@ -0,0 +1,79 @@
+#show: doc => article(
+$if(title)$
+ title: [$title$],
+$endif$
+$if(subtitle)$
+ subtitle: [$subtitle$],
+$endif$
+$if(by-author)$
+ authors: (
+$for(by-author)$
+$if(it.name.literal)$
+ ( name: [$it.name.literal$],
+ affiliation: [$for(it.affiliations)$$it.name$$sep$, $endfor$],
+ email: [$it.email$] ),
+$endif$
+$endfor$
+ ),
+$endif$
+$if(date)$
+ date: [$date$],
+$endif$
+$if(description)$
+ description: [$description$],
+$endif$
+$if(lang)$
+ lang: "$lang$",
+$endif$
+$if(region)$
+ region: "$region$",
+$endif$
+$if(abstract)$
+ abstract: [$abstract$],
+ abstract-title: "$labels.abstract$",
+$endif$
+$if(mainfont)$
+ font: ("$mainfont$",),
+$endif$
+$if(fontsize)$
+ fontsize: $fontsize$,
+$endif$
+$if(section-numbering)$
+ sectionnumbering: "$section-numbering$",
+$endif$
+$if(mathfont)$
+ mathfont: ($for(mathfont)$"$mathfont$",$endfor$),
+$endif$
+$if(codefont)$
+ codefont: ($for(codefont)$"$codefont$",$endfor$),
+$endif$
+$if(linestretch)$
+ linestretch: $linestretch$,
+$endif$
+$if(thanks)$
+ thanks: [$thanks$],
+$endif$
+$if(linkcolor)$
+ linkcolor: [$linkcolor$],
+$endif$
+$if(citecolor)$
+ citecolor: [$citecolor$],
+$endif$
+$if(filecolor)$
+ filecolor: [$filecolor$],
+$endif$
+$if(keywords)$
+ keywords: ($for(keywords)$"$keywords$",$endfor$),
+$endif$
+$if(toc)$
+ toc: $toc$,
+$endif$
+$if(toc-title)$
+ toc_title: [$toc-title$],
+$endif$
+$if(toc-indent)$
+ toc_indent: $toc-indent$,
+$endif$
+ toc_depth: $toc-depth$,
+ doc,
+)
diff --git a/styles/typst/typst-template.typ b/styles/typst/typst-template.typ
new file mode 100644
index 0000000000..6d6cc73cd3
--- /dev/null
+++ b/styles/typst/typst-template.typ
@@ -0,0 +1,195 @@
+// Gabarit des chapitres compilés en Typst / PDF (voir styles/typst/README.md).
+// Remplace la partial `typst-template.typ` de Quarto: mêmes paramètres, plus
+// `description`, et une mise en page pensée pour la lecture d'un chapitre long.
+
+// Palette, alignée sur celle du site (styles/custom*.scss et git-sandbox)
+#let ds-ink = rgb("#22384C") // titres
+#let ds-accent = rgb("#447099") // filets, liens
+#let ds-soft = rgb("#F3F6F8") // fonds discrets
+#let ds-muted = rgb("#5B6770") // métadonnées, légendes
+#let ds-rule = rgb("#D0DBE5") // filets fins
+
+#let ds-body-font = ("Libertinus Serif",)
+#let ds-code-font = ("JetBrains Mono", "DejaVu Sans Mono")
+
+#let article(
+ title: none,
+ subtitle: none,
+ authors: none,
+ keywords: (),
+ date: none,
+ abstract-title: none,
+ abstract: none,
+ description: none,
+ thanks: none,
+ cols: 1,
+ lang: "en",
+ region: "US",
+ font: none,
+ fontsize: 10.5pt,
+ title-size: 1.9em,
+ subtitle-size: 1.25em,
+ heading-family: none,
+ heading-weight: "bold",
+ heading-style: "normal",
+ heading-color: black,
+ heading-line-height: 0.65em,
+ mathfont: none,
+ codefont: none,
+ linestretch: 1.25,
+ sectionnumbering: none,
+ linkcolor: none,
+ citecolor: none,
+ filecolor: none,
+ toc: false,
+ toc_title: none,
+ toc_depth: none,
+ toc_indent: 1.2em,
+ doc,
+) = {
+ // Métadonnées du PDF (accessibilité)
+ set document(title: title, keywords: keywords)
+ set document(
+ author: authors.map(author => content-to-string(author.name)).join(", ", last: " & "),
+ ) if authors != none and authors != ()
+
+ // Texte courant: police à empattements, justifié avec césure (typographie
+ // d'article scientifique).
+ let body-font = if font != none { font } else { ds-body-font }
+ set text(
+ lang: lang,
+ region: region,
+ size: fontsize,
+ font: body-font,
+ hyphenate: true,
+ fill: rgb("#1E2226"),
+ )
+ set par(justify: true, leading: linestretch * 0.5em, spacing: 0.95em)
+ show math.equation: set text(font: mathfont) if mathfont != none
+ show raw: set text(font: if codefont != none { codefont } else { ds-code-font }, size: 0.85em)
+
+ // Listes plus aérées
+ set list(indent: 0.4em, body-indent: 0.6em, spacing: 0.75em)
+ set enum(indent: 0.4em, body-indent: 0.6em, spacing: 0.75em)
+
+ // Titres: sobres, en gras, couleur encre; jamais isolés en bas de page
+ set heading(numbering: sectionnumbering)
+ show heading: it => {
+ let sizes = (1.45em, 1.2em, 1.05em, 1em)
+ let size = sizes.at(calc.min(it.level, sizes.len()) - 1)
+ set text(fill: ds-ink, weight: if it.level <= 2 { heading-weight } else { "semibold" }, size: size)
+ set par(leading: 0.45em, justify: false)
+ let content = {
+ if it.numbering != none {
+ counter(heading).display(it.numbering)
+ h(0.6em)
+ }
+ it.body
+ }
+ if it.level == 1 {
+ block(above: 2.1em, below: 1.3em, sticky: true, content)
+ } else if it.level >= 3 {
+ block(above: 1.5em, below: 1.05em, sticky: true, text(style: "italic", content))
+ } else {
+ block(above: 1.8em, below: 1.2em, sticky: true, content)
+ }
+ }
+
+ // Liens
+ show link: set text(fill: if linkcolor != none { rgb(content-to-string(linkcolor)) } else { ds-accent })
+ show ref: set text(fill: rgb(content-to-string(citecolor))) if citecolor != none
+ show link: this => {
+ if filecolor != none and type(this.dest) == label {
+ text(this, fill: rgb(content-to-string(filecolor)))
+ } else {
+ text(this)
+ }
+ }
+
+ // Bloc de titre centré: titre, auteur · date, puis la description en résumé
+ let has-title-block = title != none or (authors != none and authors != ()) or date != none or abstract != none
+ if has-title-block {
+ block(width: 100%, above: 0pt, below: 1.8em, {
+ set par(leading: 0.4em, justify: false)
+ align(center, {
+ if title != none {
+ text(size: title-size, weight: "bold", fill: ds-ink)[#title #if thanks != none {
+ footnote(thanks, numbering: "*")
+ counter(footnote).update(n => n - 1)
+ }]
+ if subtitle != none {
+ linebreak()
+ text(size: subtitle-size, fill: ds-muted)[#subtitle]
+ }
+ v(0.8em)
+ }
+ if authors != none and authors != () {
+ v(0.2em)
+ text(size: 1.1em, weight: "semibold")[#authors.map(author => author.name).join([, ], last: [ & ])]
+ }
+ if date != none {
+ linebreak()
+ text(size: 0.95em, fill: ds-muted)[#if lang == "en" [Version of] else [Version du] #date]
+ }
+ })
+ if description != none {
+ v(1.1em)
+ pad(x: 1.2cm, {
+ set text(size: 0.95em)
+ set par(justify: true)
+ description
+ })
+ }
+ if abstract != none {
+ v(1em)
+ pad(x: 1.2cm)[#text(weight: "semibold")[#abstract-title] #h(1em) #abstract]
+ }
+ v(0.9em)
+ line(length: 100%, stroke: 0.5pt + ds-rule)
+ })
+ }
+
+ // Avertissement: PDF généré automatiquement
+ block(
+ width: 100%,
+ above: 0pt,
+ below: 1.6em,
+ breakable: false,
+ fill: rgb("#FFF7E8"),
+ stroke: (left: 3pt + rgb("#E8A33D"), rest: 0.5pt + rgb("#F0D9AE")),
+ inset: (x: 11pt, y: 9pt),
+ radius: 3pt,
+ )[
+ #set text(size: 0.93em)
+ #set par(justify: false)
+ #if lang == "en" [
+ *⚠️ Automatically generated PDF.* This document is produced from the course
+ website and may contain formatting issues. For an up-to-date version adapted
+ to your reading, visit the course page:
+ #link("https://pythonds.linogaliana.fr")[pythonds.linogaliana.fr].
+ ] else [
+ *⚠️ PDF généré automatiquement.* Ce document est produit à partir du site du
+ cours et peut présenter des problèmes de mise en forme. Pour une version à
+ jour et adaptée à la lecture, consultez la page du cours :
+ #link("https://pythonds.linogaliana.fr")[pythonds.linogaliana.fr].
+ ]
+ ]
+
+ // Table des matières
+ if toc {
+ show outline.entry.where(level: 1): it => {
+ v(0.55em, weak: true)
+ strong(it)
+ }
+ show outline.entry: set text(size: 0.94em)
+ block(above: 0em, below: 2.2em, {
+ // Titre en texte simple: `outline(title:)` en ferait un titre de niveau 1 (filet, grande taille)
+ if toc_title != none {
+ block(below: 0.8em, text(size: 1.15em, weight: "semibold", fill: ds-ink, toc_title))
+ }
+ outline(title: none, depth: toc_depth, indent: toc_indent)
+ })
+ }
+
+ doc
+}