Parts V to IX in the book, extension 2.9.1, Demo topics
Add chapters 05-08 to the three language profiles: the published book stopped at Part IV because only 00-04 were listed. Rename the MQTT topic root Tutorial/ to Demo/ in Part IX (code and output included). Shared notes extension 2.9.1: dependency folders are named after the extension version, so browsers stop serving stale scripts after an update. Full rebuild of _book/ (HTML and PDF, three languages); remove the stray site_libs/ that the last Deploy commit had added at the project root. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
1 parent
01f681165f
commit
f047b9c7ae
128 files changed
+18893
-7591
No files matched your search
@@ -52,19 +52,19 @@ ul.task-list li input[type="checkbox"] {
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -510,6 +510,30 @@ ul.task-list li input[type="checkbox"] {
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
|
||||
@@ -87,19 +87,19 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -545,6 +545,30 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
|
||||
@@ -87,19 +87,19 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -545,6 +545,30 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
|
||||
@@ -52,19 +52,19 @@ ul.task-list li input[type="checkbox"] {
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -510,6 +510,30 @@ ul.task-list li input[type="checkbox"] {
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
|
||||
@@ -71,7 +71,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<script src="site_libs/quarto-search/fuse.min.js"></script>
|
||||
<script src="site_libs/quarto-search/quarto-search.js"></script>
|
||||
<meta name="quarto:offset" content="./">
|
||||
<link href="./glossary.html" rel="next">
|
||||
<link href="./05-part-v-subscriptions.html" rel="next">
|
||||
<link href="./03-part-iii-distributed.html" rel="prev">
|
||||
<script src="site_libs/quarto-html/quarto.js" type="module"></script>
|
||||
<script src="site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
|
||||
@@ -87,19 +87,19 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -545,6 +545,30 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link active">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
@@ -604,7 +628,7 @@ pre > code.sourceCode > span > a:first-child::before { text-decoration: underlin
|
||||
|
||||
|
||||
<!-- MULTILINGUAL: see the comment at the top of index.qmd. -->
|
||||
<p>Les étapes 28 à 34 reviennent volontairement à une seule JVM. Sans délai de réplication ni cinq terminaux, la seule chose qui peut changer est qui connaît qui — l’idée s’essaie donc en quelques secondes plutôt qu’au cours d’une séance de débogage distribué.</p>
|
||||
<p>Les étapes 28 à 34 reviennent volontairement à une seule JVM. Sans délai de réplication ni cinq terminaux, la seule chose qui peut changer est qui connaît qui — l’idée s’essaie donc en quelques secondes plutôt que pendant une séance de débogage distribué.</p>
|
||||
<section id="sec-the-trap" class="level2" data-number="5.1">
|
||||
<h2 data-number="5.1" class="anchored" data-anchor-id="sec-the-trap"><span class="header-section-number">5.1</span> Le raccourci évident, et son piège</h2>
|
||||
<p>Si le premier médiateur ne fait que copier des messages, supprimons-le et laissons ROT13 lire la source lui-même :</p>
|
||||
@@ -1281,8 +1305,8 @@ Producteur → Médiateur → Consommateur Intent → (Producteur ──► Co
|
||||
</a>
|
||||
</div>
|
||||
<div class="nav-page nav-page-next">
|
||||
<a href="./glossary.html" class="pagination-link" aria-label="[Glossary]{.en}[Glossaire]{.fr}[Glossar]{.de}">
|
||||
<span class="nav-page-text">Glossaire</span> <i class="bi bi-arrow-right-short"></i>
|
||||
<a href="./05-part-v-subscriptions.html" class="pagination-link" aria-label="[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}">
|
||||
<span class="nav-page-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span> <i class="bi bi-arrow-right-short"></i>
|
||||
</a>
|
||||
</div>
|
||||
</nav>
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
File diff suppressed because it is too large.
Load diff
Binary file not shown.
+40
-16
@@ -36,7 +36,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
<script src="site_libs/quarto-search/fuse.min.js"></script>
|
||||
<script src="site_libs/quarto-search/quarto-search.js"></script>
|
||||
<meta name="quarto:offset" content="./">
|
||||
<link href="./04-part-iv-rewind.html" rel="prev">
|
||||
<link href="./08-part-ix-mqtt.html" rel="prev">
|
||||
<script src="site_libs/quarto-html/quarto.js" type="module"></script>
|
||||
<script src="site_libs/quarto-html/tabsets/tabsets.js" type="module"></script>
|
||||
<script src="site_libs/quarto-html/popper.min.js"></script>
|
||||
@@ -51,19 +51,19 @@ ul.task-list li input[type="checkbox"] {
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -509,6 +509,30 @@ ul.task-list li input[type="checkbox"] {
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
@@ -1211,8 +1235,8 @@ Every entry here is defined in the chapter where the term first does some
|
||||
</script>
|
||||
<nav class="page-navigation">
|
||||
<div class="nav-page nav-page-previous">
|
||||
<a href="./04-part-iv-rewind.html" class="pagination-link" aria-label="[Part IV — Rewind]{.en}[Partie IV — Rembobinage]{.fr}[Teil IV — Zurückspulen]{.de}">
|
||||
<i class="bi bi-arrow-left-short"></i> <span class="nav-page-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span>
|
||||
<a href="./08-part-ix-mqtt.html" class="pagination-link" aria-label="[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}">
|
||||
<i class="bi bi-arrow-left-short"></i> <span class="nav-page-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span>
|
||||
</a>
|
||||
</div>
|
||||
<div class="nav-page nav-page-next">
|
||||
|
||||
+38
-14
@@ -52,19 +52,19 @@ ul.task-list li input[type="checkbox"] {
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme" id="quarto-bootstrap" data-mode="light">
|
||||
<link href="site_libs/bootstrap/bootstrap-dark-0fb591fb534e4de6e0a74f855bd29ac7.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme quarto-color-alternate" id="quarto-bootstrap" data-mode="dark">
|
||||
<link href="site_libs/bootstrap/bootstrap-e333b860288efea83b591af437d45305.min.css" rel="stylesheet" append-hash="true" class="quarto-color-scheme-extra" id="quarto-bootstrap" data-mode="light">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.0.0/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.0.0/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-1.0.0/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-1.0.0/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-1.0.0/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-1.0.0/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.0.0/glossary.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-exo-2.9.1/exo.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-exo-2.9.1/exo.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-quiz-2.9.1/quiz.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-further-2.9.1/further.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-latex-tables-2.9.1/latex-tables.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/theme.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/high-contrast.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/calc-notes.css" rel="stylesheet">
|
||||
<link href="site_libs/quarto-contrib/calc-notes-2.9.1/narrow.css" rel="stylesheet">
|
||||
<script src="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.js"></script>
|
||||
<link href="site_libs/quarto-contrib/calc-glossary-2.9.1/glossary.css" rel="stylesheet">
|
||||
<script id="quarto-search-options" type="application/json">{
|
||||
"location": "sidebar",
|
||||
"copy-button": false,
|
||||
@@ -510,6 +510,30 @@ ul.task-list li input[type="checkbox"] {
|
||||
<a href="./04-part-iv-rewind.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">5</span> <span class="chapter-title">Partie IV — Rembobinage</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./05-part-v-subscriptions.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">6</span> <span class="chapter-title">Partie V — Rejouer l’idée dynamique entre processus</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./06-part-vi-vocabulary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">7</span> <span class="chapter-title">Partie VI — Rejouer sur Syncthing, et nommer les messages</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./07-part-vii-mediation.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">8</span> <span class="chapter-title">Partie VII — Fusionner les deux idées architecturales</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./08-part-ix-mqtt.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text"><span class="chapter-number">9</span> <span class="chapter-title">Partie IX — MQTT</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
@@ -568,7 +592,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
<div>
|
||||
<div class="quarto-title-meta-heading">Date de publication</div>
|
||||
<div class="quarto-title-meta-contents">
|
||||
<p class="date">6 octobre 2026</p>
|
||||
<p class="date">16 octobre 2026</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
+231
-1
@@ -284,7 +284,7 @@
|
||||
"href": "04-part-iv-rewind.html",
|
||||
"title": "5 Partie IV — Rembobinage",
|
||||
"section": "",
|
||||
"text": "5.1 Le raccourci évident, et son piège\nLes étapes 28 à 34 reviennent volontairement à une seule JVM. Sans délai de réplication ni cinq terminaux, la seule chose qui peut changer est qui connaît qui — l’idée s’essaie donc en quelques secondes plutôt qu’au cours d’une séance de débogage distribué.\nSi le premier médiateur ne fait que copier des messages, supprimons-le et laissons ROT13 lire la source lui-même :\nLe médiateur a disparu. Mais posons la question récurrente : ROT13 contient désormais le nom de la boîte de ConsoleIn. La topologie a quitté le médiateur pour entrer dans le service. Comme le dit le matériel : « nous avons supprimé le médiateur… et remis la topologie dans le service. Oups. »",
|
||||
"text": "5.1 Le raccourci évident, et son piège\nLes étapes 28 à 34 reviennent volontairement à une seule JVM. Sans délai de réplication ni cinq terminaux, la seule chose qui peut changer est qui connaît qui — l’idée s’essaie donc en quelques secondes plutôt que pendant une séance de débogage distribué.\nSi le premier médiateur ne fait que copier des messages, supprimons-le et laissons ROT13 lire la source lui-même :\nLe médiateur a disparu. Mais posons la question récurrente : ROT13 contient désormais le nom de la boîte de ConsoleIn. La topologie a quitté le médiateur pour entrer dans le service. Comme le dit le matériel : « nous avons supprimé le médiateur… et remis la topologie dans le service. Oups. »",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>5</span> <span class='chapter-title'>[Part IV — Rewind]{.en}[Partie IV — Rembobinage]{.fr}[Teil IV — Zurückspulen]{.de}</span>"
|
||||
]
|
||||
@@ -329,6 +329,236 @@
|
||||
"<span class='chapter-number'>5</span> <span class='chapter-title'>[Part IV — Rewind]{.en}[Partie IV — Rembobinage]{.fr}[Teil IV — Zurückspulen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "05-part-v-subscriptions.html",
|
||||
"href": "05-part-v-subscriptions.html",
|
||||
"title": "6 Partie V — Rejouer l’idée dynamique entre processus",
|
||||
"section": "",
|
||||
"text": "6.1 Une observation bloquante ne suffit pas\nLes étapes 35 à 38 sortent l’idée d’abonnement de la JVM unique. Les services redeviennent des programmes séparés, mais au lieu de médiateurs qui copient des fichiers, chaque service observe la boîte qu’on lui a indiquée. Une hypothèse du premier utilitaire de fichiers ne survit pas au déplacement, et c’est bien de la corriger qu’il s’agit ici.\nFileMessageBoard.watch(topic, receiver) enregistre un répertoire et se bloque indéfiniment. Cela suffisait tant que chaque processus observait une boîte fixe. Un service câblé dynamiquement demande davantage :\nL’ancienne signature ne peut pas exprimer cela, et la conséquence était déjà visible : le médiateur configurable n’acceptait qu’une seule ROUTE, car dès qu’il observait sa source il devenait sourd à sa propre boîte de contrôle. La limite n’a jamais été de qui est le répertoire, mais un seul, fixe, pour toujours.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>6</span> <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "05-part-v-subscriptions.html#sec-watch-limit",
|
||||
"href": "05-part-v-subscriptions.html#sec-watch-limit",
|
||||
"title": "6 Partie V — Rejouer l’idée dynamique entre processus",
|
||||
"section": "",
|
||||
"text": "observer en permanence sa propre boîte de contrôle\nET\najouter un répertoire observé à l'exécution\nET\néventuellement le retirer ensuite",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>6</span> <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "05-part-v-subscriptions.html#sec-filesubscriptions",
|
||||
"href": "05-part-v-subscriptions.html#sec-filesubscriptions",
|
||||
"title": "6 Partie V — Rejouer l’idée dynamique entre processus",
|
||||
"section": "6.2 L’utilitaire : FileSubscriptions",
|
||||
"text": "6.2 L’utilitaire : FileSubscriptions\nUn seul WatchService peut servir plusieurs répertoires. register(...) retourne un WatchKey qui en identifie un, watcher.take() retourne la clé qui a des événements, et key.cancel() la désenregistre. L’utilitaire garde les deux sens, nom → clé et clé → nom, pour qu’un événement puisse être rattaché à la boîte dont il vient.\nLes événements n’arrivent pas directement dans un callback. Ils passent par une file, lue avec take(), et portent\nrecord IncomingMessage(String mailbox, Message message) {}\nDeux raisons, l’ordre d’arrivée n’étant que la troisième. D’abord, le thread observateur doit rester réactif pour tous les répertoires abonnés : un callback qui transforme, publie ou bloque arrêterait l’observation de tous les autres. Ensuite, le nom de la boîte voyage avec le message, de sorte qu’une seule boucle du service peut décider de son sens — boîte de contrôle, donc un Intent à appliquer ; source abonnée, donc des données à transformer — et cette même boucle peut ajouter ou retirer des abonnements, puisqu’elle n’est pas prisonnière d’un callback.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>6</span> <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "05-part-v-subscriptions.html#sec-two-publications",
|
||||
"href": "05-part-v-subscriptions.html#sec-two-publications",
|
||||
"title": "6 Partie V — Rejouer l’idée dynamique entre processus",
|
||||
"section": "6.3 Deux publications au lieu de quatre",
|
||||
"text": "6.3 Deux publications au lieu de quatre\nLancez SensorService, DynamicProcessorService et DynamicActuatorService — sans médiateurs — puis laissez Configure.java publier les deux messages TOPIC. Une ligne tapée ensuite laisse exactement deux publications applicatives dans le tableau :\n\n\n\nboîte\ncontenu\nnature\n\n\n\n\nconsoleIn/outbox\nTEXT hello\nl’entrée\n\n\nrot13/outbox\nTEXT uryyb\nle résultat\n\n\nrot13/inbox\nTOPIC consoleIn/outbox\nIntent, publié une fois\n\n\nconsoleOut/inbox\nTOPIC rot13/outbox\nIntent, publié une fois\n\n\n\nconsoleOut/inbox ne contient aucune charge utile : ConsoleOut retire directement de rot13/outbox. Sa boîte a changé de métier, des messages vers le câblage.\nUne ligne tapée avant l’exécution de Configure.java reste dans consoleIn/outbox pour toujours. Un abonnement qui n’existe pas encore manque ce qui l’a précédé — le même constat que le médiateur redémarré qui n’a rien livré.\n\n\n\n\n\n\n\n\nversion\npublications applicatives\nprocessus dans le chemin des données\n\n\n\n\nmédiée (étape 18)\n4\n5\n\n\nmédiateur configurable (étape 27)\n4\n5\n\n\ndynamique (étape 38)\n2\n3",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>6</span> <span class='chapter-title'>[Part V — Replay the dynamic idea across processes]{.en}[Partie V — Rejouer l'idée dynamique entre processus]{.fr}[Teil V — Die dynamische Idee über Prozesse hinweg wiederholen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "06-part-vi-vocabulary.html",
|
||||
"href": "06-part-vi-vocabulary.html",
|
||||
"title": "7 Partie VI — Rejouer sur Syncthing, et nommer les messages",
|
||||
"section": "",
|
||||
"text": "7.1 L’exécution dynamique distribuée\nLes étapes 39 à 47 répartissent la version dynamique sur deux machines, précisent ce que « direct » veut dire, puis — maintenant seulement, après avoir utilisé les idées — donnent leurs noms aux trois sortes de messages : Intent, Status, Event.\nCapteur sur une machine, ROT13 et l’actionneur sur l’autre, aucun médiateur. Après la réplication des deux Intents TOPIC, une ligne tapée a produit le résultat sur l’autre machine — et le tableau montre ce que cela coûte :\nLe temps est la partie intéressante. L’entrée a été publiée à 02:35:12 et les résultats sont apparus sur la première machine à 04:11:28,797 et ,893 — à 96 ms d’écart, bien après l’entrée. Syncthing était saturé pendant la nuit : le lot est arrivé quand la file s’est vidée. La chaîne est restée correcte ; la latence du transport n’est tout simplement pas contrôlée par l’architecture. À comparer aux 24 ms de la même chaîne sur une seule machine.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>7</span> <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "06-part-vi-vocabulary.html#sec-distributed-dynamic",
|
||||
"href": "06-part-vi-vocabulary.html#sec-distributed-dynamic",
|
||||
"title": "7 Partie VI — Rejouer sur Syncthing, et nommer les messages",
|
||||
"section": "",
|
||||
"text": "consoleIn/outbox : l’entrée ;\nrot13/outbox : le résultat, écrit par le service qui l’a produit ;\nconsoleOut/inbox : de l’Intent seulement, là où la version médiée contenait une copie complète de chaque message.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>7</span> <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "06-part-vi-vocabulary.html#sec-direct-precisely",
|
||||
"href": "06-part-vi-vocabulary.html#sec-direct-precisely",
|
||||
"title": "7 Partie VI — Rejouer sur Syncthing, et nommer les messages",
|
||||
"section": "7.2 Ce que « direct » veut dire, exactement",
|
||||
"text": "7.2 Ce que « direct » veut dire, exactement\nDeux sauts qui se ressemblent sont architecturalement opposés :\n\nun saut de transport — Syncthing de chaque côté, éventuellement un relais entre les deux — n’ajoute aucun participant qui connaisse la topologie, et rien n’y réagit. Si les paquets passaient par un autre continent, aucune affirmation ici ne serait contredite.\nun saut architectural — un médiateur copiant consoleIn/outbox → rot13/inbox — ajoute un composant qui doit connaître les deux noms, se place dans la chaîne de disponibilité et republie le message.\n\nL’affirmation défendable est donc : ROT13 réagit à la publication de ConsoleIn sans aucun de nos composants entre les deux, et sans contenir l’identité de ConsoleIn. Et non : les données vont directement de A à B. L’architecture décide à quels messages un service réagit, pas du routage du transport.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>7</span> <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "06-part-vi-vocabulary.html#sec-ise",
|
||||
"href": "06-part-vi-vocabulary.html#sec-ise",
|
||||
"title": "7 Partie VI — Rejouer sur Syncthing, et nommer les messages",
|
||||
"section": "7.3 Intent, Status, Event",
|
||||
"text": "7.3 Intent, Status, Event\nTrois sortes de messages, nommées seulement après avoir été utilisées :\n\n\n\n\n\n\n\n\n\ndit\nnos exemples\n\n\n\n\nE — Event\nquelque chose est arrivé\nTEXT hello comme ConsoleIn/E/text ; TEXT uryyb comme ROT13/E/crypted\n\n\nS — Status/State\nquelque chose est actuellement vrai\nROT13/S/subscriptions — pas encore publié par notre système\n\n\nI — Intent\nce qui devrait arriver\nTOPIC consoleIn/outbox, ROUTE … …\n\n\n\nLe passé composé est un bon indice pour les Events. Pour l’Intent, le test tient en deux questions : le message rapporte-t-il quelque chose qui est arrivé ? Non. Quelque chose d’actuellement vrai ? Non. Alors il demande un comportement.\nUn piège : publier un Intent est bien sûr quelque chose qui est arrivé. Il faut classer d’après ce que dit le message, non d’après son existence — sinon tout devient Event et le vocabulaire ne sert plus à rien.\nLe Status mérite une note, car l’instinct est de le demander : « quels sont tes abonnements ? » Mais demander, c’est appeler, et un appel exige que le demandeur connaisse le composant, le sache en vie, et attende. Le Status se publie : ROT13 publie ROT13/S/subscriptions dès que son câblage change, et quiconque s’y intéresse le lit. Le lecteur a alors besoin d’un sujet, pas d’un composant, et ROT13 n’apprend jamais qui l’audite. Chaque sorte répond à une question différente :\n\nun Event n’est utile que si l’on écoutait — nos messages bloqués, trois fois de suite ;\nun Status est ce dont un nouveau venu a besoin : la valeur actuelle, sans rejouer l’histoire ;\nun Intent demande un changement.\n\nEt les commandes ne sont pas interdites. Envoyer ROT13/I avec ACTION Hello ressemble à une commande, et le verdict du matériel est « Fine. » Le composant exerce sa capacité et publie ses Events et son Status. Le flux retenu est Intent → composant → State + Events.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>7</span> <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "06-part-vi-vocabulary.html#sec-one-writer",
|
||||
"href": "06-part-vi-vocabulary.html#sec-one-writer",
|
||||
"title": "7 Partie VI — Rejouer sur Syncthing, et nommer les messages",
|
||||
"section": "7.4 La règle de l’écrivain unique",
|
||||
"text": "7.4 La règle de l’écrivain unique\n\nToute ressource écrivable a exactement une autorité d’écriture.\n\nNe pas confondre avec l’UUID du nom de fichier. L’UUID empêche deux publications de choisir le même nom physique ; l’autorité d’écriture dit quel composant possède une ressource logique d’Event ou de Status. Deux écrivains n’entrent jamais en collision sur un nom de fichier, et c’est précisément pour cela que le problème passe inaperçu.\nCe que coûte un second écrivain : le nom de la boîte était le seul marqueur de provenance, donc rot13/outbox cesse de signifier « ROT13 a transformé ceci » et un abonné ne peut plus faire confiance au contrat sur lequel il s’appuie. Pour le Status c’est pire — deux composants prétendant chacun publier la valeur actuelle d’un même fait se contredisent, sans aucune garantie d’ordre entre machines pour trancher. Pour des Events en ajout seul, de nombreuses publications coexistent par construction ; la question est la propriété sémantique, pas la collision. Quand deux autorités apparaissent, demandez pourquoi il y en a deux plutôt que de sortir un verrou.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>7</span> <span class='chapter-title'>[Part VI — Replay it over Syncthing, and name the messages]{.en}[Partie VI — Rejouer sur Syncthing, et nommer les messages]{.fr}[Teil VI — Über Syncthing wiederholen und die Nachrichten benennen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "07-part-vii-mediation.html",
|
||||
"href": "07-part-vii-mediation.html",
|
||||
"title": "8 Partie VII — Fusionner les deux idées architecturales",
|
||||
"section": "",
|
||||
"text": "8.1 Un transformateur mérite d’exister\nDeux médiateurs ont été supprimés et le gain mesuré. Les étapes 48 à 52 répondent à la question suivante, évidente : la médiation est-elle pour autant mauvaise ? Non — et la distinction qui tranche est assez nette pour s’appliquer à une conception qu’on n’a jamais vue.\nCe qui a été supprimé, c’est un médiateur calculant A → A : une fonction identité coûteuse, dans la chaîne de disponibilité, copiant chaque message sans rien y ajouter.\nPrenons maintenant un producteur publiant {\"value\":\"Hello\"} et un consommateur attendant une structure d’affichage. Un TextToDisplayTransformer entre les deux apporte transformation de schéma, adaptation sémantique, éventuellement conversion d’unités, éventuellement agrégation. C’est un travail qu’aucun des deux ne devrait porter : ROT13 n’a pas à décider des couleurs du terminal, et la console n’a pas à comprendre la forme de la charge utile de ROT13.\nLa ligne se trace par la compatibilité des contrats, non par le fait d’ajouter quelque chose. Un médiateur convertissant des Celsius en Fahrenheit modifie au lieu d’ajouter et mérite sa place ; un médiateur ajoutant un horodatage à un message que le consommateur comprend déjà a ajouté quelque chose et reste suspect. La question est toujours : le consommateur pourrait-il lire le message du producteur tel quel ?",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>8</span> <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "07-part-vii-mediation.html#sec-transformer",
|
||||
"href": "07-part-vii-mediation.html#sec-transformer",
|
||||
"title": "8 Partie VII — Fusionner les deux idées architecturales",
|
||||
"section": "",
|
||||
"text": "Si un consommateur comprend sémantiquement la publication d’un producteur, l’abonnement direct suffit souvent. Si les contrats sont incompatibles, introduire un transformateur qui effectue une adaptation réelle.\nUn médiateur qui ne fait que transmettre des données compatibles est suspect. Un médiateur qui ajoute la sémantique nécessaire mérite d’exister.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>8</span> <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "07-part-vii-mediation.html#sec-egoistic-transformer",
|
||||
"href": "07-part-vii-mediation.html#sec-egoistic-transformer",
|
||||
"title": "8 Partie VII — Fusionner les deux idées architecturales",
|
||||
"section": "8.2 Le transformateur est égoïste aussi",
|
||||
"text": "8.2 Le transformateur est égoïste aussi\nInséré dans la chaîne, le transformateur s’abonne à rot13/outbox et publie dans sa propre boîte de sortie ; ConsoleOut s’abonne alors à celle du transformateur plutôt qu’à celle de ROT13. Notez ce que cela coûte en code : rien. ConsoleOut reçoit un autre Intent — TOPIC display/outbox au lieu de TOPIC rot13/outbox — et la chaîne est recâblée. ROT13 n’apprend jamais que le transformateur existe ; le transformateur n’apprend jamais que ConsoleOut existe.\nPourquoi ne pas publier directement dans consoleOut/inbox, en économisant une boîte ? Quatre raisons :\n\nconnaissance — il contiendrait le nom de ConsoleOut, c’est-à-dire de la topologie dans un service, la rechute de l’étape 28 ;\npropriété — cette boîte est le canal de contrôle de ConsoleOut, écrit par le configurateur ; une charge utile venue du transformateur lui donnerait deux autorités ;\nportée — sa propre boîte peut être lue par un journal, une vue web ou un second affichage sans frais, alors qu’une boîte d’entrée ne sert qu’un consommateur ;\nmutabilité — un agrégateur peut être inséré ensuite en envoyant un autre Intent, sans modifier aucun composant.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>8</span> <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "07-part-vii-mediation.html#sec-complete-filesystem",
|
||||
"href": "07-part-vii-mediation.html#sec-complete-filesystem",
|
||||
"title": "8 Partie VII — Fusionner les deux idées architecturales",
|
||||
"section": "8.3 L’architecture complète sur système de fichiers",
|
||||
"text": "8.3 L’architecture complète sur système de fichiers\nChaque boîte avec exactement un écrivain :\n\n\n\n\n\n\n\nboîte\nécrivain unique\n\n\n\n\nconsoleIn/outbox\nSensorService\n\n\nrot13/outbox\nProcessorService\n\n\ndisplay/outbox\nle transformateur\n\n\nchaque boîte de contrôle\nle configurateur — l’unique autorité d’Intent désignée\n\n\nle terminal\nActuatorService, qui n’écrit aucune boîte\n\n\n\nDes capacités égoïstes, l’Intent venant d’une seule autorité, un transformateur seulement là où les contrats diffèrent, un écrivain par ressource, et la topologie nulle part dans les capacités. C’est la conception que le système de fichiers a suffi à enseigner — et la partie suivante demande à quoi le système de fichiers, lui, ne suffit plus.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>8</span> <span class='chapter-title'>[Part VII — Now merge the two architectural ideas]{.en}[Partie VII — Fusionner les deux idées architecturales]{.fr}[Teil VII — Die zwei architektonischen Ideen zusammenführen]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html",
|
||||
"href": "08-part-ix-mqtt.html",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "",
|
||||
"text": "9.1 Ce que le système de fichiers a enseigné, et ce pour quoi il n’est pas fait\nLe système de fichiers a enseigné les frontières de publication, les répertoires comme adresses, l’observation, des processus indépendants, des langages indépendants, la latence de synchronisation, le câblage à l’exécution, le State, l’Intent, les Events, le coût des médiateurs, la propriété des services et les services transformateurs. Ce fut un bon professeur, et ce n’est pas un courtier de messages élégant : à la fin, l’architecture était propre et le transport était un amas de fichiers .tmp, de déplacements atomiques, de rescans, de chemins partagés et de délais de réplication.\nLa conclusion n’est pas « fichiers mauvais, MQTT bon ». Le système de fichiers a un avantage que MQTT ne peut égaler — il stocke couramment des gigaoctets ou des téraoctets, alors que courtiers et clients sont conçus pour de petits messages, et découper une charge énorme sur MQTT revient à inventer un protocole de transfert de fichiers dans un protocole de messages. Donc :\nUn système de fichiers répliqué donne aussi à chaque machine une copie locale, ce qui est une vraie force — mais la réplication n’est pas une sauvegarde : suppressions et corruptions se répliquent aussi, à moins qu’un versionnement conserve les copies antérieures.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-filesystem-verdict",
|
||||
"href": "08-part-ix-mqtt.html#sec-filesystem-verdict",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "",
|
||||
"text": "Utilisez les messages pour la coordination et les événements. Utilisez un stockage de fichiers ou d’objets adapté pour les grandes données. Un message peut porter l’emplacement, l’identité et les métadonnées de ces données au lieu des téraoctets eux-mêmes.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-mqtt-mapping",
|
||||
"href": "08-part-ix-mqtt.html#sec-mqtt-mapping",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.2 MQTT devrait sembler familier",
|
||||
"text": "9.2 MQTT devrait sembler familier\n\n\n\n\n\n\n\nsystème de fichiers / Syncthing\nMQTT\n\n\n\n\nracine du tableau de messages synchronisé\ncourtier / espace de noms\n\n\nchemin de répertoire\nsujet (topic)\n\n\nfichier .msg\npublication\n\n\ncontenu du fichier\ncharge utile\n\n\nWatchService\nabonnement\n\n\nrépertoire dynamique\nsujet / filtre\n\n\nrépertoire de contrôle\nI\n\n\nrépertoire d’état\nS/…\n\n\nrépertoire d’événements\nE/…\n\n\n\nLa réaction visée par le matériel : « Ah. Nous connaissons déjà cette architecture. » MQTT est un changement de transport, pas une affirmation architecturale.\nDeux choses qu’un répertoire ne pouvait pas faire, visibles en une minute en ligne de commande. Une publication faite avant l’existence d’un abonné ne lui parvient jamais — le constat des messages bloqués, pour la troisième fois, mais avec une réponse que le système de fichiers n’avait pas. Et un filtre comme test/# correspond à test/a et test/a/b/c mais pas à testing/x, car # travaille par niveaux et non par préfixes de chaîne ; test/+ ne correspondrait qu’à un seul niveau.\nLa correction plus profonde : un sujet n’est pas un conteneur. Il n’existe aucun objet nommé test/a sur le courtier. Un sujet est une clé de routage portée par chaque publication et confrontée aux filtres de qui est abonné à cet instant. Les répertoires contiennent les messages ; les sujets les filtrent. Un seul abonnement couvre donc des sujets qui n’existent pas encore — là où un tableau de messages exigeait un nouveau répertoire et un nouvel enregistrement.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-paho",
|
||||
"href": "08-part-ix-mqtt.html#sec-paho",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.3 La bibliothèque, l’identifiant client et l’adresse du courtier",
|
||||
"text": "9.3 La bibliothèque, l’identifiant client et l’adresse du courtier\nJava n’a pas de client MQTT dans sa bibliothèque standard ; Paho arrive donc maintenant — après le besoin, comme le médiateur à l’étape 7 et Jackson à l’étape 64. Quatre choses suffisent : se connecter, publier, s’abonner, rappeler. La connexion est volontairement anticlimatique : « Rien d’architectural ne s’est produit ici. Nous avons simplement attaché notre processus au transport. »\nDeux détails de la connexion comptent :\n\nl’identifiant client n’est pas qu’un jeton d’unicité. Le courtier reconnaît par lui un client qui revient et conserve son état de session : abonnements, messages en file en QoS > 0, et l’association à sa dernière volonté. Un répertoire ne savait jamais qui l’observait, et c’est précisément pour cela qu’un observateur redémarré ne rejouait rien.\nl’adresse du courtier est de la configuration de déploiement : chaque programme lit System.getProperty(\"mqtt.broker\", \"tcp://localhost:1883\"). C’est aussi la seule configuration qui ne peut pas arriver par Intent, puisque l’Intent passe par le courtier. La topologie se publie ; l’adresse de ce qui la publie, non.\n\nS’abonner coûte un paquet, et le courtier détient la liste des abonnements. Il n’existe aucun moyen standard de lui demander à quoi un autre client s’est abonné — d’où S/subscriptions : la déclaration par un composant de son propre câblage, publiée pour que l’architecture sache ce que le transport garde privé. Seul son propriétaire peut la publier, par la règle de l’écrivain unique, car seul lui sait ce qu’il a accepté.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-structured-intent",
|
||||
"href": "08-part-ix-mqtt.html#sec-structured-intent",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.4 Intent structuré, et deux mappeurs",
|
||||
"text": "9.4 Intent structuré, et deux mappeurs\nTOPIC some/path a un champ et un sens. Il ne peut pas dire de quel type d’Intent il s’agit, porter un second paramètre, s’imbriquer ou s’étendre ; et un récepteur n’a rien contre quoi valider. Un Intent plus riche demande une structure :\nsubscribe:\n topic: Demo/ConsoleIn/U/alice/E/text\nC’est seulement là qu’une bibliothèque de sérialisation a une tâche claire. JsonTools garde deux mappeurs, et l’asymétrie est voulue :\n\nen entrée, une fabrique YAML avec FAIL_ON_UNKNOWN_PROPERTIES désactivé — JSON étant un sous-ensemble de YAML, un Intent tapé à la main est accepté, et un configurateur plus récent peut envoyer des champs qu’un service plus ancien ignore ;\nl’écriture utilise du JSON strict avec INDENT_OUTPUT activé, donc les charges publiées sont strictes et lisibles.\n\nTolérant en entrée, strict en sortie. Un mappeur unique devrait renoncer à l’un des deux.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-duise",
|
||||
"href": "08-part-ix-mqtt.html#sec-duise",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.5 DUISE, et recâbler un système en marche",
|
||||
"text": "9.5 DUISE, et recâbler un système en marche\nLe schéma de nommage reçoit enfin son nom : Description (quels contrats ce service comprend et publie), Unit (quelle instance), Intent (comportement demandé), Status (ce qui est vrai maintenant), Event (ce qui est arrivé).\nDemo/ROT13/U/alice/{I, S/online, S/subscriptions/text, E/crypted}\nU/<unit> est ce dont le système de fichiers n’avait pas besoin : chaque machine avait sa réplique du même chemin relatif, l’identité d’instance était implicite. MQTT a un espace de noms partagé : un sujet doit donc dire quelle copie. Coder en dur U/alice dans une capacité est donc pire que de coder en dur consoleIn.outbox : cela lie la compilation à un déploiement. Configuré par Intent, une seule compilation sert tout le monde — d’où les trois noms d’unité en arguments de MqttConfigure. Les noms d’unité sont la topologie.\nRecâblage observé sur un système en marche : publiez un nouvel Intent nommant une autre source, et le service se désabonne de l’ancienne, s’abonne à la nouvelle et republie S/subscriptions en conséquence. Sans redémarrage, sans édition. Envoyez au contraire un filtre invalide — Demo/#/E/text, où # n’est pas le dernier niveau — et MqttTools.isValidFilter le rejette ; l’ancien abonnement demeure et le Status continue de dire vrai.\nCe rejet révèle une vraie lacune, à nommer plutôt qu’à cacher : il n’est journalisé que localement. Le configurateur ne peut savoir si son Intent a été appliqué ou refusé, et un moniteur ne peut distinguer « refusé » de « pas encore traité ». Dans cette conception, l’émetteur apprend le résultat en lisant le Status et en le comparant à sa demande. Publier les refus comme Event, ou un Status de dernière erreur, combleraient la lacune ; ni l’un ni l’autre n’est dans le matériel : c’est une décision de conception à justifier.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-retained-and-will",
|
||||
"href": "08-part-ix-mqtt.html#sec-retained-and-will",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.6 Ce qu’un nouvel abonné apprend, et ce qu’un mort avoue",
|
||||
"text": "9.6 Ce qu’un nouvel abonné apprend, et ce qu’un mort avoue\nS’abonner à Demo/# pendant trois secondes, sans que rien ne soit publié, renvoie ceci :\nDemo/ROT13/U/nitro5/S/online {\"value\":true}\nDemo/ROT13/U/nitro5/S/subscriptions/text \"Demo/ConsoleIn/U/nitro5/E/text\"\nDemo/ConsoleOut/U/nitro5/S/online {\"value\":true}\nDemo/ConsoleOut/U/nitro5/S/subscriptions/text \"Demo/ROT13/U/nitro5/E/crypted\"\nUn arrivant tardif apprend instantanément tout le câblage actuel du système, sans rien demander et sans qu’aucun composant sache qu’un moniteur existe. C’est le Status retenu. Aucun Event n’arrive, car les Events sont publiés non retenus — « State retenu, Events non retenus ». C’est aussi la bonne réponse à l’instinct de demander à un service ce qu’il fait : personne ne demande ; le service le déclare, une fois, et le courtier le garde pour quiconque se présente.\nLe Status retenu seul mentirait pourtant. Tuez un service par Ctrl+C et son S/online = true reste sur le courtier à jamais. D’où la dernière volonté, enregistrée au moment de la connexion :\nvar will = new MqttMessage(\"{\\\"value\\\":false}\".getBytes(UTF_8), 1, true, new MqttProperties());\noptions.setWill(lastWillTopic, will);\nElle est retenue : quand le courtier la publie au nom du client, elle remplace le true périmé. Le composant qui échoue n’est pas celui qui signale l’échec — seul arrangement qui puisse fonctionner. Une réserve : une déconnexion propre ne déclenche pas la dernière volonté ; un service bien élevé publie donc online=false lui-même en partant, la volonté couvrant les morts brutales.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-coupling-remains",
|
||||
"href": "08-part-ix-mqtt.html#sec-coupling-remains",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.7 Ce qui a survécu au transport, et le couplage restant",
|
||||
"text": "9.7 Ce qui a survécu au transport, et le couplage restant\nLa moitié inférieure du tableau système de fichiers→MQTT est l’essentiel : I, S, E, les services égoïstes, la topologie à l’exécution et « transformateur si nécessaire » sont inchangés. L’architecture a survécu au remplacement du transport, et c’est la meilleure preuve disponible qu’elle n’a jamais dépendu du transport.\nUn couplage faible ne signifie pas que rien ne sait rien. Ce qui reste, nécessairement, est l’accord sur : la syntaxe des messages, leur sémantique, les contrats de sujets, l’Intent, la propriété, le sens du State et celui des Events. Le but n’est pas d’éliminer le couplage mais d’éliminer la connaissance inutile. Concrètement, chaque service ici doit comprendre exactement un contrat d’Event étranger — ROT13 comprend E/text de ConsoleIn, ConsoleOut comprend E/crypted de ROT13 — plus le schéma d’Intent qu’il accepte sur son propre I. Cette liste est le minimum irréductible.\nPar ailleurs, le courtier est une dépendance d’infrastructure partagée : tout le monde a besoin de son adresse et rien ne marche sans lui. Réel, mais d’une autre nature que la connaissance d’un composant par un autre.\nLa liste de l’étape 78 est l’outil à garder. Douze questions, dont ces six portent l’argument de ce système :\n\n\n\n\n\n\n\nquestion\nréponse ici\n\n\n\n\nune capacité contient-elle l’identité d’un producteur en dur ?\nnon — elle arrive par Intent\n\n\nquels contrats étrangers doit-elle comprendre ?\nun contrat d’Event chacun, plus son propre schéma d’Intent\n\n\noù la topologie est-elle définie ?\ndans le configurateur, hors du chemin des données\n\n\nla topologie peut-elle changer sans recompiler ?\noui — démontré sur un système en marche\n\n\nle transport pourrait-il être remplacé ?\noui — démontré : système de fichiers puis MQTT\n\n\nchaque médiateur fait-il quelque chose qui exige une médiation ?\noui, trivialement : TEXT → TEXT n’en exige aucune, et il n’y en a aucun\n\n\n\nLa prudence du matériel s’applique : les réponses n’ont pas à être toutes « non ». Elles doivent être intentionnelles.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-whole-journey",
|
||||
"href": "08-part-ix-mqtt.html#sec-whole-journey",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.8 Le parcours complet",
|
||||
"text": "9.8 Le parcours complet\nLe programme n’a jamais changé : une ligne entre, la même ressort décalée de 13 lettres. Ce qui a changé, onze fois, c’est la manière dont les parties sont reliées et qui détient la connaissance de ce câblage.\n\n\n\n\n\n\n\n\n\nétape\ncomment les parties sont reliées\noù vit la topologie\ndans le chemin des données, outre les capacités\n\n\n\n\n1 procédural\nappels directs\ndans le code de la capacité\n—\n\n\n2 services égoïstes\npas reliées du tout\nnulle part — c’est le problème\n—\n\n\n3 médiation statique, une JVM\nboîtes, copiées par des médiateurs\nles médiateurs, démarrés dans main()\ndeux médiateurs\n\n\n4 médiation statique, système de fichiers\nrépertoires, copiés par des processus médiateurs\nles lignes de commande de l’opérateur\ndeux processus médiateurs\n\n\n5 médiation statique, Syncthing\nrépertoires répliqués\nles lignes de commande de l’opérateur\ndeux processus médiateurs, plus le délai de réplication\n\n\n6 médiateurs nommés et configurables\nIntent ROUTE d’un orchestrateur\nl’orchestrateur, hors du chemin\nles médiateurs, encore\n\n\n7 dynamique, une JVM\nles services écoutent, guidés par un Intent TOPIC\nle configurateur\nrien\n\n\n8 dynamique, système de fichiers\nidem, sur des répertoires\nle configurateur\nrien\n\n\n9 dynamique, Syncthing\nidem, sur des répertoires répliqués\nle configurateur\nrien — seulement des sauts de transport\n\n\n10 contrats\ncompatibles : direct ; incompatibles : un transformateur\nle configurateur\nun transformateur, seulement là où les contrats diffèrent\n\n\n11 MQTT\ndes sujets sur un courtier\nle configurateur\nrien — le courtier est du transport\n\n\n\nLisez la troisième colonne de haut en bas : la topologie s’éloigne, une étape après l’autre, jusqu’à ce qu’aucune capacité n’en détienne plus rien. Lisez la dernière : le prix de ce déplacement tombe à zéro à l’étape 7 et y reste pendant que le transport change trois fois en dessous. Même architecture, meilleur transport.",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "08-part-ix-mqtt.html#sec-sentences",
|
||||
"href": "08-part-ix-mqtt.html#sec-sentences",
|
||||
"title": "9 Partie IX — MQTT",
|
||||
"section": "9.9 Les phrases à retenir",
|
||||
"text": "9.9 Les phrases à retenir\n\n« Event-driven » décrit comment circulent l’information et le contrôle.\nLe couplage faible décrit ce que les participants doivent savoir les uns des autres.\nPubliez ce qui est arrivé.\nDéclarez ce que vous voulez.\nPubliez votre propre état.\nGardez les capacités égoïstes.\nGardez la topologie hors des capacités.\nNe payez pas un médiateur qui ne fait pas réellement de médiation.\n\nEt chaque fois qu’une architecture devient confuse, revenez à la première question de ce livre : qui connaît qui ?",
|
||||
"crumbs": [
|
||||
"<span class='chapter-number'>9</span> <span class='chapter-title'>[Part IX — MQTT]{.en}[Partie IX — MQTT]{.fr}[Teil IX — MQTT]{.de}</span>"
|
||||
]
|
||||
},
|
||||
{
|
||||
"objectID": "glossary.html",
|
||||
"href": "glossary.html",
|
||||
|
||||
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -1,126 +0,0 @@
|
||||
// quiz — judge the tick boxes of one quiz, explain what went wrong
|
||||
//
|
||||
// Every label the reader sees is written into the markup by quiz.lua, so the
|
||||
// wording follows the book's language and nothing is translated twice. A
|
||||
// quiz carries:
|
||||
// data-quiz-score "{n} of {m} questions correct" ({n}/{m} substituted)
|
||||
// data-quiz-right verdict of a question answered correctly
|
||||
// data-quiz-wrong verdict of a question answered wrongly
|
||||
//
|
||||
// A question is right only when every one of its options is in the right
|
||||
// state: ticked when true, left empty when false. That is the "multiple
|
||||
// true/false" rule of the exam, and it is why a half-ticked question counts
|
||||
// as wrong.
|
||||
(function () {
|
||||
"use strict";
|
||||
|
||||
function options(quiz) {
|
||||
return quiz.querySelectorAll(".quiz-opt");
|
||||
}
|
||||
|
||||
function judge(quiz) {
|
||||
var questions = quiz.querySelectorAll(".quiz-q");
|
||||
var right = 0;
|
||||
|
||||
questions.forEach(function (q) {
|
||||
var ok = true;
|
||||
|
||||
q.querySelectorAll(".quiz-opt").forEach(function (opt) {
|
||||
var box = opt.querySelector(".quiz-box");
|
||||
if (!box) return;
|
||||
var want = opt.dataset.correct === "1";
|
||||
var hit = box.checked === want;
|
||||
|
||||
opt.classList.toggle("quiz-ok", hit);
|
||||
opt.classList.toggle("quiz-bad", !hit);
|
||||
|
||||
// the explanation of an option is for the reader who got it wrong
|
||||
var why = opt.querySelector(".quiz-why");
|
||||
if (why) why.hidden = hit;
|
||||
|
||||
if (!hit) ok = false;
|
||||
});
|
||||
|
||||
var verdict = q.querySelector(".quiz-verdict");
|
||||
if (verdict) {
|
||||
verdict.hidden = false;
|
||||
verdict.textContent = ok
|
||||
? (quiz.dataset.quizRight || "Correct")
|
||||
: (quiz.dataset.quizWrong || "Not quite");
|
||||
verdict.classList.toggle("quiz-ok", ok);
|
||||
verdict.classList.toggle("quiz-bad", !ok);
|
||||
}
|
||||
|
||||
// a question-level explanation backs up a wrong answer as a whole
|
||||
var qwhy = q.querySelector(".quiz-why-q");
|
||||
if (qwhy) qwhy.hidden = ok;
|
||||
|
||||
if (ok) right++;
|
||||
});
|
||||
|
||||
var score = quiz.querySelector(".quiz-score");
|
||||
if (score) {
|
||||
var template = quiz.dataset.quizScore || "{n}/{m}";
|
||||
score.innerHTML = "";
|
||||
// built as nodes, not markup: the template comes from metadata
|
||||
var parts = template.split(/\{n\}|\{m\}/);
|
||||
var values = [];
|
||||
(template.match(/\{n\}|\{m\}/g) || []).forEach(function (token) {
|
||||
values.push(token === "{n}" ? right : questions.length);
|
||||
});
|
||||
parts.forEach(function (text, i) {
|
||||
score.appendChild(document.createTextNode(text));
|
||||
if (i < values.length) {
|
||||
var b = document.createElement("b");
|
||||
b.textContent = String(values[i]);
|
||||
score.appendChild(b);
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
function reset(quiz) {
|
||||
options(quiz).forEach(function (opt) {
|
||||
var box = opt.querySelector(".quiz-box");
|
||||
if (box) box.checked = false;
|
||||
opt.classList.remove("quiz-ok", "quiz-bad");
|
||||
var why = opt.querySelector(".quiz-why");
|
||||
if (why) why.hidden = true;
|
||||
});
|
||||
quiz.querySelectorAll(".quiz-verdict").forEach(function (v) {
|
||||
v.hidden = true;
|
||||
v.textContent = "";
|
||||
v.classList.remove("quiz-ok", "quiz-bad");
|
||||
});
|
||||
quiz.querySelectorAll(".quiz-why-q").forEach(function (w) { w.hidden = true; });
|
||||
var score = quiz.querySelector(".quiz-score");
|
||||
if (score) score.textContent = "";
|
||||
}
|
||||
|
||||
document.addEventListener("click", function (event) {
|
||||
var target = event.target;
|
||||
if (!target.closest) return;
|
||||
|
||||
var check = target.closest(".quiz .quiz-check");
|
||||
if (check) {
|
||||
judge(check.closest(".quiz"));
|
||||
return;
|
||||
}
|
||||
var again = target.closest(".quiz .quiz-reset");
|
||||
if (again) {
|
||||
reset(again.closest(".quiz"));
|
||||
}
|
||||
});
|
||||
|
||||
// re-ticking a box after checking clears that row's verdict, so a stale
|
||||
// green or red never sits next to a box the reader has just changed
|
||||
document.addEventListener("change", function (event) {
|
||||
var box = event.target;
|
||||
if (!box.closest || !box.classList || !box.classList.contains("quiz-box")) return;
|
||||
var opt = box.closest(".quiz-opt");
|
||||
if (!opt) return;
|
||||
opt.classList.remove("quiz-ok", "quiz-bad");
|
||||
var why = opt.querySelector(".quiz-why");
|
||||
if (why) why.hidden = true;
|
||||
});
|
||||
})();
|
||||
+40
@@ -113,6 +113,31 @@
|
||||
margin-top: 0.5rem;
|
||||
}
|
||||
|
||||
/* ---- the per-question points badge ---------------------------------- */
|
||||
|
||||
/* The head now always exists (it is where the badge lands), so an empty one
|
||||
on a single-question quiz must not leave a gap. */
|
||||
.quiz-q-head:empty { display: none; }
|
||||
|
||||
.quiz-q-head {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
justify-content: space-between;
|
||||
gap: 0.6rem;
|
||||
}
|
||||
|
||||
.quiz-q-score {
|
||||
font-size: 0.82rem;
|
||||
font-weight: 400;
|
||||
color: var(--quiz-ink);
|
||||
white-space: nowrap;
|
||||
}
|
||||
.quiz-q-score b { color: var(--calc-notecolor, #B45309); font-weight: 600; }
|
||||
/* green and red stay reserved for a judged answer; the badge follows the
|
||||
verdict right below it so the two never disagree */
|
||||
.quiz-q-score.quiz-ok b { color: var(--quiz-ok); }
|
||||
.quiz-q-score.quiz-bad b { color: var(--quiz-bad); }
|
||||
|
||||
/* ---- verdict and bar ------------------------------------------------ */
|
||||
|
||||
.quiz-verdict {
|
||||
@@ -160,6 +185,18 @@
|
||||
|
||||
/* ---- dark theme ----------------------------------------------------- */
|
||||
|
||||
/* High contrast remaps the whole palette, and --quiz-ok / --quiz-bad are local
|
||||
to this file, so they have to be pointed at the HC pair by hand: without
|
||||
this the verdict and the points badge keep their ordinary-mode green and
|
||||
red, which is exactly what a reader turns HC on to avoid. `body` makes it
|
||||
outweigh body.quarto-dark .quiz below, or dark + HC would keep the plain
|
||||
dark pair. */
|
||||
html.hc body .quiz {
|
||||
--quiz-ok: var(--hc-success);
|
||||
--quiz-bad: var(--hc-danger);
|
||||
--quiz-ink: var(--hc-fg);
|
||||
}
|
||||
|
||||
body.quarto-dark .quiz {
|
||||
--quiz-ok: #4cb08a;
|
||||
--quiz-bad: #e2798f;
|
||||
@@ -174,5 +211,8 @@ body.quarto-dark .quiz {
|
||||
*/
|
||||
@media print {
|
||||
.quiz-bar { display: none; }
|
||||
/* on paper the points are printed in the statement by quiz.lua, so the
|
||||
screen badge would say the same thing twice */
|
||||
.quiz-q-score { display: none; }
|
||||
.quiz-opt.quiz-ok, .quiz-opt.quiz-bad { background: none; }
|
||||
}
|
||||
@@ -0,0 +1,183 @@
|
||||
// quiz — judge the tick boxes of one quiz, score it in points, explain mistakes
|
||||
//
|
||||
// Every label the reader sees is written into the markup by quiz.lua, so the
|
||||
// wording follows the book's language and nothing is translated twice. A
|
||||
// quiz carries:
|
||||
// data-quiz-score "{n} of {m} questions correct"
|
||||
// data-quiz-points "{n} of {m} points" (the headline)
|
||||
// data-quiz-qpoints "{n}/{m} points" (one question's badge)
|
||||
// data-quiz-right verdict of a question answered correctly
|
||||
// data-quiz-wrong verdict of a question answered wrongly
|
||||
// and each question carries data-points / data-penalty.
|
||||
//
|
||||
// SCORING. A question is worth data-points (default 3). Every statement whose
|
||||
// box disagrees with its truth value — an unticked true one, or a ticked false
|
||||
// one — costs data-penalty (default 1). The result floors at zero, so a
|
||||
// question can never drag the total down. The quiz total is the sum over its
|
||||
// questions. A question still counts as "correct" for the verdict line only
|
||||
// when every one of its statements is right, which is the exam's
|
||||
// multiple-true-false rule.
|
||||
(function () {
|
||||
"use strict";
|
||||
|
||||
function options(quiz) {
|
||||
return quiz.querySelectorAll(".quiz-opt");
|
||||
}
|
||||
|
||||
// Number(undefined) || 3 would also swallow a deliberate 0, so test first.
|
||||
function num(el, name, dflt) {
|
||||
var raw = el.dataset ? el.dataset[name] : null;
|
||||
if (raw === undefined || raw === null || raw === "") return dflt;
|
||||
var n = Number(raw);
|
||||
return isFinite(n) ? n : dflt;
|
||||
}
|
||||
|
||||
// Substitute {n} and {m} into a template from metadata, building text nodes
|
||||
// rather than markup: the template is author text, never trusted as HTML.
|
||||
function render(el, template, n, m) {
|
||||
el.innerHTML = "";
|
||||
var parts = template.split(/\{n\}|\{m\}/);
|
||||
var values = (template.match(/\{n\}|\{m\}/g) || []).map(function (token) {
|
||||
return token === "{n}" ? n : m;
|
||||
});
|
||||
parts.forEach(function (text, i) {
|
||||
el.appendChild(document.createTextNode(text));
|
||||
if (i < values.length) {
|
||||
var b = document.createElement("b");
|
||||
b.textContent = String(values[i]);
|
||||
el.appendChild(b);
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
function judge(quiz) {
|
||||
var questions = quiz.querySelectorAll(".quiz-q");
|
||||
var right = 0, scored = 0, available = 0;
|
||||
|
||||
questions.forEach(function (q) {
|
||||
var ok = true;
|
||||
var misses = 0;
|
||||
var pts = num(q, "points", 3);
|
||||
var pen = num(q, "penalty", 1);
|
||||
|
||||
q.querySelectorAll(".quiz-opt").forEach(function (opt) {
|
||||
var box = opt.querySelector(".quiz-box");
|
||||
if (!box) return;
|
||||
var want = opt.dataset.correct === "1";
|
||||
var hit = box.checked === want;
|
||||
|
||||
opt.classList.toggle("quiz-ok", hit);
|
||||
opt.classList.toggle("quiz-bad", !hit);
|
||||
|
||||
// the explanation of an option is for the reader who got it wrong.
|
||||
// :scope > keeps this to the option's own .why — a question-level
|
||||
// .quiz-why-q also carries the class quiz-why.
|
||||
var why = opt.querySelector(":scope > .quiz-why");
|
||||
if (why) why.hidden = hit;
|
||||
|
||||
if (!hit) { ok = false; misses++; }
|
||||
});
|
||||
|
||||
var got = Math.max(0, pts - misses * pen);
|
||||
scored += got;
|
||||
available += pts;
|
||||
|
||||
var badge = q.querySelector(".quiz-q-score");
|
||||
if (badge) {
|
||||
badge.hidden = false;
|
||||
render(badge, quiz.dataset.quizQpoints || "{n}/{m}", got, pts);
|
||||
badge.classList.toggle("quiz-ok", misses === 0);
|
||||
badge.classList.toggle("quiz-bad", got === 0 && pts > 0);
|
||||
}
|
||||
|
||||
var verdict = q.querySelector(".quiz-verdict");
|
||||
if (verdict) {
|
||||
verdict.hidden = false;
|
||||
verdict.textContent = ok
|
||||
? (quiz.dataset.quizRight || "Correct")
|
||||
: (quiz.dataset.quizWrong || "Not quite");
|
||||
verdict.classList.toggle("quiz-ok", ok);
|
||||
verdict.classList.toggle("quiz-bad", !ok);
|
||||
}
|
||||
|
||||
// a question-level explanation backs up a wrong answer as a whole
|
||||
var qwhy = q.querySelector(".quiz-why-q");
|
||||
if (qwhy) qwhy.hidden = ok;
|
||||
|
||||
if (ok) right++;
|
||||
});
|
||||
|
||||
var score = quiz.querySelector(".quiz-score");
|
||||
if (score) {
|
||||
score.hidden = false;
|
||||
render(score, quiz.dataset.quizPoints || "{n}/{m}", scored, available);
|
||||
}
|
||||
}
|
||||
|
||||
function reset(quiz) {
|
||||
options(quiz).forEach(function (opt) {
|
||||
var box = opt.querySelector(".quiz-box");
|
||||
if (box) box.checked = false;
|
||||
opt.classList.remove("quiz-ok", "quiz-bad");
|
||||
var why = opt.querySelector(":scope > .quiz-why");
|
||||
if (why) why.hidden = true;
|
||||
});
|
||||
quiz.querySelectorAll(".quiz-verdict").forEach(function (v) {
|
||||
v.hidden = true;
|
||||
v.textContent = "";
|
||||
v.classList.remove("quiz-ok", "quiz-bad");
|
||||
});
|
||||
quiz.querySelectorAll(".quiz-q-score").forEach(function (b) {
|
||||
b.hidden = true;
|
||||
b.textContent = "";
|
||||
b.classList.remove("quiz-ok", "quiz-bad");
|
||||
});
|
||||
quiz.querySelectorAll(".quiz-why-q").forEach(function (w) { w.hidden = true; });
|
||||
var score = quiz.querySelector(".quiz-score");
|
||||
if (score) { score.textContent = ""; score.hidden = false; }
|
||||
}
|
||||
|
||||
document.addEventListener("click", function (event) {
|
||||
var target = event.target;
|
||||
if (!target.closest) return;
|
||||
|
||||
var check = target.closest(".quiz .quiz-check");
|
||||
if (check) {
|
||||
judge(check.closest(".quiz"));
|
||||
return;
|
||||
}
|
||||
var again = target.closest(".quiz .quiz-reset");
|
||||
if (again) {
|
||||
reset(again.closest(".quiz"));
|
||||
}
|
||||
});
|
||||
|
||||
// Re-ticking a box after checking clears that row's verdict, so a stale
|
||||
// green or red never sits next to a box the reader has just changed — and
|
||||
// with it the question's badge and the headline, which would otherwise
|
||||
// still claim a score for an answer that has since moved.
|
||||
document.addEventListener("change", function (event) {
|
||||
var box = event.target;
|
||||
if (!box.closest || !box.classList || !box.classList.contains("quiz-box")) return;
|
||||
var opt = box.closest(".quiz-opt");
|
||||
if (!opt) return;
|
||||
opt.classList.remove("quiz-ok", "quiz-bad");
|
||||
var why = opt.querySelector(":scope > .quiz-why");
|
||||
if (why) why.hidden = true;
|
||||
|
||||
var q = opt.closest(".quiz-q");
|
||||
if (q) {
|
||||
var badge = q.querySelector(".quiz-q-score");
|
||||
if (badge) { badge.hidden = true; badge.textContent = ""; }
|
||||
var verdict = q.querySelector(".quiz-verdict");
|
||||
if (verdict) { verdict.hidden = true; verdict.textContent = ""; }
|
||||
var qwhy = q.querySelector(".quiz-why-q");
|
||||
if (qwhy) qwhy.hidden = true;
|
||||
}
|
||||
var quiz = opt.closest(".quiz");
|
||||
if (quiz) {
|
||||
var score = quiz.querySelector(".quiz-score");
|
||||
if (score) score.textContent = "";
|
||||
}
|
||||
});
|
||||
})();
|
||||
Reference in new issue
Block a user