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

+21 -21
View File
@@ -98,19 +98,19 @@ Die Verfügbarkeitsgarantie lohnt eine eigene Erwähnung, denn sie verschwindet
::: {.en}
An **egoistic** component says: I know what I can do, what data I accept and what data I produce — and I would rather not know the business process around me. Concretely, `ConsoleIn` must not contain `rot13(...)`, and `ROT13` must not contain `consoleOut(...)`.
Removing those calls immediately creates a problem, which the tutorial states as a question: if nobody knows anybody, **who makes this into a system?** Note what the question does *not* say: the knowledge is not gone, it has to go somewhere else. Two connections are missing, not one — `ConsoleIn ↔ ROT13` and `ROT13 ↔ ConsoleOut`.
Removing those calls immediately creates a problem, best put as a question: if nobody knows anybody, **who makes this into a system?** Note what the question does *not* say: the knowledge is not gone, it has to go somewhere else. Two connections are missing, not one — `ConsoleIn ↔ ROT13` and `ROT13 ↔ ConsoleOut`.
:::
::: {.fr}
Un composant **égoïste** dit : je sais ce que je peux faire, quelles données j'accepte et quelles données je produis — et je préfère ne pas connaître le processus métier qui m'entoure. Concrètement, `ConsoleIn` ne doit pas contenir `rot13(...)`, et `ROT13` ne doit pas contenir `consoleOut(...)`.
Supprimer ces appels crée aussitôt un problème, que le tutoriel formule en question : si personne ne connaît personne, **qui fait de cela un système ?** Notez ce que la question ne dit pas : la connaissance n'a pas disparu, elle doit aller ailleurs. Il manque deux liaisons, pas une — `ConsoleIn ↔ ROT13` et `ROT13 ↔ ConsoleOut`.
Supprimer ces appels crée aussitôt un problème, qui se pose en question : si personne ne connaît personne, **qui fait de cela un système ?** Notez ce que la question ne dit pas : la connaissance n'a pas disparu, elle doit aller ailleurs. Il manque deux liaisons, pas une — `ConsoleIn ↔ ROT13` et `ROT13 ↔ ConsoleOut`.
:::
::: {.de}
Eine **egoistische** Komponente sagt: ich weiss, was ich kann, welche Daten ich annehme und welche ich erzeuge — und den Geschäftsprozess um mich herum möchte ich lieber nicht kennen. Konkret: `ConsoleIn` darf kein `rot13(...)` enthalten, und `ROT13` kein `consoleOut(...)`.
Das Entfernen dieser Aufrufe schafft sofort ein Problem, das das Tutorial als Frage stellt: wenn niemand niemanden kennt, **wer macht daraus ein System?** Zu beachten ist, was die Frage nicht sagt: das Wissen ist nicht verschwunden, es muss woandershin. Es fehlen zwei Verbindungen, nicht eine — `ConsoleIn ↔ ROT13` und `ROT13 ↔ ConsoleOut`.
Das Entfernen dieser Aufrufe schafft sofort ein Problem, das sich als Frage stellen lässt: wenn niemand niemanden kennt, **wer macht daraus ein System?** Zu beachten ist, was die Frage nicht sagt: das Wissen ist nicht verschwunden, es muss woandershin. Es fehlen zwei Verbindungen, nicht eine — `ConsoleIn ↔ ROT13` und `ROT13 ↔ ConsoleOut`.
:::
## [Step 3 — Give every capability a mailbox]{.en}[Étape 3 — Donner une boîte aux lettres à chaque capacité]{.fr}[Schritt 3 — Jeder Fähigkeit ein Postfach geben]{.de} {#sec-step-3}
@@ -128,7 +128,7 @@ BlockingQueue<Message> mailbox(String name) {
}
```
The tutorial insists on calling these **mailboxes**, not topics, and gives the reason: if two readers call `take()` on the same mailbox, they compete — each message goes to exactly *one* of them and is not copied to both. A topic, in Publish/Subscribe, would hand every subscriber its own copy. One reader per message is enough for now, and the limitation is kept on purpose: it is what makes it clear later what Publish/Subscribe actually adds.
These are **mailboxes**, not topics, and the distinction is worth insisting on: if two readers call `take()` on the same mailbox, they compete — each message goes to exactly *one* of them and is not copied to both. A topic, in Publish/Subscribe, would hand every subscriber its own copy. One reader per message is enough for now, and the limitation is kept on purpose: it is what makes it clear later what Publish/Subscribe actually adds.
:::
::: {.fr}
@@ -144,7 +144,7 @@ BlockingQueue<Message> mailbox(String name) {
}
```
Le tutoriel insiste pour appeler cela des **boîtes aux lettres** (*mailboxes*) et non des sujets (*topics*), et il en donne la raison : si deux lecteurs appellent `take()` sur la même boîte, ils sont en concurrence — chaque message va à *un seul* d'entre eux et n'est pas copié aux deux. Un *topic*, en Publish/Subscribe, remettrait à chaque abonné sa propre copie. Un lecteur par message suffit pour l'instant, et la limitation est conservée volontairement : c'est elle qui rendra visible plus tard ce que Publish/Subscribe apporte réellement.
Ce sont des **boîtes aux lettres** (*mailboxes*) et non des sujets (*topics*), et la distinction mérite qu'on y insiste : si deux lecteurs appellent `take()` sur la même boîte, ils sont en concurrence — chaque message va à *un seul* d'entre eux et n'est pas copié aux deux. Un *topic*, en Publish/Subscribe, remettrait à chaque abonné sa propre copie. Un lecteur par message suffit pour l'instant, et la limitation est conservée volontairement : c'est elle qui rendra visible plus tard ce que Publish/Subscribe apporte réellement.
:::
::: {.de}
@@ -160,7 +160,7 @@ BlockingQueue<Message> mailbox(String name) {
}
```
Das Tutorial nennt diese bewusst **Postfächer** (*mailboxes*) und nicht Topics, mit Begründung: rufen zwei Leser `take()` auf demselben Postfach auf, konkurrieren sie — jede Nachricht geht an *genau einen* von ihnen und wird nicht an beide kopiert. Ein Topic in Publish/Subscribe gäbe jedem Abonnenten seine eigene Kopie. Ein Leser pro Nachricht genügt vorläufig, und die Einschränkung bleibt absichtlich bestehen: sie macht später sichtbar, was Publish/Subscribe wirklich hinzufügt.
Das sind bewusst **Postfächer** (*mailboxes*) und keine Topics, und der Unterschied ist wichtig: rufen zwei Leser `take()` auf demselben Postfach auf, konkurrieren sie — jede Nachricht geht an *genau einen* von ihnen und wird nicht an beide kopiert. Ein Topic in Publish/Subscribe gäbe jedem Abonnenten seine eigene Kopie. Ein Leser pro Nachricht genügt vorläufig, und die Einschränkung bleibt absichtlich bestehen: sie macht später sichtbar, was Publish/Subscribe wirklich hinzufügt.
:::
## [Steps 4–6 — The three capabilities become egoistic]{.en}[Étapes 4–6 — Les trois capacités deviennent égoïstes]{.fr}[Schritte 4–6 — Die drei Fähigkeiten werden egoistisch]{.de} {#sec-steps-4-6}
@@ -174,7 +174,7 @@ Each capability now touches only its own mailbox names:
| ROT13 | `rot13.inbox` | `rot13.outbox` |
| ConsoleOut | `consoleOut.inbox` | the console |
No capability contains the name of another. The tutorial's own summary of the result: "three nicely isolated capabilities. And they do absolutely nothing together." Nothing moves a message from `consoleIn.outbox` to `rot13.inbox`, or from `rot13.outbox` to `consoleOut.inbox`.
No capability contains the name of another, and that is exactly the result: three nicely isolated capabilities that do absolutely nothing together. Nothing moves a message from `consoleIn.outbox` to `rot13.inbox`, or from `rot13.outbox` to `consoleOut.inbox`.
:::
::: {.fr}
@@ -186,7 +186,7 @@ Chaque capacité ne touche plus que ses propres noms de boîtes :
| ROT13 | `rot13.inbox` | `rot13.outbox` |
| ConsoleOut | `consoleOut.inbox` | la console |
Aucune capacité ne contient le nom d'une autre. Le résumé du tutoriel lui-même : « trois capacités bien isolées. Et elles ne font absolument rien ensemble. » Rien ne déplace un message de `consoleIn.outbox` vers `rot13.inbox`, ni de `rot13.outbox` vers `consoleOut.inbox`.
Aucune capacité ne contient le nom d'une autre, et c'est exactement le résultat : trois capacités bien isolées qui ne font absolument rien ensemble. Rien ne déplace un message de `consoleIn.outbox` vers `rot13.inbox`, ni de `rot13.outbox` vers `consoleOut.inbox`.
:::
::: {.de}
@@ -198,7 +198,7 @@ Jede Fähigkeit berührt nur noch ihre eigenen Postfachnamen:
| ROT13 | `rot13.inbox` | `rot13.outbox` |
| ConsoleOut | `consoleOut.inbox` | die Konsole |
Keine Fähigkeit enthält den Namen einer anderen. Die Zusammenfassung des Tutorials selbst: „drei schön isolierte Fähigkeiten. Und sie tun zusammen absolut nichts." Nichts bewegt eine Nachricht von `consoleIn.outbox` nach `rot13.inbox` oder von `rot13.outbox` nach `consoleOut.inbox`.
Keine Fähigkeit enthält den Namen einer anderen, und genau das ist das Ergebnis: drei schön isolierte Fähigkeiten, die zusammen absolut nichts tun. Nichts bewegt eine Nachricht von `consoleIn.outbox` nach `rot13.inbox` oder von `rot13.outbox` nach `consoleOut.inbox`.
:::
## [Step 7 — Enter the mediator]{.en}[Étape 7 — Entre le médiateur]{.fr}[Schritt 7 — Auftritt des Vermittlers]{.de} {#sec-step-7}
@@ -255,7 +255,7 @@ void mediate(String from, String to) {
::: {.en}
Does ConsoleIn know ROT13? No. Does ROT13 know ConsoleIn or ConsoleOut? No. Has the topology disappeared? No — it sits in the two `mediate(...)` calls inside `main()`.
This is the tutorial's first major result:
This is the first major result:
> **Decoupling often does not make knowledge disappear. It moves knowledge to where it belongs.**
@@ -265,7 +265,7 @@ The capability "ROT13 transforms text" belongs to ROT13. The topology `ConsoleIn
::: {.fr}
ConsoleIn connaît-il ROT13 ? Non. ROT13 connaît-il ConsoleIn ou ConsoleOut ? Non. La topologie a-t-elle disparu ? Non — elle se trouve dans les deux appels `mediate(...)` à l'intérieur de `main()`.
C'est le premier résultat majeur du tutoriel :
C'est le premier résultat majeur :
> **Le découplage ne fait souvent pas disparaître la connaissance. Il la déplace là où elle appartient.**
@@ -275,7 +275,7 @@ La capacité « ROT13 transforme du texte » appartient à ROT13. La topologie `
::: {.de}
Kennt ConsoleIn ROT13? Nein. Kennt ROT13 ConsoleIn oder ConsoleOut? Nein. Ist die Topologie verschwunden? Nein — sie steckt in den zwei `mediate(...)`-Aufrufen innerhalb von `main()`.
Das ist das erste grosse Ergebnis des Tutorials:
Das ist das erste grosse Ergebnis:
> **Entkopplung lässt Wissen oft nicht verschwinden. Sie verschiebt Wissen dorthin, wo es hingehört.**
@@ -287,19 +287,19 @@ Die Fähigkeit „ROT13 transformiert Text" gehört zu ROT13. Die Topologie `Con
::: {.en}
Five loops now wait indefinitely: the keyboard, `rot13.inbox`, `consoleOut.inbox` and the two mediators' sources. Virtual threads are simply the cheap Java way to let five waits happen at once inside one JVM.
They are an implementation convenience, not an architecture. The architecture — who knows whom, and where the wiring lives — is in the mailbox names, not in the threads. The tutorial's own evidence for the separation: the same architecture will run as separate processes in step 11, with no threads shared between the parts.
They are an implementation convenience, not an architecture. The architecture — who knows whom, and where the wiring lives — is in the mailbox names, not in the threads. The evidence for the separation: the same architecture will run as separate processes in step 11, with no threads shared between the parts.
:::
::: {.fr}
Cinq boucles attendent désormais indéfiniment : le clavier, `rot13.inbox`, `consoleOut.inbox` et les sources des deux médiateurs. Les threads virtuels sont simplement le moyen Java peu coûteux de faire attendre cinq choses à la fois dans une seule JVM.
C'est une commodité d'implémentation, pas une architecture. L'architecture — qui connaît qui, et où vit le câblage — réside dans les noms de boîtes, pas dans les threads. La preuve que donne le tutoriel : la même architecture tournera en processus séparés à l'étape 11, sans aucun thread partagé entre les parties.
C'est une commodité d'implémentation, pas une architecture. L'architecture — qui connaît qui, et où vit le câblage — réside dans les noms de boîtes, pas dans les threads. La preuve de cette séparation : la même architecture tournera en processus séparés à l'étape 11, sans aucun thread partagé entre les parties.
:::
::: {.de}
Fünf Schleifen warten nun unbegrenzt: die Tastatur, `rot13.inbox`, `consoleOut.inbox` und die Quellen der zwei Vermittler. Virtuelle Threads sind einfach der billige Java-Weg, fünf Wartevorgänge gleichzeitig in einer JVM laufen zu lassen.
Sie sind eine Implementierungsbequemlichkeit, keine Architektur. Die Architektur — wer wen kennt und wo die Verdrahtung liegt — steckt in den Postfachnamen, nicht in den Threads. Der Beleg des Tutorials für die Trennung: dieselbe Architektur läuft in Schritt 11 als getrennte Prozesse, ohne geteilte Threads zwischen den Teilen.
Sie sind eine Implementierungsbequemlichkeit, keine Architektur. Die Architektur — wer wen kennt und wo die Verdrahtung liegt — steckt in den Postfachnamen, nicht in den Threads. Der Beleg für die Trennung: dieselbe Architektur läuft in Schritt 11 als getrennte Prozesse, ohne geteilte Threads zwischen den Teilen.
:::
## [Step 10 — Keep the services egoistic]{.en}[Étape 10 — Garder les services égoïstes]{.fr}[Schritt 10 — Die Dienste egoistisch halten]{.de} {#sec-step-10}
@@ -314,7 +314,7 @@ Because ROT13 would then contain the name `consoleIn.outbox`, which means it wou
| what changes | one argument of the mediator | `runRot13` itself |
| who is touched | no capability | ROT13, whose job did not change |
The tutorial is honest about the price: this design "may look indirect — even a little odd", and it promises a different way to keep services egoistic *without* a mediator in every message's path.
The price is worth stating plainly: this design may look indirect — even a little odd. There is another way to keep services egoistic *without* a mediator in every message's path, and it comes later.
:::
::: {.fr}
@@ -327,7 +327,7 @@ Parce que ROT13 contiendrait alors le nom `consoleIn.outbox`, c'est-à-dire qu'i
| ce qui change | un argument du médiateur | `runRot13` lui-même |
| qui est touché | aucune capacité | ROT13, dont le travail n'a pas changé |
Le tutoriel est honnête sur le prix : ce design « peut sembler indirect — voire un peu bizarre », et il promet une autre manière de garder les services égoïstes *sans* médiateur sur le chemin de chaque message.
Le prix mérite d'être dit clairement : ce design peut sembler indirect — voire un peu bizarre. Il existe une autre manière de garder les services égoïstes *sans* médiateur sur le chemin de chaque message ; elle viendra plus tard.
:::
::: {.de}
@@ -340,7 +340,7 @@ Weil ROT13 dann den Namen `consoleIn.outbox` enthielte, also wüsste, dass Conso
| was sich ändert | ein Argument des Vermittlers | `runRot13` selbst |
| wer berührt wird | keine Fähigkeit | ROT13, dessen Aufgabe unverändert blieb |
Das Tutorial ist ehrlich über den Preis: dieses Design „mag indirekt wirken — sogar etwas eigenartig", und es verspricht einen anderen Weg, Dienste egoistisch zu halten, *ohne* Vermittler im Pfad jeder Nachricht.
Der Preis gehört klar gesagt: dieses Design mag indirekt wirken — sogar etwas eigenartig. Es gibt einen anderen Weg, Dienste egoistisch zu halten, *ohne* Vermittler im Pfad jeder Nachricht; er kommt später.
:::
## [What part I moved]{.en}[Ce que la partie I a déplacé]{.fr}[Was Teil I verschoben hat]{.de} {#sec-part-i-result}
@@ -351,7 +351,7 @@ Das Tutorial ist ehrlich über den Preis: dieses Design „mag indirekt wirken
| step 1 | inside the capability code (`IO.println(rot13(text))`) | whoever edits that code |
| steps 7–8 | in `main()`, as pairs of mailbox names | whoever edits `main()` |
Functionality: unchanged. Lines of code: more. Parts that know each other: none. That is the trade the rest of the tutorial keeps testing.
Functionality: unchanged. Lines of code: more. Parts that know each other: none. That is the trade everything that follows keeps testing.
:::
::: {.fr}
@@ -360,7 +360,7 @@ Functionality: unchanged. Lines of code: more. Parts that know each other: none.
| étape 1 | dans le code de la capacité (`IO.println(rot13(text))`) | celui qui édite ce code |
| étapes 7–8 | dans `main()`, en paires de noms de boîtes | celui qui édite `main()` |
Fonctionnalité : inchangée. Lignes de code : davantage. Parties qui se connaissent : aucune. C'est le compromis que le reste du tutoriel continue de mettre à l'épreuve.
Fonctionnalité : inchangée. Lignes de code : davantage. Parties qui se connaissent : aucune. C'est le compromis que tout ce qui suit continue de mettre à l'épreuve.
:::
::: {.de}
@@ -369,5 +369,5 @@ Fonctionnalité : inchangée. Lignes de code : davantage. Parties qui se connais
| Schritt 1 | im Code der Fähigkeit (`IO.println(rot13(text))`) | wer diesen Code ändert |
| Schritte 7–8 | in `main()`, als Paare von Postfachnamen | wer `main()` ändert |
Funktionalität: unverändert. Codezeilen: mehr. Teile, die einander kennen: keine. Das ist der Tauschhandel, den das restliche Tutorial immer wieder prüft.
Funktionalität: unverändert. Codezeilen: mehr. Teile, die einander kennen: keine. Das ist der Tauschhandel, den alles Folgende immer wieder prüft.
:::