ljg-present:演讲铸造器
让观众一眼找到这一页的主角,让讲者有足够的提示继续展开。Unix 气质来自精确的关系、自然的文字、清楚的主次和有意保留的空白。
Workflow Routing
| 工作 | 入口 |
|---|---|
| 生成、重排或改进演示 | Workflows/Generate.md |
Gotchas
- share、talk 等用途标签不决定颜色。未指定视觉主题时使用 hacker-dark。
- 两行可以是一个判断。role 由讲述功能决定;行数只参与字号与分页。
- 标题、主体、提示句不是必填三件套。主句已经完成表达时,让它独立站住。
- Unicode 连接线使用等宽网格,中文节点独立排版。不要把中文逐字塞进固定字符格。
- 静态通过不等于画面成立。构建工具固定模板;浏览器探针核对实际绘制的页面,截图另检视觉主次。
两种内容契约
| 模式 | 何时使用 | 保真对象 |
|---|---|---|
| faithful 保真排版 | 已有投影提纲;未授权改写 | 原文字句、顺序、表格、代码和源图 |
| editorial 演讲编排 | 用户已要求提炼讲稿、重组展示或重绘图 | 观点、证据、限定条件、数值和关系;上屏文字可在授权范围内改写 |
当前请求已授权的提炼或重绘直接执行,不重复询问。演讲编排记录 editingBasis,上屏内容以 sourceIds 回到完整来源;完整讲述放入 notes,按 N 查看。仅有「做成演示」不自动授权删改作者内容。
设计与实现
- 先读 DesignSystem.md,按相关版式查看 CompositionReference.md 的实际样张。
- 数据契约见 RenderingSpec.md;关系图、原生图表与源代码的边界见 ChartSpec.md。
- 使用 Tools/BuildDeck.ts 把数据装入 SloganTemplate.html;不在产物末尾补 CSS,不另写渲染分支。
- 保留源中的章节转折与停顿。内容节点数、页数和图数都不是质量目标。
- 核心观点、重要限制和数据按投影距离保持可读;辅助信息退后或进入讲稿,不能缩小核心信息来制造留白。
主题
显式选择 > 明确的 theme_* 视觉标签 > hacker-dark。普通话题、用途标签不参与主题选择。
| 意图或参数 | theme |
|---|---|
| 默认、Unix、terminal、暗色 | hacker-dark |
| 浅色 Hacker、--hacker、兼容 --cyber | hacker |
| -b / --theme=black | black |
| -r / --theme=red | red |
| -y / --theme=yellow | yellow |
交付
一个 ~/Downloads/{title}.html,字体内嵌,图表内联,离线、零动效。→ ↓ Space Enter j PageDown 前进;← ↑ k PageUp 后退;Home/End 首末页;F 全屏;N 讲稿。滚动图形和讲稿时不触发翻页。
静态验证检查当前模板与源数据;使用 Interceptor 隔离浏览器加载 Tools/ProbeDeck.js,再看整套缩略图与代表页。隔离浏览器不可用时保留产物并如实报告未完成视觉复验,不改用主浏览器冒充验收。
Examples
- 「按原提纲做演示,别改字」→ faithful,根据语义选版式,必要时沿源边界续页。
- 「把讲述精髓放进展示,供我现场展开」→ editorial,提炼主张、对照或关系,完整讲稿进入 notes。
- 「把旧 ASCII 图改成 Unicode」→ 记录重绘授权,以节点、连接和方向核对新图;真实代码仍逐字符保留。

