@litfamily/litcodex 1.0.15 → 1.0.17
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.
- package/README-Ko-KR.md +10 -10
- package/README.md +10 -10
- package/dist/install/codex.d.ts +1 -9
- package/dist/install/codex.js +7 -1
- package/dist/install/generated-skill-payload-hashes.d.ts +101 -40
- package/dist/install/generated-skill-payload-hashes.js +101 -40
- package/dist/install/index.js +1 -0
- package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
- package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
- package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
- package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
- package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
- package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
- package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
- package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
- package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
- package/marketplace/plugins/litcodex/skills/frontend-ui-ux/THIRD-PARTY-NOTICE.txt +0 -2
- package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +16 -12
- package/marketplace/plugins/litcodex/skills/lit-docx/references/components.md +113 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +164 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +95 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/02-brief-ko.md +45 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/03-manual-ko.md +105 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/04-proposal-ko.md +97 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/05-memo-en.md +34 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/06-journal-en.md +89 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/07-report-en.md +101 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/08-proposal-en.md +94 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/09-memo-ko.md +34 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/page-composition.md +141 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/brief.md +70 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/journal.md +73 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/manual.md +70 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/memo.md +75 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/proposal.md +71 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/report.md +83 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/scripts/convert_md_to_docx.py +401 -58
- package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_craft.py +124 -1
- package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +2446 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_layout.py +960 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/scripts/slop_lint.py +21 -6
- package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +26 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +27 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +27 -0
- package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +27 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +12 -11
- package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Bold.otf +0 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Regular.otf +0 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +33 -29
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +11 -2
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +179 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/design-system-azure.md +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +203 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +185 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/02-pitch-studio-en.md +162 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +229 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +212 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/05-research-keynote-night-ko.md +191 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +175 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/07-data-review-night-en.md +241 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/08-field-report-atlas-ko.md +168 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +219 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/10-status-update-ledger-en.md +157 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/11-portfolio-studio-ko.md +183 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/12-tutorial-chalk-en.md +176 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/13-status-update-gazette-ko.md +157 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/interview-protocol.md +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +210 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +146 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +113 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +115 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +118 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +129 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +126 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +109 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +121 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +111 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +65 -17
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +654 -11
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/inventory.py +32 -2
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/directive-parser.js +2 -2
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +401 -16
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-html.js +2 -2
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +498 -145
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +3558 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-ast.js +54 -6
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +335 -11
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +99 -19
- package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +6 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/boilerplate_professional.css +6 -6
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +105 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +110 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +105 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +106 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +106 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +111 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +107 -0
- package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +105 -0
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/fonts.mjs +6 -6
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gate.mjs +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +2 -2
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +1 -1
- package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/type-and-timing.md +3 -3
- package/node_modules/@litcodex/lit-loop/package.json +1 -1
- package/package.json +2 -2
- package/readme-assets/badge-version.svg +1 -1
- package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Bold.otf +0 -0
- 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
|
+

|
|
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`
|