kangwang42 实用操作教程
开工
- 先执行
tutorial-authoring并读取 content-structure.md。 - 确定读者的操作系统、工具版本、输入文件、目标产物和验证方式。只有平台差异会改变步骤时才拆分说明。
- 用实际
--help、版本命令和官方文档核对命令；稳定、实验和已弃用功能分开写。 - 数据清洗主题另读 data-cleaning-workflow.md，保持原始输入只读。
- 按 共同辨析合同 检查相邻命令、工具表面、平台和输出格式。选择不同路径会改变权限、产物或验证方式时，在步骤前先给选择入口。
写作与示例
围绕“任务 → 前置条件 → 路径选择 → 最小步骤 → 预期结果 → 验证 → 常见失败”组织。命令块必须可复制，但路径、引号、shell 和工作目录需与平台一致。解释关键参数改变什么，不逐字翻译每个选项。
安装命令与日常使用分开；不要求用户在教程构建时升级运行时或全局环境。外部字体、TeX、Java、系统库和编译器等依赖要说明核验命令和失败影响。
图件
按 visual-templates.md 选择真实终端、文档、页面或文件树截图。界面和编译结果必须实际运行得到；概念流程只有在文字和真实截图无法表达关系时使用。
验证与导航
- 从干净工作目录按文中顺序执行关键命令，检查输出文件、退出码和完整日志。
- Typst/Quarto 等教程至少编译一个最小文件，并检查最终 PNG/PDF/HTML，不只检查源码。
- 运行项目教程审计与目标文章渲染，扫描 warning/error。
- 更新
_quarto.yml后从doc/运行Rscript generate_sections.R，再定向渲染sections/operation.qmd和index.qmd。