Added course's notes
This commit is contained in:
1 parent
e07993262c
commit
dcd2c072ae
191 files changed
+42866
-12
No files matched your search
@@ -0,0 +1,214 @@
|
||||
<!-- figures/flow-player.html -- the web version's interactive diagrams.
|
||||
Injected at the end of <body> by include-in-header's sibling
|
||||
include-after-body in _quarto.yml, so it is a no-op on a page that holds
|
||||
no img.flow-figure.
|
||||
|
||||
A chapter writes an ordinary Quarto figure and adds the class:
|
||||
|
||||
{#fig-x .flow-figure}
|
||||
|
||||
That keeps the PDF and the no-JavaScript case working: the built svg is
|
||||
already the whole picture. Here the image is fetched, inlined, and given
|
||||
a play bar that walks a message through the mailboxes, one hop per
|
||||
[data-flow] edge of the svg, highlighting the [data-flow-node] each hop
|
||||
ends at. Colours are diagram.css's, so the two stay in step. -->
|
||||
|
||||
<style>
|
||||
.flow-wrap { margin: 0; }
|
||||
.flow-wrap svg { width: 100%; height: auto; display: block; }
|
||||
|
||||
.flow-token { fill: #8a5a08; stroke: #fbfcfd; stroke-width: 1.2; }
|
||||
.flow-wrap .flow-on .box,
|
||||
.flow-wrap .flow-on .box-plain,
|
||||
.flow-wrap .flow-on .box-accent { stroke-width: 3; }
|
||||
.flow-wrap .flow-done { stroke: #8a5a08; }
|
||||
|
||||
.flow-bar {
|
||||
display: flex; align-items: center; gap: .5rem; flex-wrap: wrap;
|
||||
max-width: 100%; margin: .45rem 0 0;
|
||||
}
|
||||
.flow-bar button {
|
||||
font: inherit; font-size: .82rem; padding: .18rem .7rem; cursor: pointer;
|
||||
border: 1px solid #dae0e8; border-radius: 999px;
|
||||
background: #fbfcfd; color: #5a6879;
|
||||
}
|
||||
.flow-bar button:hover { border-color: #20666f; color: #20666f; }
|
||||
.flow-bar button[disabled] { opacity: .45; cursor: default; }
|
||||
.flow-status { font-size: .8rem; color: #5a6879; }
|
||||
.flow-status b { color: #20666f; font-weight: 600; }
|
||||
|
||||
@media (prefers-color-scheme: dark) {
|
||||
.flow-token { fill: #c99a3a; stroke: #161b22; }
|
||||
.flow-bar button { background: #161b22; border-color: #30363d; color: #8b98a8; }
|
||||
.flow-bar button:hover { border-color: #4c9aa5; color: #7fc4cf; }
|
||||
.flow-status { color: #8b98a8; }
|
||||
.flow-status b { color: #7fc4cf; }
|
||||
}
|
||||
</style>
|
||||
|
||||
<script>
|
||||
(() => {
|
||||
const images = document.querySelectorAll("img.flow-figure");
|
||||
if (!images.length) return;
|
||||
|
||||
const LANG = (document.documentElement.lang || "en").slice(0, 2);
|
||||
const WORDS = {
|
||||
en: { play: "Play", pause: "Pause", step: "One hop", reset: "Reset",
|
||||
idle: "the message has not been sent yet", done: "arrived" },
|
||||
fr: { play: "Lancer", pause: "Pause", step: "Un saut", reset: "Réinitialiser",
|
||||
idle: "le message n'est pas encore parti", done: "arrivé" },
|
||||
de: { play: "Abspielen", pause: "Pause", step: "Ein Sprung", reset: "Zurücksetzen",
|
||||
idle: "die Nachricht ist noch nicht unterwegs", done: "angekommen" },
|
||||
};
|
||||
const W = WORDS[LANG] || WORDS.en;
|
||||
const STILL = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
|
||||
const HOP = 620; // ms per hop
|
||||
|
||||
const label = (node) => {
|
||||
const text = node && node.querySelector("text");
|
||||
return text ? text.textContent.trim() : "";
|
||||
};
|
||||
|
||||
async function upgrade(img) {
|
||||
let svg;
|
||||
try {
|
||||
const response = await fetch(img.currentSrc || img.src);
|
||||
if (!response.ok) return; // leave the plain image in place
|
||||
const doc = new DOMParser().parseFromString(await response.text(), "image/svg+xml");
|
||||
svg = doc.documentElement;
|
||||
if (!svg || svg.nodeName !== "svg" || doc.querySelector("parsererror")) return;
|
||||
} catch { return; } // file:// or offline: plain image
|
||||
|
||||
const edges = [...svg.querySelectorAll("[data-flow]")]
|
||||
.sort((a, b) => Number(a.dataset.flow) - Number(b.dataset.flow));
|
||||
if (!edges.length) return;
|
||||
|
||||
svg.removeAttribute("width");
|
||||
svg.removeAttribute("height");
|
||||
|
||||
const wrap = document.createElement("div");
|
||||
wrap.className = "flow-wrap";
|
||||
wrap.appendChild(svg);
|
||||
|
||||
const bar = document.createElement("div");
|
||||
bar.className = "flow-bar";
|
||||
const make = (name) => {
|
||||
const button = document.createElement("button");
|
||||
button.type = "button";
|
||||
button.textContent = W[name];
|
||||
bar.appendChild(button);
|
||||
return button;
|
||||
};
|
||||
const playButton = make("play");
|
||||
const stepButton = make("step");
|
||||
const resetButton = make("reset");
|
||||
const status = document.createElement("span");
|
||||
status.className = "flow-status";
|
||||
bar.appendChild(status);
|
||||
wrap.appendChild(bar);
|
||||
|
||||
img.hidden = true;
|
||||
img.after(wrap);
|
||||
|
||||
const token = document.createElementNS("http://www.w3.org/2000/svg", "circle");
|
||||
token.setAttribute("r", "6");
|
||||
token.setAttribute("class", "flow-token");
|
||||
token.style.display = "none";
|
||||
svg.appendChild(token);
|
||||
|
||||
let at = 0; // hops already made
|
||||
let playing = false;
|
||||
let frame = null;
|
||||
|
||||
const nodeOf = (edge) =>
|
||||
edge.dataset.flowTo
|
||||
? svg.querySelector(`[data-flow-node="${edge.dataset.flowTo}"]`)
|
||||
: null;
|
||||
|
||||
const say = () => {
|
||||
if (at === 0) { status.textContent = W.idle; return; }
|
||||
const here = label(nodeOf(edges[at - 1]));
|
||||
status.innerHTML = `${at} / ${edges.length} — <b></b>`;
|
||||
status.querySelector("b").textContent =
|
||||
at === edges.length ? `${here} (${W.done})` : here;
|
||||
};
|
||||
|
||||
const clear = () => {
|
||||
svg.querySelectorAll(".flow-on").forEach((n) => n.classList.remove("flow-on"));
|
||||
edges.forEach((e) => e.classList.remove("flow-done"));
|
||||
};
|
||||
|
||||
const place = (edge, fraction) => {
|
||||
const length = edge.getTotalLength();
|
||||
const point = edge.getPointAtLength(length * fraction);
|
||||
token.setAttribute("cx", point.x);
|
||||
token.setAttribute("cy", point.y);
|
||||
token.style.display = "";
|
||||
};
|
||||
|
||||
function hop(then) {
|
||||
const edge = edges[at];
|
||||
if (!edge) { then && then(false); return; }
|
||||
clear();
|
||||
const arrive = () => {
|
||||
edge.classList.add("flow-done");
|
||||
const node = nodeOf(edge);
|
||||
if (node) node.classList.add("flow-on");
|
||||
at += 1;
|
||||
say();
|
||||
buttons();
|
||||
then && then(at < edges.length);
|
||||
};
|
||||
if (STILL) { place(edge, 1); arrive(); return; }
|
||||
const start = performance.now();
|
||||
const tick = (now) => {
|
||||
const done = Math.min((now - start) / HOP, 1);
|
||||
place(edge, done);
|
||||
if (done < 1) { frame = requestAnimationFrame(tick); } else { frame = null; arrive(); }
|
||||
};
|
||||
frame = requestAnimationFrame(tick);
|
||||
}
|
||||
|
||||
function buttons() {
|
||||
const end = at >= edges.length;
|
||||
playButton.textContent = playing ? W.pause : W.play;
|
||||
playButton.disabled = end && !playing;
|
||||
stepButton.disabled = end || playing;
|
||||
resetButton.disabled = at === 0 && !playing;
|
||||
}
|
||||
|
||||
function stop() {
|
||||
playing = false;
|
||||
if (frame) { cancelAnimationFrame(frame); frame = null; }
|
||||
buttons();
|
||||
}
|
||||
|
||||
function run() {
|
||||
if (at >= edges.length) at = 0;
|
||||
playing = true;
|
||||
buttons();
|
||||
const next = (more) => {
|
||||
if (!playing) return;
|
||||
if (more) { hop(next); } else { stop(); }
|
||||
};
|
||||
hop(next);
|
||||
}
|
||||
|
||||
playButton.addEventListener("click", () => (playing ? stop() : run()));
|
||||
stepButton.addEventListener("click", () => { stop(); hop(); });
|
||||
resetButton.addEventListener("click", () => {
|
||||
stop();
|
||||
at = 0;
|
||||
clear();
|
||||
token.style.display = "none";
|
||||
say();
|
||||
buttons();
|
||||
});
|
||||
|
||||
say();
|
||||
buttons();
|
||||
}
|
||||
|
||||
images.forEach(upgrade);
|
||||
})();
|
||||
</script>
|
||||
Reference in new issue
Block a user