@litfamily/litcodex 1.0.14 → 1.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README-Ko-KR.md +10 -10
  2. package/README.md +10 -10
  3. package/dist/install/generated-skill-payload-hashes.d.ts +101 -40
  4. package/dist/install/generated-skill-payload-hashes.js +101 -40
  5. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  6. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  7. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  8. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  9. package/marketplace/plugins/litcodex/components/lit-loop/dist/auto-handoff.js +11 -7
  10. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  15. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  16. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/THIRD-PARTY-NOTICE.txt +0 -2
  17. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +16 -12
  18. package/marketplace/plugins/litcodex/skills/lit-docx/references/components.md +113 -0
  19. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +164 -0
  20. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +95 -0
  21. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/02-brief-ko.md +45 -0
  22. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/03-manual-ko.md +105 -0
  23. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/04-proposal-ko.md +97 -0
  24. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/05-memo-en.md +34 -0
  25. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/06-journal-en.md +89 -0
  26. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/07-report-en.md +101 -0
  27. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/08-proposal-en.md +94 -0
  28. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/09-memo-ko.md +34 -0
  29. package/marketplace/plugins/litcodex/skills/lit-docx/references/page-composition.md +141 -0
  30. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/brief.md +70 -0
  31. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/journal.md +73 -0
  32. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/manual.md +70 -0
  33. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/memo.md +75 -0
  34. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/proposal.md +71 -0
  35. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/report.md +83 -0
  36. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/convert_md_to_docx.py +401 -58
  37. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_craft.py +124 -1
  38. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +2446 -0
  39. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_layout.py +960 -0
  40. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/slop_lint.py +21 -6
  41. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
  42. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +26 -0
  43. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
  44. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +27 -0
  45. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +27 -0
  46. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +27 -0
  47. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +12 -11
  48. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Bold.otf +0 -0
  49. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Regular.otf +0 -0
  50. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +33 -29
  51. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +11 -2
  52. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +179 -0
  53. package/marketplace/plugins/litcodex/skills/lit-pptx/references/design-system-azure.md +1 -1
  54. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +203 -0
  55. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +185 -0
  56. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/02-pitch-studio-en.md +162 -0
  57. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +229 -0
  58. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +212 -0
  59. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/05-research-keynote-night-ko.md +191 -0
  60. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +175 -0
  61. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/07-data-review-night-en.md +241 -0
  62. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/08-field-report-atlas-ko.md +168 -0
  63. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +219 -0
  64. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/10-status-update-ledger-en.md +157 -0
  65. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/11-portfolio-studio-ko.md +183 -0
  66. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/12-tutorial-chalk-en.md +176 -0
  67. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/13-status-update-gazette-ko.md +157 -0
  68. package/marketplace/plugins/litcodex/skills/lit-pptx/references/interview-protocol.md +1 -1
  69. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +210 -0
  70. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +146 -0
  71. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +113 -0
  72. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +115 -0
  73. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +118 -0
  74. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +129 -0
  75. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +126 -0
  76. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +109 -0
  77. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +121 -0
  78. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +111 -0
  79. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +65 -17
  80. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +654 -11
  81. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +1 -1
  82. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/inventory.py +32 -2
  83. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/directive-parser.js +2 -2
  84. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
  85. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +401 -16
  86. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
  87. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-html.js +2 -2
  88. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +498 -145
  89. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +3558 -0
  90. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-ast.js +54 -6
  91. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +335 -11
  92. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  93. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +99 -19
  94. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +6 -1
  95. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/boilerplate_professional.css +6 -6
  96. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
  97. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
  98. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
  99. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
  100. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +105 -0
  101. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +110 -0
  102. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +105 -0
  103. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +106 -0
  104. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +106 -0
  105. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +111 -0
  106. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +107 -0
  107. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +105 -0
  108. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +1 -1
  109. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/fonts.mjs +6 -6
  110. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gate.mjs +1 -1
  111. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +2 -2
  112. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  113. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +1 -1
  114. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  115. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +1 -1
  116. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/type-and-timing.md +3 -3
  117. package/node_modules/@litcodex/lit-loop/dist/auto-handoff.js +11 -7
  118. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  119. package/package.json +2 -2
  120. package/readme-assets/badge-version.svg +1 -1
  121. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Bold.otf +0 -0
  122. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Regular.otf +0 -0
@@ -0,0 +1,210 @@
1
+ # Layout families
2
+
3
+ Each family turns one job a slide can do into a fixed arrangement of the 12 columns. You pick it
4
+ with `layout:`; the tonality decides how it is drawn (allowed title treatments, table and chart style,
5
+ rules, fields, panels). There are 28 content families plus cover, section and closing variants.
6
+ No pack implements all of them: each carries the ones that suit its character, and the compiler
7
+ either stops or writes a `note:` when a source asks a pack for something it lacks.
8
+
9
+ Choose the family from what the slide must do for the reader. "Last slide was a chart, so this one
10
+ should be a table" produces a deck of shapes without jobs. A deck reads as varied when different
11
+ jobs get different shapes, and the gate measures exactly that from the compiled file (OF-111).
12
+
13
+ ```bash
14
+ node "$OFFICE" pptx compile --list-tonalities
15
+ node "$OFFICE" pptx compile --list-layouts gazette # families, allowed treatments, variants
16
+ ```
17
+
18
+ ## Families by job
19
+
20
+ Columns: what the family does, the source shape it reads, and the packs that carry it.
21
+
22
+ ### Words
23
+
24
+ | Family | Job | Source shape | Packs |
25
+ |---|---|---|---|
26
+ | `text-column` | running text or a list that keeps a readable measure | bullets or 개조식 groups (`- **head**` then `(1)` sub-points); an image turns it into a picture-and-text split | atlas, chalk, gazette, paper |
27
+ | `text-two-column` | a long list with two parallel halves | groups split near the middle, or an explicit `:::: columns` block | gazette, ledger, studio |
28
+ | `summary-box-list` | a boxed conclusion over two columns of evidence | `::: key-message` for the box (else the first line), groups under it | gazette |
29
+ | `sidebar-note` | a main point fenced off from its definition or common mistake; a note too short for its column runs across the top at lead size with the main points in two columns under it, and under a side title it stands in the rail | groups, then `::: main-box` (or a last list) that becomes the note | chalk |
30
+ | `agenda` | the parts of the deck, numbered | `- **Part** what it covers` lines | chalk, gazette, ledger |
31
+ | `statement` | a pull quote, or a display-led deck on request | the `##` text is set large; one body line becomes the support line | atlas, chalk, night, paper, signal, studio |
32
+ | `quote` | a quoted sentence with its speaker | the quote as a line, the source as a line starting with `—` | chalk, paper, signal |
33
+
34
+ ### Numbers
35
+
36
+ | Family | Job | Source shape | Packs |
37
+ |---|---|---|---|
38
+ | `kpi-row` | two to six headline figures | a table: head row of labels, first body row of values, second body row of each figure's basis; then evidence bullets | atlas, ledger, night, signal, studio |
39
+ | `kpi-over-chart` | headline figures over the trend behind them | a KPI table, then a `::: chart` block, then bullets | ledger, night |
40
+ | `big-number` | two to four related figures as a data panel | a KPI table (labels, values, basis row), a `>` caption, two or three evidence lines | ledger, night, signal, studio |
41
+ | `dashboard-grid` | two to four small charts read together | two or more `::: chart` blocks, then a line or two of takeaway | ledger, night |
42
+
43
+ ### Tables and charts
44
+
45
+ | Family | Job | Source shape | Packs |
46
+ |---|---|---|---|
47
+ | `table-insight` | a table with its reading beside it | a pipe table, a `>` caption, then bullets | chalk, gazette, ledger, paper, signal |
48
+ | `ledger-table` | a full-width table that is the evidence | a wider table (five to eight rows, four to six columns), caption, bullets under it | gazette, ledger |
49
+ | `matrix-2x2` | options placed on two axes | a 3 × 3 table: corner cell `효과 \ 난이도`, two column heads, two row heads, cells written `item · detail · detail`; caption and takeaways after | gazette, ledger |
50
+ | `comparison` | two sides read across, criterion by criterion | `:::: columns` with a `**head**` and `(1)` `(2)` points per side; identical `기준: …` labels on both sides become a criteria column, in the rail under a side title; a label longer than three words does not count as one, so the points stay whole and stay out of the rail | all eight |
51
+ | `chart-insight` | one chart with two or three takeaways | a `::: chart` block, then bullets | ledger, night, paper, signal, studio |
52
+ | `full-chart` | one chart that needs the width | a `::: chart` block, an optional note | ledger, night, paper, signal |
53
+
54
+ ### Sequences and methods
55
+
56
+ | Family | Job | Source shape | Packs |
57
+ |---|---|---|---|
58
+ | `process` | three to five ordered steps | `- **1. 단계** what happens` lines, optional `(1)` sub-points | chalk, signal |
59
+ | `step-diagram` | steps taught one at a time | as `process` | chalk |
60
+ | `timeline` | dated events on one axis | a table `시점 \| 할 일 \| 담당` (or `- **date** event` lines), then takeaways | atlas, gazette, ledger, night, studio |
61
+ | `method` | a formula or figure with its terms | a text line or an image, then `- **term** meaning` bullets | chalk, night, paper |
62
+ | `references-appendix` | sources and definitions, one per row | `- [1] …` lines; links as real Markdown links | gazette, ledger, paper |
63
+
64
+ ### Pictures
65
+
66
+ | Family | Job | Source shape | Packs |
67
+ |---|---|---|---|
68
+ | `image-full` | one picture as the page, title on a panel | an image with a caption `도 1. … \| 출처: …` | atlas, studio |
69
+ | `image-split` | a picture beside its explanation | an image, then bullets | atlas, chalk, signal, studio |
70
+ | `photo-grid` | two or three pictures compared | two or three image lines, then one line of text | atlas, studio |
71
+ | `figure-pair` | before and after, or two conditions | two images, then one line of text | atlas, paper |
72
+ | `figure-academic` | a numbered figure and how to read it | an image with numbered caption and source; observation, limitation, implication bullets | paper |
73
+ | `asymmetric-feature` | one large element and a narrow text column | an image or a one-cell figure, then bullets | atlas, signal, studio |
74
+
75
+ Older layout names still resolve under a tonality: `content` and `main` become `text-column`,
76
+ `summary` becomes `comparison`, `closing` becomes `closing-statement`, and bare `cover` or `section`
77
+ take the pack's first variant (the compile log says which).
78
+
79
+ ## Covers, sections, closings
80
+
81
+ These are variants. Name one (`layout: cover-index`); the compiler draws it if the pack lists it and
82
+ the deck holds what it needs, else it takes the pack's first drawable variant and writes why.
83
+
84
+ | Pack | Covers (first is the default) | Sections | Closings |
85
+ |---|---|---|---|
86
+ | Atlas | cover-full-image, cover-split-image, cover-typographic | section-image, section-field | closing-contact-split, closing-ask |
87
+ | Chalk | cover-rail, cover-typographic, cover-numeral | section-numeral, section-rail | closing-summary-list, closing-ask |
88
+ | Gazette | cover-band, cover-typographic, cover-index | section-band, section-rule | closing-decision-box, closing-ask |
89
+ | Ledger | cover-figures, cover-typographic, cover-index | section-rule, section-numeral | closing-decision-box, closing-ask |
90
+ | Night | cover-numeral, cover-typographic, cover-figures | section-numeral, section-field | closing-statement, closing-decision-box |
91
+ | Paper | cover-index, cover-typographic, cover-split-image | section-rule, section-field | closing-summary-list, closing-ask |
92
+ | Signal | cover-numeral, cover-typographic, cover-split-field | section-field, section-numeral | closing-statement, closing-ask |
93
+ | Studio | cover-split-image, cover-rail, cover-numeral | section-numeral, section-rail | closing-contact-split, closing-summary-list |
94
+
95
+ What each variant needs from the deck:
96
+
97
+ | Variant | Draws | Needs |
98
+ |---|---|---|
99
+ | `cover-figures` | the title over the deck's headline figures | a KPI row somewhere in the deck |
100
+ | `cover-index` | the title beside the list of parts | an agenda, or two or more sections |
101
+ | `cover-numeral` | a real year or figure, at title size at most, over the title | a year in the title or the date |
102
+ | `cover-split-image`, `cover-full-image` | the title beside, or on a panel over, the deck's first picture | an image in the deck |
103
+ | `cover-band`, `cover-rail`, `cover-split-field`, `cover-typographic` | the pack's band, rail, half field or cover device | nothing |
104
+ | `section-numeral`, `section-rule` | the part number and title; with an agenda, an index page with this part marked | nothing; a lone section with no agenda draws no numeral |
105
+ | `section-band` | the part index inside the band, the part title under it with the titles of the slides it opens | nothing |
106
+ | `section-field`, `section-rail`, `section-image` | the part title on a field, in the rail, or on the section's picture | `section-image` needs an image on that slide |
107
+ | `closing-ask` | the ask as title, its table as action rows keyed by amount or date, the next step on the floor | a table or bullets |
108
+ | `closing-decision-box` | the decision boxed, the items to approve as action rows under it | a line or bullets, optional table |
109
+ | `closing-summary-list` | the takeaways numbered down the page | bullets |
110
+ | `closing-contact-split` | action rows beside a field holding each row's amount or date; the next step as a band meeting the field | a table or bullets, plus a short text |
111
+ | `closing-statement` | one closing sentence | no table, no image |
112
+
113
+ A closing is a content slide whose title labels the ask ("유지보수 예산 1억 2천만 원 집행 요청"). A
114
+ slide that only says "감사합니다" or "Questions?" is not a closing.
115
+
116
+ ## Display devices
117
+
118
+ Covers, statements, big numbers and closings hold little text, so each pack names the device that
119
+ lets them hold the page (`display:` in the pack). A device frames what the deck already contains; it
120
+ never adds words or numbers.
121
+
122
+ | Pack | cover | statement | number panel | closing floor | section index |
123
+ |---|---|---|---|---|---|
124
+ | Atlas | plate (field plate under half the page) | drench (whole slide in the field) | tint | band | — |
125
+ | Chalk | rail | drench (whole slide in the field) | tint | box | — |
126
+ | Gazette | band | — | outline | box | yes |
127
+ | Ledger | figures | — | tint | box | yes |
128
+ | Night | numeral | open | tint | band | — |
129
+ | Paper | rules (journal title page) | rules | outline | rules | yes |
130
+ | Signal | drench (field edge to edge, title low) | open | field | band | — |
131
+ | Studio | first cover variant | rules (a hairline over the sentence and one under its support line; the offset rail stood empty beside it) | tint | band | — |
132
+
133
+ ## What the compiler does on its own
134
+
135
+ These behaviours are engine-side; authors should know them so they stop fighting them.
136
+
137
+ - **Line breaking.** Wrapped titles are split into lines of near-equal width with at least two words
138
+ on the last line where possible. Body text and table cells are broken at spaces by the compiler,
139
+ so a number keeps its unit ("51점", "4 분기", "(10월 14일)") instead of being split by the renderer, and a
140
+ short parenthetical such as "(▲ +3.9%)" (up to 16 characters) stays whole on its line.
141
+ - **Figures stay at title size.** KPI values, panel figures, action keys, cover figures and section
142
+ numerals never exceed the title step. A big number is two to four figures, one row each (value,
143
+ label, basis), on a panel seven of twelve columns wide, its evidence beside it.
144
+ - **Sections count themselves** from the agenda when the title matches an entry ("02 / 05"); with no
145
+ agenda and several sections they count sections; a single section gets no numeral.
146
+ - **Closing tables become action rows.** The key column is the one with amounts in one unit (each
147
+ row then draws its share bar), else the one headed as a date or deadline, else the last column.
148
+ Totals rows (`합계`, `Total`) are never action rows; cells holding only "—" are dropped.
149
+ - **Source strips.** A line starting `출처:`, `자료:`, `주:`, `Source:` or `Note:` on a content slide is
150
+ becomes a strip along the bottom of the body, set at source size. On a closing it joins the
151
+ next-step line instead.
152
+ - **Short content spreads.** Up to four process steps run as rows; bold-headed points become rows with
153
+ the head beside the point; groups of sub-points run in two columns; table takeaways stand in the
154
+ room under the table. The compact step never enlarges type to fill; instead a short KPI row turns
155
+ into figure rows next to its takeaways, a chart lists its values in a compact table below them,
156
+ and a method runs its formula across the top with the terms in two columns.
157
+ - **Dark pieces stay under half.** Any plate, rail or panel short of a full-page field takes less than
158
+ half the page, so the ground colour still reads as the page.
159
+
160
+ ## Same family, different treatment
161
+
162
+ Much of a deck's variety comes from one family drawn under different titles:
163
+
164
+ - `side-rail`: KPI rows run as value rows down the body; processes read top to bottom; a chart takes
165
+ columns 5-12 at full height. The rail under the title carries the slide's supporting content: a
166
+ comparison's criteria labels level with their rows, the takeaways of a chart, picture, figure row
167
+ or number panel (a chart's values as a small table under them when they fit), and the source line
168
+ at its foot. A table gives its takeaways to the rail only when the table, its rows opened, still
169
+ fills the body.
170
+ - `bottom-anchor`: the visual owns the top of the page and the label explains it from below, its last
171
+ line on the body floor; a big number stands on its panel there. A table takes a bottom title only
172
+ when no other title fits it.
173
+ - `band`: the body starts under the band and runs to the floor at reading size.
174
+ - `statement` with `quote`: the quotation becomes the slide's sentence and the speaker the support
175
+ line; the `##` label of that slide is not shown.
176
+
177
+ Beside a chart, figure or picture under a top title, the source and note lines close the takeaway
178
+ column instead of running across the foot, so the column reaches the floor with the visual; takeaways
179
+ that still leave more than 40 % of that column empty are set one step up when they fit. Process rows
180
+ under a top title do the same when the reading measure would leave a quarter of the body empty. The
181
+ gate's OF-115 reports a column, rail, title panel or bottom-title floor left empty.
182
+
183
+ ## Charts and figures under a tonality
184
+
185
+ A `::: chart` takes the pack's chart style. With several series, the accent goes to one: the latest
186
+ period when every series names one ("2026" over "2025", "Q3" over "Q2"), else the measured series
187
+ beside a plan, target, budget or prior period ("실적" over "계획"), else the last column, so put the
188
+ proposed or current series last when the names say neither. Data labels keep the decimals the table
189
+ writes: beside a table that says 46.0, the label says 46.0.
190
+
191
+ A plot or diagram exported as a picture on white stands as a white card on a dark tonality. Put a dark
192
+ variant beside it, named like the file with `.dark` before the extension (`assets/flow.png`,
193
+ `assets/flow.dark.png`): a dark tonality draws the variant, a light one the original. A `::: chart`
194
+ block is better still, since every tonality draws it in its own colours. OF-117 fails a picture that
195
+ is mostly near-white on a dark ground.
196
+
197
+ Korean text runs and charts with Korean labels are written as ko-KR (Latin-only runs stay en-US), so a
198
+ renderer applies Korean spacing rules to them.
199
+
200
+ ## Variety pass and notes
201
+
202
+ After choosing titles by fill, the compiler checks the deck the way OF-111 reads it (title zone ×
203
+ column partition over content slides, closings excluded). If too few distinct layouts appear, it
204
+ moves a data slide that shares a layout to a title that adds a new one, provided the slide neither
205
+ overflows nor exceeds its density band, and logs `variety: slide N drawn under <title> …`.
206
+
207
+ Read every `note:` line after a compile. Each one says the source asked for something this
208
+ direction does not do: a missing family, an undrawable variant, a title moved for fill or budget.
209
+ The fix is a different family for that slide, a shorter label, or a different tonality chosen
210
+ through `direction-step.md`. Notes are never silenced.
@@ -0,0 +1,146 @@
1
+ # Title treatments
2
+
3
+ A treatment answers four questions about a slide title at once: where the frame sits, at which
4
+ type step, in which colour, and what is drawn with it (a rule, a band, a rail, a numeral, a dark
5
+ panel). The compiler knows eight. Each has one fixed frame, so every slide drawn under the same
6
+ treatment puts its title in the same spot to the point. Variety comes from mixing three to five
7
+ treatments across slide jobs, not from nudging titles around: readers learn a few fixed positions
8
+ quickly as long as each position always signals the same kind of page.
9
+
10
+ ## Two rules for every title
11
+
12
+ 1. **A title is a label.** It names the subject, the measure and, where it matters, the period or
13
+ place: "권역별 누수 탐지 건수, 2026년 1-9월", "Pump efficiency by duty point". The claim
14
+ ("탐지 건수가 두 배로 늘었다") goes into the body as its first line or takeaway. Cover subtitles
15
+ follow the same rule. The gate's OF-114 fails a declarative title: a Korean title whose last
16
+ word ends in -다, -니다, -요 forms or a nominalised claim (-음, -함, -됨 outside 포함, 있음/없음); an
17
+ English title with a final period or a finite verb (is, has, will, grew, fell, leads …). A
18
+ trailing parenthesis is read without its contents. A question is allowed but rarely the best
19
+ label.
20
+ 2. **Nothing sits above the title.** No eyebrow, no kicker word, no category tag. A numeral beside
21
+ a title is a real step, part or figure, never decoration, and never larger than the title step.
22
+
23
+ ## How a slide gets its treatment
24
+
25
+ Each family belongs to a role, and each pack maps roles to a default treatment (`role-defaults`):
26
+
27
+ | Role | Families |
28
+ |---|---|
29
+ | content | text-column, text-two-column, summary-box-list, sidebar-note, agenda; closings other than closing-statement |
30
+ | data | kpi-row, kpi-over-chart, dashboard-grid, table-insight, ledger-table, matrix-2x2, comparison |
31
+ | data-takeaway | chart-insight, full-chart, big-number |
32
+ | sequence | process, step-diagram, timeline |
33
+ | image | image-full, image-split, photo-grid, figure-pair, figure-academic, asymmetric-feature |
34
+ | statement | statement, quote |
35
+ | definition | method |
36
+ | reference | references-appendix |
37
+
38
+ The compiler then lays the slide out under every treatment that both the family and the pack
39
+ allow. It keeps the role default when the body fills to the density band; otherwise it takes the
40
+ treatment with the smallest empty band, charging a cost for repeating the previous slide's
41
+ treatment and capping any fill-chosen treatment at about a third of the deck. Variance caps how
42
+ many distinct treatments the deck mixes. The `Treatments:` line of the compile output lists the
43
+ result per slide, and a `note:` names each slide that moved off its role default.
44
+
45
+ A pack may also give one family a title of its own under `structure`: Paper draws a comparison under
46
+ `top-rule` as a ruled table, Chalk draws it on its board rail under `side-rail`. That title comes
47
+ before the role default and stays even when the deck already leans on it, so two tonalities of one
48
+ source differ in structure and not only in colour. When the role default is a bottom title the slide
49
+ may not take (a table), the pack's next treatment in order stands in for it.
50
+
51
+ To pin one slide, add `title:` on the line after `layout:`. The compile stops with the allowed list
52
+ if the pack or the family does not allow that treatment, or if the title cannot fit its budget:
53
+
54
+ ```markdown
55
+ ---
56
+ layout: chart-insight
57
+ title: side-rail
58
+
59
+ ## 권역별 누수 탐지 건수, 2026년 1-9월
60
+ …
61
+ ---
62
+ ```
63
+
64
+ Covers, sections and closings use their own variant's title and reject a `title:` key.
65
+
66
+ ## The eight treatments
67
+
68
+ Positions are given in grid columns (1-12) and points on the 960 × 540 page. The default compact
69
+ grid (density 10) has 24 pt side margins and a 78 pt column pitch; other grids keep the same column
70
+ spans and y values. Budgets are Korean glyphs at the title step (26 pt on the reading and compact
71
+ ramps); Latin text takes roughly twice as many characters.
72
+
73
+ | Treatment | Frame | Drawn with it | Body zone | Budget | Typical job |
74
+ |---|---|---|---|---|---|
75
+ | `top-rule` | columns 1-12, y 36, title step | a one-column accent rule or a full-width hairline about 6 pt below | from about y 92 on the compact step (y 120 elsewhere) to 486 | one line, about 27 | read-closely content and data pages |
76
+ | `top-plain-large` | columns 1-10, y 36, display step | nothing | starts 18-24 pt below the title | two lines of about 16 | a comparison, a picture split, a page opening on one subject |
77
+ | `side-rail` | columns 1-4, y 36, title step, top-aligned with the body | optional rail fill (surface or field) or a hairline at column 4; under the title the rail holds the slide's criteria labels, takeaways and source | columns 5-12, y 36-486 | four lines of about 8 | a chart or table with its reading, a method, definitions |
78
+ | `band` | inside a full-width band 108 pt tall | the band in the field colour, title in on-field | y 120 (compact) or 132 to 486 | one line, about 25 | Korean briefing pages; data pages on a dark deck |
79
+ | `statement` | columns 1-10, centred between y 120 and 486, display step | an optional support line under it | none; the words are the content | three lines of about 16 | a pull quote, or a display-led deck the user asked for |
80
+ | `overlay` | dark panel at the lower left over a full-bleed picture | panel at 88 % opacity, caption on it | none; the picture is the content | two lines of about 15 | full-picture slides |
81
+ | `kicker-numeral` | numeral in columns 1-2, title in columns 3-12 | numeral in the accent colour (a part number, never an agenda's row count), never above title size | y 120-486 | one line, about 23 | real steps, numbered recommendations |
82
+ | `bottom-anchor` | columns 1-9, the title frame's bottom edge on the body floor (y 486), leaving no band under it | optional hairline 12 pt above the title | y 36 to 24 pt above the title, for the visual | two lines of about 20 | chart-, figure- and picture-led slides |
83
+
84
+ A title over budget makes the compiler move the slide to another allowed treatment and write a
85
+ `note:`. A pinned `title:` that cannot hold its title stops the compile instead, because the author
86
+ asked for something impossible; shorten the label or pin a different treatment.
87
+
88
+ ## Which pack carries which
89
+
90
+ Read across a row to see what a pack can do; the bold entry is its default for that role.
91
+
92
+ | Pack | Treatments | content | data | data-takeaway | sequence | image | definition |
93
+ |---|---|---|---|---|---|---|---|
94
+ | Atlas | overlay, bottom-anchor, side-rail, top-plain-large, statement | **side-rail** | **top-plain-large** | **bottom-anchor** | **top-plain-large** | **overlay** | **side-rail** |
95
+ | Chalk | kicker-numeral, top-rule, side-rail, statement | **top-rule** | **top-rule** | **side-rail** | **kicker-numeral** | **side-rail** | **side-rail** |
96
+ | Gazette | band, top-rule, kicker-numeral, side-rail | **band** | **top-rule** | **side-rail** | **kicker-numeral** | **side-rail** | **side-rail** |
97
+ | Ledger | top-rule, side-rail, kicker-numeral, bottom-anchor | **top-rule** | **top-rule** | **side-rail** | **kicker-numeral** | **bottom-anchor** | **side-rail** |
98
+ | Night | top-plain-large, statement, side-rail, kicker-numeral, band | **top-plain-large** | **band** | **side-rail** | **kicker-numeral** | **top-plain-large** | **side-rail** |
99
+ | Paper | top-rule, bottom-anchor, side-rail, statement | **top-rule** | **top-rule** | **bottom-anchor** | **top-rule** | **bottom-anchor** | **side-rail** |
100
+ | Signal | statement, top-plain-large, bottom-anchor, top-rule | **top-plain-large** | **top-rule** | **top-plain-large** | **top-rule** | **bottom-anchor** | **top-rule** |
101
+ | Studio | side-rail, statement, top-plain-large, bottom-anchor, overlay | **side-rail** | **top-plain-large** | **side-rail** | **side-rail** | **bottom-anchor** | **side-rail** |
102
+
103
+ Statements default to `statement` where the pack has it; Ledger maps them to `side-rail` and
104
+ Gazette to `band`, which is why a claim in those packs becomes a labelled page with its evidence.
105
+ Families narrow the choice further: under Ledger `kpi-over-chart` allows only `top-rule`, under
106
+ Night `full-chart` only `top-plain-large`. `--list-layouts <pack>` prints the allowed treatments per
107
+ family.
108
+
109
+ ## Picking with intent
110
+
111
+ - **A chart or table that needs a reading** goes under `side-rail` or `bottom-anchor`. The label sits
112
+ beside or below the visual, and the visual gets the full height of the body.
113
+ - **A claim** never becomes a title. Put it in a `summary-box-list` box over its reasons, in the
114
+ first line beside a table, or as the first takeaway under a chart. Reserve `statement` for a
115
+ quoted sentence or a deck the user wants display-led; a lone sentence on a page under-fills it.
116
+ - **Numbered work** takes `kicker-numeral` only when the number exists in the content: the third
117
+ step of a procedure, recommendation 2 of 4, part 03 of the agenda. A numeral on an unordered list
118
+ is a defect the critique counts.
119
+ - **Korean desk-read pages** take `band`; the strong repeated head tells the reader where each page
120
+ begins, and the body below can run at the compact step to the floor.
121
+ - **Pictures** take `overlay` only when the picture fills the page, and `bottom-anchor` when a large
122
+ picture sits above its label.
123
+
124
+ Never move a title by hand with a free text box. The frame is the treatment; a nudged title becomes
125
+ a ninth position the reader has to learn and the gate cannot classify.
126
+
127
+ ## How the gate reads titles
128
+
129
+ `qa_deck.py` classifies each title from the compiled file by geometry and companions, testing in
130
+ this order: overlay, band, statement, bottom-anchor, side-rail, kicker-numeral, top-plain-large,
131
+ top-rule. The compiler also writes the intended treatment into the title shape's name
132
+ (`title@side-rail`), and the gate compares the two; the name alone is never accepted as evidence.
133
+
134
+ | Check | Fails when |
135
+ |---|---|
136
+ | OF-110 | a deck of eight or more slides uses fewer than three treatments (cover and section titles not counted) or more than variance allows; or, at any length, a title fits none of the eight or is drawn as a different treatment than its name says |
137
+ | OF-113 | two slides under the same treatment place their title frames more than 1 pt apart (statements compare only x and width, since their height follows the line count; bottom titles compare x, width and the bottom edge, since they stand on the floor) |
138
+ | OF-114 | a title or cover subtitle is declarative (rule 1 above) |
139
+ | OF-115 | a bottom title ends more than 12 pt above the body floor, or more than 40 % of a side rail under its title stands empty |
140
+
141
+ What stands in the rail under a side title is the rail's own: it neither changes the side-rail reading
142
+ nor counts as a body column. A slide whose rail would stay empty takes another title unless the
143
+ source pins `title: side-rail`, and then OF-115 reports the empty rail.
144
+
145
+ Under a legacy template OF-110 and OF-113 report as advisories and OF-114 as MEDIUM, because the
146
+ user asked for that template's single title position.
@@ -0,0 +1,113 @@
1
+ # Atlas
2
+
3
+ Atlas is a field book: photographs carry the evidence and short captions say what, where, when and
4
+ how much. A photograph either runs off the page edge or fills most of the body, and its label
5
+ sits on a dark panel laid over it or underneath it. The palette stays out of the way, near-black ink and one muted navy, because
6
+ the photographs supply the colour. Every picture has a numbered caption and a source, which keeps
7
+ the deck honest about what the reader is looking at.
8
+
9
+ ## Reach for it
10
+
11
+ - Field and site reports, construction or restoration progress, product reports, exhibitions,
12
+ portfolios: any deck whose proof is something to see.
13
+ - Outlines where a third or more of the slides hold a photo, render or screenshot.
14
+ - Audiences who judge by looking: clients, review panels, residents at a briefing.
15
+ - First candidate for image-led decks; third for a pitch when the product is physical.
16
+
17
+ ## Pass on it
18
+
19
+ - Sources with no real pictures. Atlas without images is a set of grey boxes; pick Ledger, Gazette
20
+ or Signal.
21
+ - Table-heavy work: Atlas has no table family at all. Put the numbers in `kpi-row` or `timeline`,
22
+ or choose another pack.
23
+ - Long argument in prose: the text families here are narrow by design.
24
+
25
+ ## Tokens
26
+
27
+ | Token | Value |
28
+ |---|---|
29
+ | ground / surface | #FFFFFF / #F3F4F5 |
30
+ | ink / ink-muted / line | #1A1D21 / #555B63 / #D6D9DD |
31
+ | accent / accent-deep / accent-tint | #2B4C7E / #1B2F4E / #E6ECF4 |
32
+ | field / on-field | #1A1D21 / #FFFFFF |
33
+ | positive / negative | #1E7A3F / #B3261E |
34
+ | series | #2B4C7E, #555B63, #8A6A2E, #3E7A5A |
35
+ | faces | Pretendard Bold titles; Pretendard Regular body, labels, display and numerals (a lighter voice than the other packs); `faces: a2z` swaps display and numerals to A2Z Light |
36
+ | type voice | tracking 0 titles, −1 display; proportional figures |
37
+ | table | `light-grid`: no header fill, bold ink header, hairline rows, no banding, numbers right-aligned |
38
+ | chart | hairline gridlines, direct labels, accent on the item that matters, no annotation |
39
+ | image | bleed and crop allowed, no frame |
40
+ | decoration | caption band, hairline rule, colour field |
41
+ | radius / edge | 0 / fill |
42
+
43
+ ## Dials and type
44
+
45
+ Density 10, variance 7 (four or five treatments, no family more than twice in a row). The fill order
46
+ starts with `anchor-visual`: a picture or chart takes the room before type or gaps change.
47
+
48
+ ## Titles by role
49
+
50
+ | Role | Default |
51
+ |---|---|
52
+ | image | `overlay` (dark panel over a full-bleed photo) |
53
+ | data-takeaway | `bottom-anchor` |
54
+ | data, sequence | `top-plain-large` |
55
+ | content, reference, definition | `side-rail` |
56
+ | statement | `statement` on the whole-page field |
57
+
58
+ ## Families and variants
59
+
60
+ - `image-full`: one photograph as the page, label and caption on the panel.
61
+ - `image-split`: a photograph beside four to six labelled facts (요약, 유속, 수심 …).
62
+ - `figure-pair`: before and after from the same viewpoint, one line of reading under them.
63
+ - `photo-grid`: two or three photos compared, one line of text; never more than three in a row.
64
+ - `asymmetric-feature`: one large picture with a narrow column of facts.
65
+ - `kpi-row`, `timeline`, `comparison`, `text-column`: the numbers, dates and words a picture deck
66
+ still needs.
67
+ - `statement`: the one pull quote a picture deck may need, on the whole-page field.
68
+ - Covers `cover-full-image` (the deck's first picture), `cover-split-image`, `cover-typographic`;
69
+ sections `section-image`, `section-field`; closings `closing-contact-split`, `closing-ask`.
70
+
71
+ Display devices: cover `plate` (a dark panel as tall as the title and its meta line, standing on the
72
+ page foot), statement `drench` (the whole page in the field colour), number panel `tint`, closing floor
73
+ `band`. The `section-image` panel stands on the foot too, as tall as the part number and title. The
74
+ cover and `section-image` crop pictures to their box with the picture's own proportions.
75
+
76
+ ## Do
77
+
78
+ - Number captions and give each a source: `도 3. 공사 전 콘크리트 호안, 2025년 2월 | 출처: …`.
79
+ - Shoot or choose before/after pairs from the same position and focal length.
80
+ - Give every picture slide facts with units (m/s, ha, 마리) rather than adjectives.
81
+ - Keep text off photographs except on the overlay panel.
82
+
83
+ ## Avoid
84
+
85
+ - Text set straight onto a photo.
86
+ - Pictures inside card frames, or more than three pictures in one row.
87
+ - Grey placeholder boxes in a delivered deck.
88
+ - Stretched pictures; supply images at the right proportion or let the box crop them.
89
+
90
+ ## Worked slide
91
+
92
+ A picture with the facts a reviewer checks, source directly under the image line.
93
+
94
+ ```markdown
95
+ ---
96
+ layout: image-split
97
+
98
+ ## 여울 조성 구간의 유속과 어류 출현
99
+
100
+ ![도 2. 돌을 쌓아 만든 3번 여울, 갈수기 | 출처: 예시 이미지](assets/example-b.png)
101
+
102
+ 출처: 하천관리과 어류·유속 조사, 2026년 9월 (예시)
103
+
104
+ - **요약** 여울 6곳 모두에서 물살이 빨라지고 여울성 어류가 돌아왔다
105
+ - **유속** 여울 위 평균 0.6m/s, 조성 전 평탄 구간 0.15m/s
106
+ - **수심** 여울 10-30cm, 여울 아래 소 80cm 안팎으로 깊이가 다양해졌다
107
+ - **어류** 피라미·돌고기·참갈겨니 3종이 여울에서만 잡혔다
108
+ ---
109
+ ```
110
+
111
+ ## Examples
112
+
113
+ `08-field-report-atlas-ko.md`
@@ -0,0 +1,115 @@
1
+ # Chalk
2
+
3
+ Chalk is a teacher's board after a careful clean-up. Steps are numbered because they happen in
4
+ order, one concept per slide is the thing being taught, and a fenced note holds the definition or
5
+ the mistake students make. Surfaces have a small 6 pt radius, the ground is a very pale grey, the
6
+ rail and statement field are a deep green, and a warm rust accent marks the concept. It reads well
7
+ in the room and still works when students reopen the file a week later.
8
+
9
+ ## Reach for it
10
+
11
+ - Lectures, training sessions, onboarding, technical tutorials, worked examples.
12
+ - Outlines with definitions, a formula, or a how-it-works sequence of three steps or more.
13
+ - First candidate for lectures; third for a tutorial-style research talk.
14
+
15
+ ## Pass on it
16
+
17
+ - Decision decks: the step rhythm reads as padding to an executive. Ledger or Signal.
18
+ - Chart-led material: Chalk has no chart family; data appears as `table-insight` or inside a
19
+ worked example.
20
+ - Image-led decks: pictures sit beside text, never full-bleed.
21
+
22
+ ## Tokens
23
+
24
+ | Token | Value |
25
+ |---|---|
26
+ | ground / surface | #FAFBFC / #EEF2F5 |
27
+ | ink / ink-muted / line | #1F2933 / #4E5A66 / #CBD3DA |
28
+ | accent / accent-deep / accent-tint | #9A3412 / #6B2409 / #FCEBE0 |
29
+ | field / on-field | #1F3B33 / #FFFFFF |
30
+ | positive / negative | #1E7A3F / #B3261E |
31
+ | series | #9A3412, #1F3B33, #4E5A66, #2E6A8E |
32
+ | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` gives A2Z Bold display and titles, A2Z Black numerals |
33
+ | type voice | tracking −1; proportional figures |
34
+ | table | `header-fill`: accent-tint header with accent-deep text, row rules, bold totals |
35
+ | chart | hairline gridlines, direct labels, accent on the highlighted series, annotation on |
36
+ | image | bleed at the sides only, no crop, no frame |
37
+ | decoration | accent rule, mark underline (listed, not drawn yet), rail fill in the field colour, numeral |
38
+ | radius / edge | 6 / fill |
39
+
40
+ ## Dials and type
41
+
42
+ Density 10, variance 6. Fill order starts with `distribute`, so short teaching pages open their
43
+ gaps before anything else; on the compact step nothing is enlarged.
44
+
45
+ ## Titles by role
46
+
47
+ | Role | Default |
48
+ |---|---|
49
+ | content, data, reference | `top-rule` |
50
+ | sequence | `kicker-numeral` |
51
+ | data-takeaway, image, definition | `side-rail` |
52
+ | statement | `statement` (drench) |
53
+
54
+ `step-diagram` takes only `top-rule`; `sidebar-note` may take `kicker-numeral`, an agenda never (its rows
55
+ carry the numbers). Since the agenda carries no numeral (OF-119), a chalk deck that relied on it for its
56
+ only kicker needs a step or sidebar slide under `kicker-numeral` to keep three title treatments (OF-110),
57
+ and a sidebar note set across the top is one more top-title slide in a grid, which can carry the top/grid
58
+ share past 40 % of the content slides (OF-111). A comparison sets its criteria on the board rail under a `side-rail` title (the pack's
59
+ `structure`).
60
+
61
+ ## Families and variants
62
+
63
+ - `step-diagram` and `process`: steps taught in order, each with an example and a check.
64
+ - `method`: a formula across the top, its terms in two columns under it.
65
+ - `sidebar-note`: groups of the main point plus a `::: main-box` note for the definition or the
66
+ common mistake.
67
+ - `table-insight`: a worked table with the reading beside it.
68
+ - `image-split`: a worked example beside its figure.
69
+ - `comparison`: two concepts students confuse, on the same criteria.
70
+ - `agenda`, `text-column`, `quote`, `statement`.
71
+ - Covers `cover-rail`, `cover-typographic`, `cover-numeral`; sections `section-numeral`,
72
+ `section-rail`; closings `closing-summary-list`, `closing-ask`.
73
+
74
+ Display devices: cover `rail`, statement `drench` (the whole slide in the field), number panel
75
+ `tint`, closing floor `box`.
76
+
77
+ ## Do
78
+
79
+ - Number only what is ordered: steps, parts, the exercise sequence.
80
+ - Give each step an example with numbers and a check the student can run.
81
+ - Put the definition or the common mistake in the sidebar, not in the bullets.
82
+ - End on the summary with the exercise, its deadline, its format and the next session.
83
+
84
+ ## Avoid
85
+
86
+ - More than one marked concept per slide.
87
+ - Numerals on points that have no order.
88
+ - Definitions buried in a bullet list.
89
+ - A section numeral with no agenda behind it ("1" on a page encodes nothing).
90
+
91
+ ## Worked slide
92
+
93
+ A method slide: the formula reads across the top, the terms fill two columns beneath it.
94
+
95
+ ```markdown
96
+ ---
97
+ layout: method
98
+
99
+ ## Duty point and system curve
100
+
101
+ H_sys = H_static + k · Q²
102
+
103
+ - **H_sys** head the system needs at flow Q, in metres of liquid
104
+ - **H_static** height difference between suction and delivery levels, 12 m in the example
105
+ - **k** friction coefficient of the pipework, from pipe length, diameter and fittings
106
+ - **Q** flow rate in m³/h; friction head grows with its square
107
+ - **Duty point** where the pump curve crosses the system curve
108
+ - **BEP** best efficiency point, the flow at which the pump wastes least energy
109
+ - Source: Example Plant Engineering Academy course notes, module 2, 2026
110
+ ---
111
+ ```
112
+
113
+ ## Examples
114
+
115
+ `06-lecture-chalk-ko.md`, `12-tutorial-chalk-en.md`