docs(adr): cph 的 nested-manifest / batch-export 改号 0036/0037

上游 0029/0030 与本地 filelib 侧同号 ADR 相撞,cph 两份改到本地空闲号段,
代码锚点引用一并跟随。
This commit is contained in:
2026-08-06 00:51:33 +08:00
parent e878b46701
commit ecc92c9a87
27 changed files with 100 additions and 100 deletions
+3 -3
View File
@@ -1,4 +1,4 @@
# Default export templates (ADR-0011, outline shape ADR-0029)
# Default export templates (ADR-0011, outline shape ADR-0036)
`student.typ` / `teacher.typ` are the **framework default templates**. In a real
engineering file they live at `exports/student.typ` / `exports/teacher.typ`; the
@@ -9,7 +9,7 @@ offline smoke test below.
Each template:
1. reads the injected manifest: `toml(sys.inputs.manifest)`;
2. loops `manifest.outline` (ADR-0029's depth-first rendering order — elements
2. loops `manifest.outline` (ADR-0036's depth-first rendering order — elements
interleaved with section headings at their DFS-open position). For an
`type = "element"` entry: `include`-ing each content field via a computed
**root-relative absolute** path `/<part.path>/<field>.typ`, and reading
@@ -46,7 +46,7 @@ content and hands `render-lesson` an already-assembled `outline` array;
disk. *(OPEN: the exact manifest shape for this is for the Rust/manifest
contract to pin.)*
- **Sections carry no content fields.** A `type = "section"` outline entry
(ADR-0029) has only `kind`/`title`/`depth`/`path`; the template passes it
(ADR-0036) has only `kind`/`title`/`depth`/`path`; the template passes it
through untouched — no `include`, no `element.toml` read.
## Offline smoke test
+2 -2
View File
@@ -1,4 +1,4 @@
// DEFAULT BUNDLE TEMPLATE (ADR-0030, outline shape ADR-0029).
// DEFAULT BUNDLE TEMPLATE (ADR-0037, outline shape ADR-0036).
//
// Lives in a bundle at `<bundle-root>/exports/<target>.typ`, e.g.
// `exports/merged.typ`. Compiled AS MAIN with the augmented BUNDLE manifest
@@ -66,7 +66,7 @@
))
// Presentation: shared per-level heading numbering across the whole bundle,
// and the ADR-0030 recommended default of resetting auto-counters at each
// and the ADR-0037 recommended default of resetting auto-counters at each
// lesson boundary (override `reset-counters: false` for continuous numbering).
#render-bundle(
info: info,
+3 -3
View File
@@ -1,4 +1,4 @@
// DEFAULT STUDENT TEMPLATE (framework default; ADR-0011, outline shape ADR-0029).
// DEFAULT STUDENT TEMPLATE (framework default; ADR-0011, outline shape ADR-0036).
//
// This is a *real, editable* file that lives in an engineering file at
// `exports/student.typ`. The framework compiles it AS THE MAIN FILE with the
@@ -16,7 +16,7 @@
// PACKAGE, not the engineering root. A `/<part.path>/<field>.typ` written HERE
// (this template lives under `--root`) resolves against `--root`. So the
// template loads content and hands cph-render an already-assembled `outline`
// array (elements interleaved with section headings, ADR-0029).
// array (elements interleaved with section headings, ADR-0036).
//
// OPEN CONTRACT POINT — optional-content presence. typst has no "does this file
// exist" primitive (a missing `include` is a hard compile error). So the
@@ -43,7 +43,7 @@
// resolved against --root) and read scalar fields from <path>/element.toml.
// `part-fields` (from cph-render) is the single source of truth for
// kind->fields.
// - a "section" entry (ADR-0029): pass its title/depth straight through — no
// - a "section" entry (ADR-0036): pass its title/depth straight through — no
// content to load, it is a heading.
#let outline = raw-outline.map(raw => {
if raw.at("type", default: "element") == "section" {
+2 -2
View File
@@ -1,4 +1,4 @@
// DEFAULT TEACHER TEMPLATE (framework default; ADR-0011, outline shape ADR-0029).
// DEFAULT TEACHER TEMPLATE (framework default; ADR-0011, outline shape ADR-0036).
//
// Lives in an engineering file at `exports/teacher.typ`. Compiled AS MAIN with
// the manifest injected:
@@ -21,7 +21,7 @@
#let raw-outline = manifest.at("outline", default: ())
// Assemble each outline entry: an "element" entry includes its content fields
// and reads scalars from element.toml; a "section" entry (ADR-0029) passes
// and reads scalars from element.toml; a "section" entry (ADR-0036) passes
// title/depth straight through as a heading, no content to load.
#let outline = raw-outline.map(raw => {
if raw.at("type", default: "element") == "section" {