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:
1 parent
afb816f459
commit
f7fa60ba81
62 files changed
+3552
-852
No files matched your search
+21
-21
@@ -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.
|
||||
:::
|
||||
Reference in new issue
Block a user