Rename book to Process Control
This commit is contained in:
1 parent
919e79eb2a
commit
afb816f459
53 files changed
+5587
-503
No files matched your search
@@ -7,7 +7,7 @@
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
|
||||
|
||||
|
||||
<title>1 Schritt 0 — Worum es im Tutorial geht – Vom Aufruf zum Ereignis</title>
|
||||
<title>1 Schritt 0 — Worum es geht – Prozesssteuerung</title>
|
||||
<style>
|
||||
/* Default styles provided by pandoc.
|
||||
** See https://pandoc.org/MANUAL.html#variables-for-html for config info.
|
||||
@@ -50,9 +50,15 @@ ul.task-list li input[type="checkbox"] {
|
||||
<link href="site_libs/bootstrap/bootstrap-cfe7114cbc4adb2af5ff3a891545d7fa.min.css" rel="stylesheet" append-hash="true" 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 id="quarto-search-options" type="application/json">{
|
||||
@@ -95,7 +101,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
nothing is attached to the links themselves: one capture-phase listener on
|
||||
the document reads the link's final address at click time.
|
||||
|
||||
If a language has not been built (./render-all.sh), its pages do not exist:
|
||||
If a language has not been built, its pages do not exist:
|
||||
the target is checked first and a short note is shown instead of a
|
||||
"Not Found" page.
|
||||
|
||||
@@ -111,12 +117,9 @@ ul.task-list li input[type="checkbox"] {
|
||||
var ROOT_LANG = 'en'; // the language at the top of _book/
|
||||
var COOKIE = 'notes-lang';
|
||||
var NOTE = {
|
||||
de: 'Diese Sprache wurde noch nicht erstellt. Einmal ./render-all.sh ausführen – '
|
||||
+ 'danach funktioniert der Wechsel auch in der Vorschau.',
|
||||
fr: 'Cette langue n’a pas encore été générée. Lancez une fois ./render-all.sh : '
|
||||
+ 'ensuite le changement fonctionne aussi dans l’aperçu.',
|
||||
en: 'This language hasn’t been built yet. Run ./render-all.sh once, '
|
||||
+ 'then switching works in the preview too.'
|
||||
de: 'Diese Sprache ist hier noch nicht verfügbar.',
|
||||
fr: 'Cette langue n’est pas encore disponible ici.',
|
||||
en: 'This language is not available here yet.'
|
||||
};
|
||||
|
||||
var here = (document.documentElement.lang || ROOT_LANG).slice(0, 2);
|
||||
@@ -130,9 +133,20 @@ ul.task-list li input[type="checkbox"] {
|
||||
var m = document.cookie.match(/(?:^|;\s*)notes-lang=(de|fr|en)(?:;|$)/);
|
||||
return m ? m[1] : null;
|
||||
}
|
||||
// path '/' on purpose: every book of these notes is served from one host,
|
||||
// each under its own folder, so a language picked in any of them is the
|
||||
// language all of them open in. A book hosted on its own would be no worse
|
||||
// off -- the cookie simply has nothing else to reach.
|
||||
var COOKIE_PATH = '/';
|
||||
function remember(code) {
|
||||
document.cookie = COOKIE + '=' + code + '; path=' + root + '; max-age=31536000; SameSite=Lax'
|
||||
document.cookie = COOKIE + '=' + code + '; path=' + COOKIE_PATH
|
||||
+ '; max-age=31536000; SameSite=Lax'
|
||||
+ (location.protocol === 'https:' ? '; Secure' : '');
|
||||
// a copy written under the book's own path by an earlier version would be
|
||||
// the more specific one and would shadow the shared cookie for good
|
||||
if (root !== COOKIE_PATH) {
|
||||
document.cookie = COOKIE + '=; path=' + root + '; max-age=0';
|
||||
}
|
||||
}
|
||||
|
||||
// a returning reader lands in the language picked last time
|
||||
@@ -154,7 +168,11 @@ ul.task-list li input[type="checkbox"] {
|
||||
box.style.cssText = 'position:fixed;left:50%;bottom:1.25rem;transform:translateX(-50%);'
|
||||
+ 'max-width:min(34rem,calc(100vw - 2rem));padding:.6rem .9rem;border-radius:6px;'
|
||||
+ 'background:#1f2328;color:#fff;font-size:.85rem;line-height:1.4;z-index:2000;'
|
||||
+ 'box-shadow:0 4px 16px rgba(0,0,0,.25)';
|
||||
// a status message, so it keeps its own dark surface in either mode; the
|
||||
// hairline is the page's rule colour, invisible on a light page and an
|
||||
// edge against a dark one, where the shadow alone no longer separates it
|
||||
+ 'border:1px solid var(--calc-line,#444);'
|
||||
+ 'box-shadow:0 4px 16px var(--calc-shadow,rgba(0,0,0,.25))';
|
||||
document.body.appendChild(box);
|
||||
setTimeout(function () { box.remove(); }, 7000);
|
||||
}
|
||||
@@ -195,7 +213,35 @@ ul.task-list li input[type="checkbox"] {
|
||||
}, true);
|
||||
})();
|
||||
</script>
|
||||
<style>:root { --calc-notecolor: #B45309; }</style>
|
||||
<style>:root {
|
||||
--calc-furthercolor-src: #6B3FA0;
|
||||
--calc-furthercolor: var(--calc-furthercolor-src);
|
||||
|
||||
}</style>
|
||||
<style>:root {
|
||||
--calc-notecolor-src: #B45309;
|
||||
--calc-notecolor: var(--calc-notecolor-src);
|
||||
|
||||
}</style>
|
||||
<script>(function (e) {
|
||||
var KEY = 'notes-contrast', forced = false;
|
||||
var picked = null;
|
||||
try { picked = localStorage.getItem(KEY); } catch (err) {}
|
||||
var q = null;
|
||||
try { q = window.matchMedia && window.matchMedia('(prefers-contrast: more)'); } catch (err) {}
|
||||
if (picked === 'more' || (picked !== 'normal' && (forced || (q && q.matches)))) {
|
||||
e.classList.add('hc');
|
||||
}
|
||||
if (q) {
|
||||
var f = function () {
|
||||
var p = null;
|
||||
try { p = localStorage.getItem(KEY); } catch (err) {}
|
||||
if (p === null) e.classList.toggle('hc', forced || q.matches);
|
||||
};
|
||||
if (q.addEventListener) q.addEventListener('change', f);
|
||||
else if (q.addListener) q.addListener(f);
|
||||
}
|
||||
})(document.documentElement);</script>
|
||||
|
||||
|
||||
</head>
|
||||
@@ -209,7 +255,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Seitenleiste umschalten" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||
<i class="bi bi-layout-text-sidebar-reverse"></i>
|
||||
</button>
|
||||
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="./00-orientation.html"><span class="chapter-number">1</span> <span class="chapter-title">Schritt 0 — Worum es im Tutorial geht</span></a></li></ol></nav>
|
||||
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="./00-orientation.html"><span class="chapter-number">1</span> <span class="chapter-title">Schritt 0 — Worum es geht</span></a></li></ol></nav>
|
||||
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Seitenleiste umschalten" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
|
||||
</a>
|
||||
<button type="button" class="btn quarto-search-button" aria-label="Suchen" onclick="window.quartoOpenSearch();">
|
||||
@@ -224,7 +270,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation docked overflow-auto">
|
||||
<div class="pt-lg-2 mt-2 text-left sidebar-header">
|
||||
<div class="sidebar-title mb-0 py-0">
|
||||
<a href="./">Vom Aufruf zum Ereignis</a>
|
||||
<a href="./">Prozesssteuerung</a>
|
||||
<div class="sidebar-tools-main tools-wide">
|
||||
<div class="dropdown">
|
||||
<a href="" title="" id="quarto-navigation-tool-dropdown-0" class="quarto-navigation-tool dropdown-toggle px-1" data-bs-toggle="dropdown" aria-expanded="false" role="link" aria-label=""><i class="bi bi-translate"></i></a>
|
||||
@@ -246,7 +292,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
<a href="./Vom-Aufruf-zum-Ereignis.pdf" title="Download PDF" class="quarto-navigation-tool px-1" aria-label="Download PDF"><i class="bi bi-file-pdf"></i></a>
|
||||
<a href="./Prozesssteuerung.pdf" title="Download PDF" class="quarto-navigation-tool px-1" aria-label="Download PDF"><i class="bi bi-file-pdf"></i></a>
|
||||
<a href="" class="quarto-reader-toggle quarto-navigation-tool px-1" onclick="window.quartoToggleReader(); return false;" title="Lesemodus umschalten">
|
||||
<div class="quarto-reader-toggle-btn">
|
||||
<i class="bi"></i>
|
||||
@@ -271,7 +317,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./00-orientation.html" class="sidebar-item-text sidebar-link active">
|
||||
<span class="menu-text"><span class="chapter-number">1</span> <span class="chapter-title">Schritt 0 — Worum es im Tutorial geht</span></span></a>
|
||||
<span class="menu-text"><span class="chapter-number">1</span> <span class="chapter-title">Schritt 0 — Worum es geht</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item">
|
||||
@@ -286,6 +332,23 @@ ul.task-list li input[type="checkbox"] {
|
||||
<span class="menu-text"><span class="chapter-number">3</span> <span class="chapter-title">Teil II — Die Prozessgrenze überschreiten</span></span></a>
|
||||
</div>
|
||||
</li>
|
||||
<li class="sidebar-item sidebar-item-section">
|
||||
<div class="sidebar-item-container">
|
||||
<a class="sidebar-item-text sidebar-link text-start collapsed" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="false">
|
||||
<span class="menu-text">Anhang</span></a>
|
||||
<a class="sidebar-item-toggle text-start collapsed" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="false" aria-label="Abschnitt umschalten">
|
||||
<i class="bi bi-chevron-right ms-2"></i>
|
||||
</a>
|
||||
</div>
|
||||
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 ">
|
||||
<li class="sidebar-item">
|
||||
<div class="sidebar-item-container">
|
||||
<a href="./glossary.html" class="sidebar-item-text sidebar-link">
|
||||
<span class="menu-text">Glossar</span></a>
|
||||
</div>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</div>
|
||||
</nav>
|
||||
@@ -305,7 +368,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
|
||||
<header id="title-block-header" class="quarto-title-block default">
|
||||
<div class="quarto-title">
|
||||
<h1 class="title"><span id="sec-step-0" class="quarto-section-identifier"><span class="chapter-number">1</span> <span class="chapter-title">Schritt 0 — Worum es im Tutorial geht</span></span></h1>
|
||||
<h1 class="title"><span id="sec-step-0" class="quarto-section-identifier"><span class="chapter-number">1</span> <span class="chapter-title">Schritt 0 — Worum es geht</span></span></h1>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -324,11 +387,11 @@ ul.task-list li input[type="checkbox"] {
|
||||
|
||||
<!-- MULTILINGUAL: see the comment at the top of index.qmd. -->
|
||||
<p>Schritt 0 enthält keinen Code. Er nennt das Thema: nicht ROT13, sondern die Architektur darum herum. Die Funktionalität bleibt über 81 Schritte fast unverändert — genau das macht die Veränderungen ringsherum sichtbar.</p>
|
||||
<p>Zwei Regeln werden hier gesetzt und gelten für das ganze Tutorial:</p>
|
||||
<p>Zwei Regeln werden hier gesetzt und gelten bis zum Schluss:</p>
|
||||
<blockquote class="blockquote">
|
||||
<p><strong>Einer Lösung erst begegnen, nachdem man das Problem erlebt hat, das sie löst.</strong></p>
|
||||
</blockquote>
|
||||
<p>Deshalb beginnt das Tutorial nicht mit MQTT und auch nicht mit dynamischen Abonnements. Es baut zuerst ein System mit absichtlich unbequemen Vermittlern, nimmt es in Betrieb und fragt erst dann, ob sie ihren Platz verdient haben.</p>
|
||||
<p>Deshalb beginnt der Aufbau nicht mit MQTT und auch nicht mit dynamischen Abonnements. Zuerst entsteht ein System mit absichtlich unbequemen Vermittlern, wird in Betrieb genommen, und erst dann wird gefragt, ob sie ihren Platz verdient haben.</p>
|
||||
<p>Die zweite Regel betrifft das Vokabular: <em>Intent</em>, <em>Status/State</em> und <em>Event</em> werden erst benannt, nachdem sie benutzt wurden. Sie erscheinen etwa ab Schritt 42, nicht früher.</p>
|
||||
<p>Die geplante Route, von Schritt 0 an:</p>
|
||||
<pre class="text"><code>direct method calls → egoistic services → mediators → separate processes
|
||||
@@ -345,7 +408,7 @@ ul.task-list li input[type="checkbox"] {
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr class="header">
|
||||
<th>Das Tutorial fragt</th>
|
||||
<th>So gefragt</th>
|
||||
<th>Eine schwächere Fassung</th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
Reference in new issue
Block a user