Night-mode styling, French cross-references, and the log through Part VI

- theme.scss and figures draw with the extension's --calc-… tokens; light/dark
  pair plus the high-contrast button; a11y highlight style for html
- figure labels split so none leaves its viewBox in any language
- _quarto-fr.yml: French cross-reference prefixes
- notes extension synced to 2.8.18
- conv/: Parts IV, V and VI logged, pasted terminal output redacted

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
MatsuneMikuroiandClaude Opus 5 committed 2026-10-06 03:36:51 +02:00
1 parent afb816f459
commit f7fa60ba81
62 files changed
+3552 -852

No files matched your search

+11 -11
View File
@@ -1,17 +1,17 @@
# [Step 0 — What the tutorial is about]{.en}[Étape 0 — De quoi parle le tutoriel]{.fr}[Schritt 0 — Worum es im Tutorial geht]{.de} {#sec-step-0}
# [Step 0 — What this is about]{.en}[Étape 0 — De quoi il s'agit]{.fr}[Schritt 0 — Worum es geht]{.de} {#sec-step-0}
<!-- MULTILINGUAL: see the comment at the top of index.qmd. -->
::: {.en}
Step 0 contains no code. It states the subject: not ROT13, but the architecture around it. The functionality stays almost unchanged for 81 steps, which is what makes the changes around it visible.
Two rules are set here and hold for the whole tutorial:
Two rules are set here and hold all the way through:
> **Meet each solution only after you have experienced the problem it solves.**
That is why the tutorial does not start with MQTT, and not with dynamic subscriptions either. It first builds a system with deliberately awkward mediators, puts it into operation, and only then asks whether they have earned their place.
That is why the build-up does not start with MQTT, and not with dynamic subscriptions either. A system with deliberately awkward mediators is built first, put into operation, and only then asked whether those mediators have earned their place.
The second rule is about vocabulary: *Intent*, *Status/State* and *Event* are named only after they have been used. They appear in the tutorial around step 42, not before.
The second rule is about vocabulary: *Intent*, *Status/State* and *Event* are named only after they have been used. They appear around step 42, not before.
The planned route, from step 0:
@@ -26,11 +26,11 @@ direct method calls → egoistic services → mediators → separate processes
::: {.fr}
L'étape 0 ne contient aucun code. Elle énonce le sujet : non pas ROT13, mais l'architecture autour de lui. La fonctionnalité reste presque inchangée pendant 81 étapes, et c'est précisément ce qui rend visibles les changements alentour.
Deux règles sont posées ici et valent pour tout le tutoriel :
Deux règles sont posées ici et valent jusqu'au bout :
> **Ne rencontrer une solution qu'après avoir vécu le problème qu'elle résout.**
C'est pourquoi le tutoriel ne commence ni par MQTT, ni par les abonnements dynamiques. Il construit d'abord un système aux médiateurs délibérément maladroits, le met en service, et demande seulement ensuite s'ils ont mérité leur place.
C'est pourquoi la construction ne commence ni par MQTT, ni par les abonnements dynamiques. Un système aux médiateurs délibérément maladroits est bâti d'abord, mis en service, et l'on demande seulement ensuite s'ils ont mérité leur place.
La seconde règle concerne le vocabulaire : *Intent*, *Status/State* et *Event* ne sont nommés qu'après avoir été utilisés. Ils apparaissent vers l'étape 42, pas avant.
@@ -47,11 +47,11 @@ direct method calls → egoistic services → mediators → separate processes
::: {.de}
Schritt 0 enthält keinen Code. Er nennt das Thema: nicht ROT13, sondern die Architektur darum herum. Die Funktionalität bleibt über 81 Schritte fast unverändert — genau das macht die Veränderungen ringsherum sichtbar.
Zwei Regeln werden hier gesetzt und gelten für das ganze Tutorial:
Zwei Regeln werden hier gesetzt und gelten bis zum Schluss:
> **Einer Lösung erst begegnen, nachdem man das Problem erlebt hat, das sie löst.**
Deshalb beginnt das Tutorial nicht mit MQTT und auch nicht mit dynamischen Abonnements. Es baut zuerst ein System mit absichtlich unbequemen Vermittlern, nimmt es in Betrieb und fragt erst dann, ob sie ihren Platz verdient haben.
Deshalb beginnt der Aufbau nicht mit MQTT und auch nicht mit dynamischen Abonnements. Zuerst entsteht ein System mit absichtlich unbequemen Vermittlern, wird in Betrieb genommen, und erst dann wird gefragt, ob sie ihren Platz verdient haben.
Die zweite Regel betrifft das Vokabular: *Intent*, *Status/State* und *Event* werden erst benannt, nachdem sie benutzt wurden. Sie erscheinen etwa ab Schritt 42, nicht früher.
@@ -70,7 +70,7 @@ direct method calls → egoistic services → mediators → separate processes
::: {.en}
The wording of the three questions matters, and it is easy to replace it with something weaker:
| The tutorial asks | A weaker version |
| As asked here | A weaker version |
|---|---|
| Who **knows** whom? | who *communicates* with whom |
| Who **owns** what? | which *data* each part holds |
@@ -82,7 +82,7 @@ The wording of the three questions matters, and it is easy to replace it with so
::: {.fr}
La formulation des trois questions compte, et il est facile de la remplacer par une version plus faible :
| Ce que demande le tutoriel | Une version plus faible |
| Telle qu'elle est posée ici | Une version plus faible |
|---|---|
| Qui **connaît** qui ? | qui *communique* avec qui |
| Qui **possède** quoi ? | quelles *données* détient chaque partie |
@@ -94,7 +94,7 @@ La formulation des trois questions compte, et il est facile de la remplacer par
::: {.de}
Der Wortlaut der drei Fragen ist wichtig, und man ersetzt ihn leicht durch eine schwächere Fassung:
| Das Tutorial fragt | Eine schwächere Fassung |
| So gefragt | Eine schwächere Fassung |
|---|---|
| Wer **kennt** wen? | wer mit wem *kommuniziert* |
| Wer **besitzt** was? | welche *Daten* jeder Teil hält |