ljg-present

1# ljg-present：演讲铸造器
2 
3让观众一眼找到这一页的主角，让讲者有足够的提示继续展开。Unix 气质来自精确的关系、自然的文字、清楚的主次和有意保留的空白。
4 
5## Workflow Routing
6 
7| 工作 | 入口 |
8|---|---|
9| 生成、重排或改进演示 | [Workflows/Generate.md](Workflows/Generate.md) |
10 
11## Gotchas
12 
13- share、talk 等用途标签不决定颜色。未指定视觉主题时使用 hacker-dark。
14- 两行可以是一个判断。role 由讲述功能决定；行数只参与字号与分页。
15- 标题、主体、提示句不是必填三件套。主句已经完成表达时，让它独立站住。
16- Unicode 连接线使用等宽网格，中文节点独立排版。不要把中文逐字塞进固定字符格。
17- 静态通过不等于画面成立。构建工具固定模板；浏览器探针核对实际绘制的页面，截图另检视觉主次。
18 
19## 两种内容契约
20 
21| 模式 | 何时使用 | 保真对象 |
22|---|---|---|
23| faithful 保真排版 | 已有投影提纲；未授权改写 | 原文字句、顺序、表格、代码和源图 |
24| editorial 演讲编排 | 用户已要求提炼讲稿、重组展示或重绘图 | 观点、证据、限定条件、数值和关系；上屏文字可在授权范围内改写 |
25 
26当前请求已授权的提炼或重绘直接执行，不重复询问。演讲编排记录 editingBasis，上屏内容以 sourceIds 回到完整来源；完整讲述放入 notes，按 N 查看。仅有「做成演示」不自动授权删改作者内容。
27 
28## 设计与实现
29 
30- 先读 [DesignSystem.md](DesignSystem.md)，按相关版式查看 [CompositionReference.md](CompositionReference.md) 的实际样张。
31- 数据契约见 [RenderingSpec.md](RenderingSpec.md)；关系图、原生图表与源代码的边界见 [ChartSpec.md](ChartSpec.md)。
32- 使用 Tools/BuildDeck.ts 把数据装入 SloganTemplate.html；不在产物末尾补 CSS，不另写渲染分支。
33- 保留源中的章节转折与停顿。内容节点数、页数和图数都不是质量目标。
34- 核心观点、重要限制和数据按投影距离保持可读；辅助信息退后或进入讲稿，不能缩小核心信息来制造留白。
35 
36## 主题
37 
38显式选择 > 明确的 theme_* 视觉标签 > hacker-dark。普通话题、用途标签不参与主题选择。
39 
40| 意图或参数 | theme |
41|---|---|
42| 默认、Unix、terminal、暗色 | hacker-dark |
43| 浅色 Hacker、--hacker、兼容 --cyber | hacker |
44| -b / --theme=black | black |
45| -r / --theme=red | red |
46| -y / --theme=yellow | yellow |
47 
48## 交付
49 
50一个 ~/Downloads/{title}.html，字体内嵌，图表内联，离线、零动效。→ ↓ Space Enter j PageDown 前进；← ↑ k PageUp 后退；Home/End 首末页；F 全屏；N 讲稿。滚动图形和讲稿时不触发翻页。
51…