25 lines
2.5 KiB
Markdown
25 lines
2.5 KiB
Markdown
# 演示文稿协作约定
|
|
|
|
- 本仓库用于“知识库与腾讯 ima 教育应用”培训，参考项目为 `speech/Ai_education`。
|
|
- 当前大纲为 `docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md`。后续修改PPT或网页课程内容，必须在同一次任务中同步维护大纲，检查目标、页序、页数、时长、案例、练习与成果要求。
|
|
- 修订大纲保留文件名及 `created_at`，递增 `revision`，追加 `revisions`；仅视觉调整无需虚增大纲版本。
|
|
|
|
## 网页维护
|
|
|
|
- 网页页面源码为 `src/slides/*.html`，每个文件对应一页，含正文、`data-title`、`data-chapter`、`data-note` 和页内样式。
|
|
- 修改前读取 `src/deck.json`，按稳定页面 ID 定位文件，文件名不使用页码。增删及排序由该清单控制。
|
|
- 页内样式选择器以 `:scope` 开头，公共媒体查询与动画放在 `src/styles/theme.css`。公共容器和播放器分别为 `src/shell.html`、`src/runtime/player.js`。
|
|
- 页内脚本由构建器包裹，可使用 `root` 查询本页。不得查询其他页面或在全局保存页内状态。计时器由公共播放器统一维护。
|
|
- 图片放在 `assets/`，页面通过 `src="asset:文件名.png"` 引用；不在页面源码粘贴 Base64。`materials/` 为练习资料，构建时自动内嵌。
|
|
- 不手写页码、总页数、section ID、active 或可见状态。页脚用 `{{PAGE_NUMBER}}` 与 `{{PAGE_COUNT}}`。
|
|
- `python3 scripts/build_web.py --check` 检查；`python3 scripts/build_web.py` 生成根目录 `index.html` 与 `outputs/培训练习材料.zip`。根目录 `index.html` 和 `outputs/` 均为生成结果，禁止直接编辑。
|
|
- `work/` 仅放验证记录或临时工作，不运行历史修补脚本。
|
|
|
|
## PPT与内容一致性
|
|
|
|
- 已提交PPT首版保存在 `outputs/知识库与腾讯ima教育应用培训-v1.pptx`，其旧制作源码为 `scripts/build.mjs`，标题索引为 `src/pptx-deck.json`。不得用PPT构建覆盖网页清单 `src/deck.json`。
|
|
- 当前30页网页对应PPT首版，后续修改课程内容时同步维护网页、大纲及后续发布的PPT版本。历史PPT保留原样，未重新生成的旧版不能声称已同步。
|
|
- 模拟教学与校务资料必须保留模拟标识，不得描述为真实课标、学校制度或产品实测结果。
|
|
- 官方截图为未登录首页，登录后的导入、来源点击、笔记及共享操作仍需授课账号验证。
|
|
- 保留不属于当前任务的改动。默认不提交、不推送。
|