用途:pptx-author 是 PPTX-from-layouts 三步流程中的第 2 步(编写),负责把内容写成 markdown 幻灯片,并让每页明确指向模板中的真实版式。它连接第 1 步 pptx-profile(了解模板版式)与第 3 步 pptx-from-layouts(渲染成 deck.pptx)。
主要能力:幻灯片以 --- 分隔,每页以标题开头,可带提示。标题用 # Slide N: Title 或 ## Title,建议写成主张而非标签。用 [HINT: layout_name] 指定版式,值需从第 1 步生成的 layout-catalog.md 的 Hint 列原样复制,引擎会填充该版式的实际占位符。内容需与版式匹配:column-* / grid-* 版式用 [Column N: Header] 块或 Header 正文行;含图版式用 [Image: path/to.jpg];表格数据用 markdown 表格;其余情况才用 - 项目符号。若没有目录或不确定版式,可用 Visual: type(如 process-4-phase)让引擎按语义自动选版式;两者同时存在时 [HINT:] 优先,不匹配的提示会被忽略并回退到自动检测。
使用方式:先运行 lint 校验,例如 python scripts/lint_hints.py slides.md --config your-template-config.json,或 --catalog your-template-layout-catalog.md,无参数时校验内置 Inner Chapter 模板。linter 会标记 P0 未知提示(含“did you mean…?”建议,会导致错误渲染)、P1 缺少标题、P2 项目符号与表格混用;退出码 2 表示需修复后重跑。之后把 slides.md 连同模板与配置交给第 3 步:python ../pptx-from-layouts/scripts/generate.py slides.md -o deck.pptx --template your-template.pptx --config your-template-config.json --validate。
适用场景:已有模板并希望每页精确落到指定版式的演示文稿编写。限制:需要第 1 步的版式目录或内置模板;提示名必须与目录一致,否则回退自动检测;资料未提供收费、价格与平台信息。