forked from bai/curriculum-project-hub
docs(adr): cph 的 nested-manifest / batch-export 改号 0036/0037
上游 0029/0030 与本地 filelib 侧同号 ADR 相撞,cph 两份改到本地空闲号段, 代码锚点引用一并跟随。
This commit is contained in:
@@ -229,9 +229,9 @@ pub fn build(root: &Path, engine: &Engine, target: &str) -> (Option<Vec<u8>>, Ch
|
||||
}
|
||||
}
|
||||
|
||||
/// Build a PDF for a **bundle** target (ADR-0030): the multi-lesson combined
|
||||
/// Build a PDF for a **bundle** target (ADR-0037): the multi-lesson combined
|
||||
/// artifact. Mirrors [`build`]'s contract and gating, but runs phases (a)–(c)
|
||||
/// over **every member lesson independently** (ADR-0030's invariant: each
|
||||
/// over **every member lesson independently** (ADR-0037's invariant: each
|
||||
/// lesson stays independently checkable; the bundle only reads them for
|
||||
/// assembly). Any member's structural/schema error refuses the whole bundle
|
||||
/// build — a broken member lesson makes the combined artifact invalid too.
|
||||
@@ -288,7 +288,7 @@ pub fn build_bundle(root: &Path, engine: &Engine, target: &str) -> (Option<Vec<u
|
||||
}
|
||||
|
||||
/// The bundle's declared export-target names, in declared order — or
|
||||
/// `[DEFAULT_TARGET]` if it declares none (ADR-0030 batch default, mirroring
|
||||
/// `[DEFAULT_TARGET]` if it declares none (ADR-0037 batch default, mirroring
|
||||
/// [`declared_target_names`]).
|
||||
pub fn declared_bundle_target_names(root: &Path) -> Vec<String> {
|
||||
let (bundle, _) = cph_model::load_bundle(root);
|
||||
@@ -301,7 +301,7 @@ pub fn declared_bundle_target_names(root: &Path) -> Vec<String> {
|
||||
}
|
||||
|
||||
/// The lesson's declared export-target names, in declared order — or
|
||||
/// `[DEFAULT_TARGET]` if it declares none (ADR-0030 batch default: `cph build`
|
||||
/// `[DEFAULT_TARGET]` if it declares none (ADR-0037 batch default: `cph build`
|
||||
/// with no `--target` builds every declared target).
|
||||
///
|
||||
/// Loads the lesson read-only, ignoring diagnostics: an unloadable lesson (or
|
||||
@@ -564,7 +564,7 @@ pub struct MarkdownAssembleReport {
|
||||
}
|
||||
|
||||
/// Execute the `AssembleMarkdown` steps of a target (ADR-0015): concatenate each
|
||||
/// element's `<field>.md` markdown content file in `parts` order (ADR-0029's
|
||||
/// element's `<field>.md` markdown content file in `parts` order (ADR-0036's
|
||||
/// depth-first element sequence) into the target's single-file artifact.
|
||||
/// This is the **third typed step**: unlike
|
||||
/// [`build`] (typst template → PDF) the framework owns the read/concatenate/write
|
||||
|
||||
Reference in New Issue
Block a user