forked from EduCraft/curriculum-project-hub
sjfhsjfh
c17af60bb0
Single entry `display(info, target, parts)` over an ordered parts array, the frozen contract the generated typst driver calls. Per-kind dispatch for segment/example/lemma/sop; student/teacher matrix derived internally from `target` (student hides example solution + lemma proof; teacher shows all). Content-field values are consumed as already-evaluated content (driver `include`s them ⇒ module body, ADR-0006), never imported/stringified. Optional fields (lemma proof, example source) handled gracefully; unknown kind/target degrade without crashing. Zero @preview deps (CI-robust); CJK + math styled. Smoke compiles to non-empty student/teacher PDFs. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
104 lines
3.7 KiB
Typst
104 lines
3.7 KiB
Typst
// cph-render — curriculum lesson render package.
|
|
//
|
|
// Single public entry: `display(info, target, parts)`.
|
|
//
|
|
// A lesson is an ORDERED array of typed parts. Each part is a dict with a
|
|
// `kind` plus that kind's content/scalar fields. Content field VALUES are
|
|
// already-evaluated typst content (the driver produces them via `include`) —
|
|
// never modules or strings; we render them directly.
|
|
//
|
|
// kind -> fields (MVP):
|
|
// segment : textbook (content, required)
|
|
// example : problem (content, required), solution (content, required),
|
|
// source (string, optional)
|
|
// lemma : stmt (content, required), proof (content, optional)
|
|
// sop : sop (content, required)
|
|
//
|
|
// target -> show/hide (the (kind x target) render matrix; defaults per
|
|
// ADR-0005/0008, derived internally — caller passes no flags):
|
|
// student : example problem only (hide solution); lemma stmt only (hide
|
|
// proof); segment textbook; sop shown.
|
|
// teacher : everything shown.
|
|
// unknown : rendered conservatively == student (show only required-public
|
|
// fields). Never crashes. The "no render rule => warning"
|
|
// diagnostic is the Rust side's job, not ours.
|
|
|
|
#import "src/style.typ": base-style, title-block, subtitle-block
|
|
#import "src/elements/segment.typ": display-segment
|
|
#import "src/elements/example.typ": display-example
|
|
#import "src/elements/lemma.typ": display-lemma
|
|
#import "src/elements/sop.typ": display-sop
|
|
#import "src/elements/common.typ": example-counter, lemma-counter
|
|
|
|
/// Resolve a target string to the set of show/hide booleans.
|
|
/// Unknown targets fall back to the conservative (student-like) profile.
|
|
#let _flags-for(target) = {
|
|
if target == "teacher" {
|
|
(show-solution: true, show-proof: true, subtitle: [教师版讲义])
|
|
} else if target == "student" {
|
|
(show-solution: false, show-proof: false, subtitle: [学生版讲义])
|
|
} else {
|
|
// Unknown target: conservative — show only required-public fields.
|
|
(show-solution: false, show-proof: false, subtitle: [讲义])
|
|
}
|
|
}
|
|
|
|
/// Render one part according to its `kind`. Unknown kinds render an inline
|
|
/// note instead of crashing.
|
|
#let _render-part(part, flags) = {
|
|
let kind = part.at("kind", default: none)
|
|
if kind == "segment" {
|
|
display-segment(part)
|
|
} else if kind == "example" {
|
|
display-example(part, show-solution: flags.show-solution)
|
|
} else if kind == "lemma" {
|
|
display-lemma(part, show-proof: flags.show-proof)
|
|
} else if kind == "sop" {
|
|
display-sop(part)
|
|
} else {
|
|
// Don't crash on an unrecognised kind; surface it visibly instead.
|
|
block(
|
|
width: 100%,
|
|
inset: 0.6em,
|
|
fill: red.lighten(85%),
|
|
stroke: red.darken(20%) + 0.6pt,
|
|
radius: 0.4em,
|
|
text(fill: red.darken(30%), weight: "bold")[
|
|
[未知部件类型 / unknown kind: #repr(kind)]
|
|
],
|
|
)
|
|
}
|
|
}
|
|
|
|
/// THE ENTRY POINT.
|
|
///
|
|
/// - `info`: dict, e.g. (title: "…", author: "…"). `author` may be absent.
|
|
/// - `target`: string. MVP: "student" | "teacher". Unknown => conservative.
|
|
/// - `parts`: ordered array of part dicts (see file header).
|
|
#let display(info: (:), target: "student", parts: ()) = {
|
|
let title = info.at("title", default: [])
|
|
let author = info.at("author", default: none)
|
|
|
|
// `document` author wants a string/array; normalise the optional field.
|
|
set document(
|
|
title: title,
|
|
author: if author == none { () } else { author },
|
|
)
|
|
|
|
show: base-style
|
|
|
|
// Reset shared counters so each rendered lesson numbers from 1.
|
|
example-counter.update(0)
|
|
lemma-counter.update(0)
|
|
|
|
let flags = _flags-for(target)
|
|
|
|
title-block()
|
|
subtitle-block(flags.subtitle)
|
|
|
|
// Render strictly in array order.
|
|
for part in parts {
|
|
_render-part(part, flags)
|
|
}
|
|
}
|