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
@@ -13,8 +13,8 @@ MULTILINGUAL (see _extensions/notes/i18n.lua):
|
||||
picture, just still.
|
||||
- fixed section ids (#sec-...) so anchors are identical in all three books.
|
||||
|
||||
English is the verified source: the tutorial being summarised is written in
|
||||
English. French and German are translations of it.
|
||||
English is the verified source: the material these notes are built from is
|
||||
written in English. French and German are translations of it.
|
||||
|
||||
Code identifiers, mailbox and topic names, file names, commands and protocol
|
||||
terms are never translated (consoleIn.outbox, rot13/inbox, WatchService,
|
||||
@@ -22,7 +22,7 @@ Mediator.java, .msg, put/take, Intent/Status/Event).
|
||||
-->
|
||||
|
||||
::: {.en}
|
||||
These notes summarise the tutorial **“SIN.04028 — From Calling to Eventing”**, worked through step by step. The tutorial itself lives next to this book, in `SIN.04028-From-Calling-to-Eventing/README.md`, and belongs to the *Process Control* course given by Reto Konig at the University of Fribourg (autumn semester 2026).
|
||||
These notes follow one small program through a long series of rebuilds, from direct method calls to an event-driven architecture over MQTT. Every rebuild leaves the program doing exactly what it did before, and changes who knows about whom.
|
||||
|
||||
The program under construction never changes: you type a line, it comes back rotated by 13 letters.
|
||||
|
||||
@@ -30,7 +30,7 @@ The program under construction never changes: you type a line, it comes back rot
|
||||
keyboard → ROT13 → console
|
||||
```
|
||||
|
||||
What changes is everything around it. The tutorial rebuilds the same system again and again while asking three questions, in this order:
|
||||
What changes is everything around it. The same system is rebuilt again and again, and each rebuild asks three questions, in this order:
|
||||
|
||||
> **Who knows whom?**
|
||||
>
|
||||
@@ -39,10 +39,12 @@ What changes is everything around it. The tutorial rebuilds the same system agai
|
||||
> **Who decides how the system is wired together?**
|
||||
|
||||
One summary is added here each time a step is finished, so the book grows at the pace of the work. Each summary says what the step did, what was observed when it ran, and what moved architecturally — usually a piece of knowledge that changed hands.
|
||||
|
||||
*Based on material by Reto Konig, University of Fribourg.*
|
||||
:::
|
||||
|
||||
::: {.fr}
|
||||
Ces notes résument le tutoriel **« SIN.04028 — From Calling to Eventing »**, parcouru étape par étape. Le tutoriel lui-même se trouve à côté de ce livre, dans `SIN.04028-From-Calling-to-Eventing/README.md`, et fait partie du cours *Process Control* donné par Reto Konig à l'Université de Fribourg (semestre d'automne 2026).
|
||||
Ces notes suivent un petit programme à travers une longue série de reconstructions, de l'appel de méthode direct à une architecture événementielle sur MQTT. Chaque reconstruction laisse le programme faire exactement ce qu'il faisait avant, et change qui connaît qui.
|
||||
|
||||
Le programme construit ne change jamais : vous tapez une ligne, elle revient décalée de 13 lettres.
|
||||
|
||||
@@ -50,7 +52,7 @@ Le programme construit ne change jamais : vous tapez une ligne, elle revient dé
|
||||
keyboard → ROT13 → console
|
||||
```
|
||||
|
||||
Ce qui change, c'est tout ce qui l'entoure. Le tutoriel reconstruit le même système encore et encore en posant trois questions, dans cet ordre :
|
||||
Ce qui change, c'est tout ce qui l'entoure. Le même système est reconstruit encore et encore, et chaque reconstruction pose trois questions, dans cet ordre :
|
||||
|
||||
> **Qui connaît qui ?**
|
||||
>
|
||||
@@ -59,10 +61,12 @@ Ce qui change, c'est tout ce qui l'entoure. Le tutoriel reconstruit le même sys
|
||||
> **Qui décide comment le système est câblé ?**
|
||||
|
||||
Un résumé est ajouté ici chaque fois qu'une étape est terminée : le livre grandit donc au rythme du travail. Chaque résumé dit ce que l'étape a fait, ce qui a été observé à l'exécution, et ce qui a bougé sur le plan architectural — en général une connaissance qui a changé de mains.
|
||||
|
||||
*D'après le matériel de Reto Konig, Université de Fribourg.*
|
||||
:::
|
||||
|
||||
::: {.de}
|
||||
Diese Notizen fassen das Tutorial **„SIN.04028 — From Calling to Eventing“** zusammen, Schritt für Schritt durchgearbeitet. Das Tutorial selbst liegt neben diesem Buch, in `SIN.04028-From-Calling-to-Eventing/README.md`, und gehört zur Vorlesung *Process Control* von Reto Konig an der Universität Freiburg (Herbstsemester 2026).
|
||||
Diese Notizen verfolgen ein kleines Programm durch eine lange Reihe von Neubauten, vom direkten Methodenaufruf bis zu einer ereignisgetriebenen Architektur über MQTT. Jeder Neubau lässt das Programm genau das tun, was es vorher tat, und ändert, wer von wem weiss.
|
||||
|
||||
Das gebaute Programm ändert sich nie: Sie tippen eine Zeile, sie kommt um 13 Buchstaben verschoben zurück.
|
||||
|
||||
@@ -70,7 +74,7 @@ Das gebaute Programm ändert sich nie: Sie tippen eine Zeile, sie kommt um 13 Bu
|
||||
keyboard → ROT13 → console
|
||||
```
|
||||
|
||||
Was sich ändert, ist alles ringsherum. Das Tutorial baut dasselbe System immer wieder neu und stellt dabei drei Fragen, in dieser Reihenfolge:
|
||||
Was sich ändert, ist alles ringsherum. Dasselbe System wird immer wieder neu gebaut, und jeder Neubau stellt drei Fragen, in dieser Reihenfolge:
|
||||
|
||||
> **Wer kennt wen?**
|
||||
>
|
||||
@@ -79,6 +83,8 @@ Was sich ändert, ist alles ringsherum. Das Tutorial baut dasselbe System immer
|
||||
> **Wer entscheidet, wie das System verdrahtet ist?**
|
||||
|
||||
Jedes Mal, wenn ein Schritt fertig ist, kommt hier eine Zusammenfassung hinzu; das Buch wächst also im Tempo der Arbeit. Jede Zusammenfassung sagt, was der Schritt getan hat, was beim Ausführen beobachtet wurde und was sich architektonisch verschoben hat — meist ein Stück Wissen, das den Besitzer gewechselt hat.
|
||||
|
||||
*Nach Material von Reto Konig, Universität Freiburg.*
|
||||
:::
|
||||
|
||||
## [How to read the diagrams]{.en}[Comment lire les figures]{.fr}[Wie die Abbildungen zu lesen sind]{.de} {#sec-diagrams}
|
||||
@@ -100,38 +106,3 @@ Jede Abbildung existiert einmal als Zeichnung und dreimal als Sprache. In der We
|
||||
|
||||
Im PDF und in einem Browser ohne JavaScript ist dasselbe Bild da — nur unbewegt. Nichts in diesen Notizen hängt von der Animation ab.
|
||||
:::
|
||||
|
||||
## [Building this book]{.en}[Construire ce livre]{.fr}[Dieses Buch bauen]{.de} {#sec-build}
|
||||
|
||||
::: {.en}
|
||||
The three books come from one source:
|
||||
|
||||
```bash
|
||||
./render-all.sh # figures, then html + pdf for en, fr, de
|
||||
./render-all.sh --serve # …and serve _book/ on http://localhost:8000
|
||||
```
|
||||
|
||||
`_book/` holds the English book, `_book/fr/` the French one and `_book/de/` the German one; the language menu in the sidebar switches between them and remembers the choice. A single `quarto render` builds English only and empties `_book/`, which removes the other two — so use the script.
|
||||
:::
|
||||
|
||||
::: {.fr}
|
||||
Les trois livres proviennent d'une source unique :
|
||||
|
||||
```bash
|
||||
./render-all.sh # figures, puis html + pdf pour en, fr, de
|
||||
./render-all.sh --serve # …puis sert _book/ sur http://localhost:8000
|
||||
```
|
||||
|
||||
`_book/` contient le livre anglais, `_book/fr/` le français et `_book/de/` l'allemand ; le menu de langue dans la barre latérale passe de l'un à l'autre et retient le choix. Un simple `quarto render` ne construit que l'anglais et vide `_book/`, ce qui supprime les deux autres — utilisez donc le script.
|
||||
:::
|
||||
|
||||
::: {.de}
|
||||
Die drei Bücher entstehen aus einer einzigen Quelle:
|
||||
|
||||
```bash
|
||||
./render-all.sh # Abbildungen, dann html + pdf für en, fr, de
|
||||
./render-all.sh --serve # …und _book/ auf http://localhost:8000 ausliefern
|
||||
```
|
||||
|
||||
`_book/` enthält das englische Buch, `_book/fr/` das französische und `_book/de/` das deutsche; das Sprachmenü in der Seitenleiste wechselt zwischen ihnen und merkt sich die Wahl. Ein einfaches `quarto render` baut nur Englisch und leert `_book/`, was die anderen zwei entfernt — also das Skript benutzen.
|
||||
:::
|
||||
Reference in new issue
Block a user