section-operations

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