Added course's notes
This commit is contained in:
1 parent
e07993262c
commit
dcd2c072ae
191 files changed
+42866
-12
No files matched your search
@@ -3,7 +3,7 @@
|
||||
<!-- nav -->
|
||||
> ⬅ Previous: *(none)* · [Index](../conv.md) · [Next: Part I ➡](01-part-I.md)
|
||||
>
|
||||
> All parts: **Setup & Step 0** · [Part I](01-part-I.md) · [Part II](02-part-II.md)
|
||||
> All parts: **Setup & Step 0** · [Part I](01-part-I.md) · [Part II](02-part-II.md) · [Part III](03-part-III.md)
|
||||
<!-- /nav -->
|
||||
|
||||
---
|
||||
@@ -309,5 +309,5 @@ java --version
|
||||
<!-- nav -->
|
||||
> ⬅ Previous: *(none)* · [Index](../conv.md) · [Next: Part I ➡](01-part-I.md)
|
||||
>
|
||||
> All parts: **Setup & Step 0** · [Part I](01-part-I.md) · [Part II](02-part-II.md)
|
||||
> All parts: **Setup & Step 0** · [Part I](01-part-I.md) · [Part II](02-part-II.md) · [Part III](03-part-III.md)
|
||||
<!-- /nav -->
|
||||
+2
-2
@@ -3,7 +3,7 @@
|
||||
<!-- nav -->
|
||||
> [⬅ Previous: Setup & Step 0](00-setup-and-step-0.md) · [Index](../conv.md) · [Next: Part II ➡](02-part-II.md)
|
||||
>
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · **Part I** · [Part II](02-part-II.md)
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · **Part I** · [Part II](02-part-II.md) · [Part III](03-part-III.md)
|
||||
<!-- /nav -->
|
||||
|
||||
---
|
||||
@@ -740,5 +740,5 @@ Read section 10 (lines 644–694) to see it in the README's words. Note that the
|
||||
<!-- nav -->
|
||||
> [⬅ Previous: Setup & Step 0](00-setup-and-step-0.md) · [Index](../conv.md) · [Next: Part II ➡](02-part-II.md)
|
||||
>
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · **Part I** · [Part II](02-part-II.md)
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · **Part I** · [Part II](02-part-II.md) · [Part III](03-part-III.md)
|
||||
<!-- /nav -->
|
||||
+114
-5
@@ -1,9 +1,9 @@
|
||||
# Conversation Log — Part II — Cross the Process Boundary · Steps 11–18 (turns 29–)
|
||||
# Conversation Log — Part II — Cross the Process Boundary · Steps 11–18 (turns 29–44)
|
||||
|
||||
<!-- nav -->
|
||||
> [⬅ Previous: Part I](01-part-I.md) · [Index](../conv.md) · Next: *(not started yet)* ➡
|
||||
> [⬅ Previous: Part I](01-part-I.md) · [Index](../conv.md) · [Next: Part III ➡](03-part-III.md)
|
||||
>
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · [Part I](01-part-I.md) · **Part II**
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · [Part I](01-part-I.md) · **Part II** · [Part III](03-part-III.md)
|
||||
<!-- /nav -->
|
||||
|
||||
---
|
||||
@@ -388,11 +388,120 @@ Back to the milestone check before Part III: in Step 8 the topology lived in lin
|
||||
|
||||
- Viewed the 4 files in `03-static-filesystem/messageBoard/` before committing: plain-text `TEXT` messages from the Step 18 run (`Hello World` and `Uryyb Jbeyq`, with timestamps). Nothing sensitive.
|
||||
- Logged this turn, then committed `messageBoard/` together with this log update. Not pushed (only a commit was requested).
|
||||
- Result: commit `e079932` "Keep Step 18 message board as a record of the filesystem run" (4 `.msg` files + log). `main` is 1 commit ahead of `origin/main`.
|
||||
|
||||
## [41] Tutor — reply
|
||||
|
||||
Committed as `e079932`: the 4 message files from your Step 18 run, plus the log. Not pushed. `main` is 1 commit ahead of `origin/main`, so tell me when you want it pushed.
|
||||
|
||||
Heads-up for later: the README resets the board with `rm -rf messageBoard` before some runs. Because these files are now committed, that command will remove them from disk but not from git history. `git status` will then show them as deleted, and we'll decide at that point whether to record the deletion.
|
||||
|
||||
Back to the check before Part III: in Step 8 the topology lived in lines 79–85 of `main()`. In the five-terminal version, where does it live now, and who knows it?
|
||||
|
||||
**Progress record**
|
||||
- Current step: end of Part II (check pending)
|
||||
- Last observed result: `messageBoard/` committed (`e079932`, unpushed)
|
||||
- Unresolved problem: none
|
||||
- Next action: student says where the topology lives in the 5-process version; then Part III
|
||||
|
||||
---
|
||||
|
||||
## [42] Student
|
||||
|
||||
> you can push, then i'll start PIII
|
||||
|
||||
## [42] Tutor — actions taken
|
||||
|
||||
- `git push origin main` → `c5c86e9..e079932 main -> main`. `main` matches `origin/main`. This log update stays uncommitted, as usual.
|
||||
- Read README lines 1212–1291 (Part III start: Step 19 "One Filesystem Is Not Yet Very Distributed", Step 20 "What Syncthing Is Doing for Us", start of Step 21).
|
||||
- Read-only check: `syncthing` is **not installed** (`command -v syncthing` found nothing). Package `syncthing` 2.1.5-1 is available in Arch's `extra` repo.
|
||||
- Schedule check: today is 22 Sep 2026. Part III falls in the inferred Parts II–VIII bucket, due by 29 Sep 2026. On time, no lecture.
|
||||
|
||||
## [42] Tutor — reply
|
||||
|
||||
Pushed: `c5c86e9..e079932 main -> main`.
|
||||
|
||||
## Part III — Make It Actually Distributed
|
||||
|
||||
**Schedule:** Part III is in the same bucket as Parts II–VIII, inferred due by **29 Sep 2026**. Today is 22 Sep, so you're on time.
|
||||
|
||||
The Part II check (where the topology lives in the five-terminal version) is still open. Answer it whenever you like. It comes back naturally at Step 27, "What Does Our Mediator Actually Contribute?".
|
||||
|
||||
**Steps 19–20 — One Filesystem Is Not Yet Very Distributed / What Syncthing Is Doing for Us**
|
||||
|
||||
**Goal:** go from five processes on *one* computer to processes on *several* computers, still talking through files.
|
||||
|
||||
**Do:** read README lines 1212–1286.
|
||||
|
||||
**Tell me:**
|
||||
1. In your own words: why does the README insist Syncthing is **not** a message broker, even though our messages will travel through it?
|
||||
2. A practical prerequisite for Step 21 onward: Syncthing isn't installed on this machine (`syncthing` 2.1.5 is in Arch's `extra` repo), and the steps need **at least two computers**. What machines can you use (a second PC, a laptop, a classmate's machine, a VM)? Don't install anything yet; just tell me what you have.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III)
|
||||
- Last observed result: pushed `e079932`; Syncthing not installed (observed)
|
||||
- Unresolved problem: Part II topology check still open (parked until Step 27 or whenever); machine setup for Syncthing unknown
|
||||
- Next action: student reads Steps 19–20, explains why Syncthing isn't a broker, and says what machines are available
|
||||
|
||||
---
|
||||
|
||||
## [43] Student
|
||||
|
||||
> Sorry, forgot PII last question, each terminal make live a part (t1 the consoleIn, t2 the link between consoleIn and rot13, t3 rot13, t4 the link between rot13 and consoleOut, t5 consoleOut
|
||||
|
||||
## [43] Tutor — actions taken
|
||||
|
||||
- None. Compared the answer with `Mediator.java` (generic: route only from `arguments[0]`/`arguments[1]`) and the Step 18 commands. Logged here, in the Part II file, because the answer is about Part II.
|
||||
|
||||
## [43] Tutor — reply
|
||||
|
||||
No problem. ✅ The mapping is right: T1 ConsoleIn, T2 link ConsoleIn → ROT13, T3 ROT13, T4 link ROT13 → ConsoleOut, T5 ConsoleOut.
|
||||
|
||||
That answers *which process does what*. The question was also *where the topology lives and who knows it*. One pointer: open `Mediator.java`. Is `consoleIn/outbox → rot13/inbox` written anywhere in it, or in any other `.java` file? If not, where is that route actually written down, and who wrote it?
|
||||
|
||||
One line is enough. Answer it together with the two Part III questions (why Syncthing isn't a broker, and which machines you can use).
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III); Part II check partly answered
|
||||
- Last observed result: student mapped the five terminals to their roles correctly
|
||||
- Unresolved problem: "where the topology lives / who knows it" not yet answered; machines for Syncthing unknown
|
||||
- Next action: student says where the route is written and who wrote it, plus the Step 19–20 answers
|
||||
|
||||
---
|
||||
|
||||
## [44] Student
|
||||
|
||||
> no, it is written by hand when running Mediator.java <from> <to>
|
||||
|
||||
## [44] Tutor — actions taken
|
||||
|
||||
- None.
|
||||
|
||||
## [44] Tutor — reply
|
||||
|
||||
✅ Exactly. No `.java` file contains the route any more. It exists only in the commands **you** typed in Terminals 2 and 4. So the one who knows the topology is **the person starting the processes**.
|
||||
|
||||
That completes the arc since Step 1:
|
||||
- **Step 1:** topology inside the capability code (`IO.println(rot13(text))`).
|
||||
- **Step 8:** topology in `main()`, lines 79–85, as mailbox-name pairs.
|
||||
- **Step 18:** topology outside all code, in the operator's command lines.
|
||||
|
||||
Each time it moved *away* from the capabilities. It never disappeared. (Bookmark: Step 27 has a subsection titled "Let an Orchestrator Supply the Topology".)
|
||||
|
||||
**Part II check done.** Still open, for Part III:
|
||||
1. Why is Syncthing **not** a message broker, even though messages travel through it?
|
||||
2. Which machines can you use for Syncthing?
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III)
|
||||
- Last observed result: Part II check done (topology lives in the hand-typed `Mediator.java <from> <to>` commands; the operator knows it)
|
||||
- Unresolved problem: machines for Syncthing unknown
|
||||
- Next action: student answers the two Step 19–20 questions
|
||||
|
||||
---
|
||||
|
||||
<!-- nav -->
|
||||
> [⬅ Previous: Part I](01-part-I.md) · [Index](../conv.md) · Next: *(not started yet)* ➡
|
||||
> [⬅ Previous: Part I](01-part-I.md) · [Index](../conv.md) · [Next: Part III ➡](03-part-III.md)
|
||||
>
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · [Part I](01-part-I.md) · **Part II**
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · [Part I](01-part-I.md) · **Part II** · [Part III](03-part-III.md)
|
||||
<!-- /nav -->
|
||||
@@ -0,0 +1,266 @@
|
||||
# Conversation Log — Part III — Make It Actually Distributed · Steps 19–27 (turns 45–)
|
||||
|
||||
<!-- nav -->
|
||||
> [⬅ Previous: Part II](02-part-II.md) · [Index](../conv.md) · Next: *(not started yet)* ➡
|
||||
>
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · [Part I](01-part-I.md) · [Part II](02-part-II.md) · **Part III**
|
||||
<!-- /nav -->
|
||||
|
||||
---
|
||||
|
||||
## [45] Student
|
||||
|
||||
> before doing step 20 i need to syncthing (step 19), as there is only debian and ubuntu how to do it again to install it on my arch?
|
||||
|
||||
## [45] Tutor — actions taken
|
||||
|
||||
- Created this Part III log file, regenerated the nav blocks in all part files, and updated the index in `conv.md`.
|
||||
- Read README lines 1289–1413 (Step 21 "Prepare a Shared Course Folder", Step 22 "Verify Syncthing Before Starting the System", Step 23 "Important: Syncthing Is Not a Shared Atomic Filesystem"), so the install advice matches what those steps need.
|
||||
- Read-only: `pacman -Si syncthing` → official Arch package `syncthing` **2.1.5-1** in the `extra` repo, depends only on `glibc` and `sqlite`. (Earlier: not installed on this machine.) `pacman -Fl` returned nothing because the file database isn't synced, so I could **not** check which systemd unit files the package ships.
|
||||
- Nothing installed. Installing changes the student's system, so the student runs the commands.
|
||||
|
||||
## [45] Tutor — reply
|
||||
|
||||
**Detour: installing Syncthing on Arch.** This belongs to Step 21 ("On every participating computer: install and start Syncthing"). Step 19 only names the tool.
|
||||
|
||||
You don't need the Debian/Ubuntu packages. Syncthing is in Arch's official `extra` repo (**observed:** `syncthing 2.1.5-1`).
|
||||
|
||||
**1. Install and check** (you run these, since they change your system):
|
||||
```bash
|
||||
sudo pacman -S syncthing
|
||||
syncthing --version
|
||||
```
|
||||
|
||||
**2. See how the package lets you start it.** I couldn't check this from here:
|
||||
```bash
|
||||
pacman -Ql syncthing | grep systemd
|
||||
```
|
||||
|
||||
**3. Start it.** Pick one of two ways:
|
||||
- **Foreground, simplest for a first try:** run `syncthing` in a terminal. It stops when you close that terminal. (Syncthing 2.x reorganised its command line into subcommands. If bare `syncthing` complains, `syncthing --help` lists them.)
|
||||
- **Background, keeps running:** if step 2 shows a *user* unit (a file under `/usr/lib/systemd/user/`), use `systemctl --user enable --now <that unit name>`.
|
||||
|
||||
**4. Open the web GUI:** Syncthing's default address is `http://127.0.0.1:8384`. Adding devices and sharing a folder (Step 21, items 2–4) happens there.
|
||||
|
||||
Repeat on every other machine you'll use. For Step 21 you need **at least two**, so the machine question from before still matters.
|
||||
|
||||
**Back to Step 19–20** when Syncthing runs. Tell me:
|
||||
1. the output of `syncthing --version` and of the `pacman -Ql` line;
|
||||
2. which machines you'll connect;
|
||||
3. still open: why is Syncthing **not** a message broker, even though messages travel through it?
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), detour: installing Syncthing
|
||||
- Last observed result: `syncthing 2.1.5-1` available in `extra`; not installed yet
|
||||
- Unresolved problem: which machines to connect; unit file name not verified
|
||||
- Next action: student installs Syncthing, reports version + unit files, names the machines, answers the "not a broker" question
|
||||
|
||||
---
|
||||
|
||||
## [46] Student
|
||||
|
||||
```
|
||||
[matsune@nitro5 ProcessControl]$ sudo pacman -S synchting
|
||||
[sudo] password for matsune:
|
||||
error: target not found: synchting
|
||||
[matsune@nitro5 ProcessControl]$ pacman -Ql syncthing | grep systemd
|
||||
error: package 'syncthing' was not found
|
||||
[matsune@nitro5 ProcessControl]$
|
||||
```
|
||||
|
||||
## [46] Tutor — actions taken
|
||||
|
||||
- None. Compared the typed package name with the one `pacman -Si` reported earlier (`syncthing`).
|
||||
|
||||
## [46] Tutor — reply
|
||||
|
||||
**Observed:** the install command asked for `synchting` (**c-h-t**), but the package is `syncthing` (**c-t-h**: sync + thing). pacman found no such target and installed nothing. That's why the second command says `package 'syncthing' was not found`: it's correct, just not installed yet.
|
||||
|
||||
Retry with the right spelling:
|
||||
```bash
|
||||
sudo pacman -S syncthing
|
||||
syncthing --version
|
||||
pacman -Ql syncthing | grep systemd
|
||||
```
|
||||
|
||||
**Tell me:** the output of the last two commands.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), detour: installing Syncthing
|
||||
- Last observed result: install failed because of a typo in the package name (`synchting`)
|
||||
- Unresolved problem: which machines to connect; "not a broker" question still open
|
||||
- Next action: student reruns the install with `syncthing` and sends the version + unit files
|
||||
|
||||
---
|
||||
|
||||
## [47] Student
|
||||
|
||||
```
|
||||
[matsune@nitro5 ProcessControl]$ syncthing --version
|
||||
syncthing v2.1.5 "Hafnium Hornet" (go1.27.0-X:nodwarf5 linux-amd64) syncthing@archlinux 2026-09-08 10:28:56 UTC [libsqlite3, noupgrade]
|
||||
[matsune@nitro5 ProcessControl]$
|
||||
```
|
||||
|
||||
## [47] Tutor — actions taken
|
||||
|
||||
- Read-only, since the `pacman -Ql` output wasn't pasted: `pacman -Ql syncthing` lists `/usr/bin/syncthing`, a system template unit `/usr/lib/systemd/system/syncthing@.service`, and a **user unit `/usr/lib/systemd/user/syncthing.service`**.
|
||||
- `systemctl --user is-enabled syncthing.service` → `disabled`; `is-active` → `inactive`. Nothing was enabled or started. That changes the student's user configuration, so the student runs it.
|
||||
|
||||
## [47] Tutor — reply
|
||||
|
||||
✅ **Observed:** Syncthing v2.1.5 is installed. I checked the unit files myself: the package ships a **user unit**, `syncthing.service`, currently *disabled* and *inactive*.
|
||||
|
||||
**Start it** (your choice):
|
||||
- **Background, starts with your session** (recommended, since the message board has to sync while your Java programs run):
|
||||
```bash
|
||||
systemctl --user enable --now syncthing.service
|
||||
systemctl --user status syncthing.service
|
||||
```
|
||||
To undo later: `systemctl --user disable --now syncthing.service`.
|
||||
- **Foreground, for a one-off try:** run `syncthing` in a terminal and leave it open.
|
||||
|
||||
Then open **`http://127.0.0.1:8384`** in a browser. You should see the Syncthing web GUI with your own device.
|
||||
|
||||
**Still needed before Step 21 can work:**
|
||||
1. A **second machine** with Syncthing, since Step 21 connects devices. Which one will you use?
|
||||
2. The open Step 20 question: why is Syncthing **not** a message broker, even though messages travel through it?
|
||||
|
||||
**Tell me:** whether the GUI opens (and the `status` line saying `active (running)`, if you used the service), plus answers 1 and 2.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), detour: installing Syncthing
|
||||
- Last observed result: `syncthing v2.1.5` installed; user unit `syncthing.service` present, disabled/inactive
|
||||
- Unresolved problem: second machine unknown; "not a broker" question open
|
||||
- Next action: student starts Syncthing, opens the GUI, names the second machine, answers the broker question
|
||||
|
||||
---
|
||||
|
||||
## [48] Student (2026-09-24)
|
||||
|
||||
> can you move the `ProcessControl` folder from /GitRepo/UniFr/ComputerScience/ to /GitRepo/Notes/ProcessControl? (including the conv)
|
||||
|
||||
## [48] Tutor — actions taken
|
||||
|
||||
- Looked before touching anything: `/GitRepo/Notes/ProcessControl` **already existed** (created 22 Sep 14:56) and was a second clone of the same repo — same branch `main`, same HEAD `e079932`, same remote, same uncommitted log edits, no stashes, no extra branches.
|
||||
- `diff -rq` between the two: every working file byte-identical, including `conv/` and `conv/03-part-III.md`. Only `.git/config` differed (the Notes copy has a VS Code `vscode-merge-base = origin/main` line) and `.git/index` (timestamps).
|
||||
- Checked the parent repo `UniFr/ComputerScience`: ProcessControl was only ever untracked there (`?? ProcessControl/`), so nothing tracked depended on it.
|
||||
- Asked the student how to finish, since the destination was occupied and finishing meant deleting a directory. Answer: **delete the old folder**.
|
||||
- Re-verified both trees were identical, then `rm -rf /mnt/data/Documents/GitRepo/UniFr/ComputerScience/ProcessControl`. Confirmed it's gone and the Notes copy is intact (`## main...origin/main`, same 5 pending log changes).
|
||||
- Copied the session's project memories (tutor rules, schedule tracking, log layout) to `~/.claude/projects/-mnt-data-Documents-GitRepo-Notes-ProcessControl/memory/`, a guess at the new project key, so a future session in the new path still has them. The originals were left in place.
|
||||
- This log entry is written in the surviving copy under `/GitRepo/Notes/ProcessControl`.
|
||||
|
||||
## [48] Tutor — reply
|
||||
|
||||
Done. The folder now lives only at `/GitRepo/Notes/ProcessControl`, with `conv.md`, `conv/` and the git history.
|
||||
|
||||
Notes for you:
|
||||
- Your Notes repo sees `ProcessControl/` as an untracked **embedded repository**. If you ever run `git add .` in `Notes/`, git will warn and record only a pointer. I can add `ProcessControl/` to `Notes/.gitignore` if you want.
|
||||
- Uncommitted work travelled with the folder: the log edits for turns 41–48 are still uncommitted here.
|
||||
- I copied my saved project notes to a path matching the new location. If a future session seems to have forgotten the tutoring rules (no answer pre-filling, schedule reminders, per-part log), say so and I'll fix the path.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), Syncthing detour
|
||||
- Last observed result: folder moved (old copy deleted after verifying the new one was identical); Syncthing v2.1.5 installed, user unit disabled/inactive
|
||||
- Unresolved problem: Syncthing not started yet; second machine unknown; "not a broker" question open
|
||||
- Next action: student starts Syncthing, opens `http://127.0.0.1:8384`, names the second machine, answers the broker question
|
||||
|
||||
---
|
||||
|
||||
## [49] Student
|
||||
|
||||
> Base on the siblings folder, can you start doing resume/construct quarto course (3lang, OG = English, french and german to do) and add each time I end a step the summary, with diagram (interactive one for the web version)?
|
||||
|
||||
## [49] Tutor — actions taken
|
||||
|
||||
- Studied the sibling courses in `Notes/`: the `_course` template (`NEW-COURSE.md`), the shared `notes` extension (`i18n.lua`, glossary, exercises), `Analysis` (first multilingual course, TikZ figures, an animated html-only figure) and **`Database`** — the closest model: English default profile, `_output/` + `_output/fr/` + `_output/de/`, `i18n.yml`, and a figure pipeline of hand-written SVG sources with `{{key}}` labels built per language to svg (web) and pdf (print).
|
||||
- Asked four questions (book at the repo root · one chapter per tutorial part · Database figure pipeline plus a JS layer · write all three languages now). All four answered with the recommended option.
|
||||
- Copied the shared boilerplate from `Database`: `_extensions/notes/`, `_i18n-switcher.html`, `theme.scss`, `figures/build-figures.py`, `figures/diagram.css`.
|
||||
- Wrote the project: `_quarto.yml` (+ `_quarto-en.yml`, `_quarto-fr.yml`, `_quarto-de.yml`), `render-all.sh`, `.gitignore`, `preamble.tex`, `i18n.yml`.
|
||||
- Wrote three diagrams as SVG sources with `{{key}}` labels and per-language strings in `figures/labels.yml`: `direct-calls`, `mailboxes-jvm`, `filesystem-processes` (8 flow hops and 9 nodes each for the last two).
|
||||
- Wrote `figures/flow-player.html`: for every `img.flow-figure` it fetches the built svg, inlines it and adds a Play / One hop / Reset bar that walks a message along the `data-flow` edges, lighting up each `data-flow-node` it reaches. The pdf and a browser without JavaScript keep the same still picture.
|
||||
- Wrote the chapters: `index.qmd` (about, how to read the diagrams, how to build), `00-orientation.qmd` (step 0), `01-part-i-calls.qmd` (steps 1–10) and `02-part-ii-processes.qmd` (steps 11–18), each in English, French and German, with the observations from our own runs.
|
||||
- Fixed two build problems found on the way: invalid `--` inside the svg comments (rsvg-convert refused the files) and hex link colours that xcolor rejected (now named colours defined in `preamble.tex`).
|
||||
- Verified: `./render-all.sh` builds **all six outputs** (html + pdf for en/fr/de). Each book pulls its own language's figures; the sidebar titles are translated. Known cosmetic limitation, identical in the `Database` book: the pagination links' `aria-label` still shows the raw `[..]{.en}[..]{.fr}[..]{.de}` heading, because Quarto reads those before the filters run.
|
||||
- Not verified: the animation itself in a real browser. Nothing else depends on it.
|
||||
|
||||
## [49] Tutor — reply
|
||||
|
||||
The book exists and builds in all three languages. Summary of what was created, what was verified, and how the per-step routine works from now on. Nothing was committed yet.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III) — the tutorial itself is untouched by this work
|
||||
- Last observed result: `./render-all.sh` built html + pdf for en, fr and de (six outputs)
|
||||
- Unresolved problem: the flow animation is not verified in a browser; deployment (Gitea hook + Caddy) not set up for this course
|
||||
- Next action: student checks the book in a browser (`./render-all.sh --serve`), says whether to commit, and continues the Syncthing detour for Step 19–20
|
||||
|
||||
---
|
||||
|
||||
## [50] Student
|
||||
|
||||
> is it possible to move this chat (the one i launch with `claude --resume`) to the new folder too as the folder no longer exists?
|
||||
|
||||
## [50] Tutor — actions taken
|
||||
|
||||
- Inspected `~/.claude/projects/`: the old key `-mnt-data-Documents-GitRepo-UniFr-ComputerScience-ProcessControl/` held this live session `37a0236e-…jsonl` (4.0 MB, still growing), an earlier session `7a7a8220-…jsonl` with its `custom-title.json` sidecar, and the `memory/` folder (already copied on 24 Sep). The new key `-mnt-data-Documents-GitRepo-Notes-ProcessControl/` held only `memory/`.
|
||||
- **Hard-linked** the live transcript into the new project folder (verified: same inode 46550777, link count 2), so it keeps growing under both names while this session runs.
|
||||
- Copied the earlier session's `.jsonl` and its sidecar directory to the new folder. Nothing was deleted; the old folder still holds its copies.
|
||||
- Checked `~/.claude.json`: both path keys exist, both with `hasTrustDialogAccepted: true` and an empty `allowedTools`, no MCP servers. Nothing worth migrating, so the file was left untouched. Only `lastSessionId` is missing for the new path, and Claude Code writes that for the current working directory when the session ends.
|
||||
|
||||
## [50] Tutor — reply
|
||||
|
||||
Yes — done, and this session is now resumable from the new folder.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), Syncthing detour
|
||||
- Last observed result: session transcripts linked/copied into `~/.claude/projects/-mnt-data-Documents-GitRepo-Notes-ProcessControl/`
|
||||
- Unresolved problem: old transcript copies still in place (student's call whether to delete)
|
||||
- Next action: student resumes from the new folder if they like, and continues the Syncthing setup
|
||||
|
||||
---
|
||||
|
||||
## [51] Student
|
||||
|
||||
> Quick question, is possible to have java terminal inside the Quarto file to run the code directly there?
|
||||
|
||||
## [51] Tutor — actions taken
|
||||
|
||||
- Found the house precedent: `FuncLogProg/_extensions/elixir/` (`elixir-run.lua`, `runner.exs`, `elixir-run.css`) runs ```` ```{.elixir .run} ```` blocks **at render time**, prints the output under the block, caches results in `.elixir-cache/`, and degrades to plain code when `elixir` is missing. Read the filter in full.
|
||||
- Read-only checks on this machine: `jshell 26.0.2.1` present, `java` present, Jupyter has only a `python3` kernel (no IJava), `asciinema` not installed.
|
||||
|
||||
## [51] Tutor — reply
|
||||
|
||||
Answered: a live terminal in the page needs a backend or WASM and cannot run this course's programs; a render-time `.run` block for Java is the practical option, modelled on the existing Elixir filter. Offered to build `_extensions/java/java-run.lua`.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), Syncthing detour
|
||||
- Last observed result: Elixir run-filter pattern identified as the model; `jshell`/`java` available, no IJava kernel
|
||||
- Unresolved problem: student's decision on whether to build the Java run filter
|
||||
- Next action: student says yes/no to `java-run`, then back to Syncthing
|
||||
|
||||
---
|
||||
|
||||
## [52] Student
|
||||
|
||||
> no thx, thx 4 the explanation
|
||||
|
||||
## [52] Tutor — actions taken
|
||||
|
||||
- None. No `java-run` filter is being built; the chapters keep showing commands with their observed output as text.
|
||||
|
||||
## [52] Tutor — reply
|
||||
|
||||
Noted, nothing built. Back to the Syncthing detour for Steps 19–20.
|
||||
|
||||
**Progress record**
|
||||
- Current step: 19–20 (Part III), Syncthing detour
|
||||
- Last observed result: `syncthing v2.1.5` installed; user unit `syncthing.service` present but disabled and inactive
|
||||
- Unresolved problem: Syncthing not started; second machine unknown; "why Syncthing is not a message broker" unanswered
|
||||
- Next action: student starts Syncthing, opens `http://127.0.0.1:8384`, names the second machine, answers the broker question
|
||||
|
||||
---
|
||||
|
||||
<!-- nav -->
|
||||
> [⬅ Previous: Part II](02-part-II.md) · [Index](../conv.md) · Next: *(not started yet)* ➡
|
||||
>
|
||||
> All parts: [Setup & Step 0](00-setup-and-step-0.md) · [Part I](01-part-I.md) · [Part II](02-part-II.md) · **Part III**
|
||||
<!-- /nav -->
|
||||
Reference in new issue
Block a user