Files
02-ima/README.md
T

60 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 让教学资料用起来
知识库与腾讯 ima 教育应用培训。面向教师、教研组长和学校管理人员,120分钟、30页。
## 课程文件
- [离线网页演示](index.html)
- [PowerPoint 演示文稿](outputs/知识库与腾讯ima教育应用培训-v1.pptx)
- [课程大纲](docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md)
- [现场练习单](materials/05_现场练习单.md)
- [模拟资料包](materials/)
- [逐页标题索引](src/deck.json)
演示文稿采用16:9画幅,深绿、薄荷绿与白色配色,文字、图形和表格可编辑,逐页附有讲师备注。使用 PingFang SC 字体,其他电脑若无此字体,可在 PowerPoint 中替换为可用的中文字体并复查排版。
## 维护方式
网页页面源码位于 `src/slides/*.html`,每页一个文件;`src/deck.json` 维护稳定页面ID及播放顺序。修改后运行 `python3 scripts/build_web.py --check`,再运行 `python3 scripts/build_web.py`。双击 `index.html` 即可离线播放,发送这个单文件即可分享。
PPT首版源码位于 `scripts/build.mjs`,其标题索引生成至 `src/pptx-deck.json`。改动PPT内容时同步更新大纲及版本记录,具体见 [AGENTS.md](AGENTS.md)。网页入口生成在项目根目录 `index.html`;PPT、ZIP练习包及预览图保留在 `outputs/`。生成结果不要直接修改,应修改源码后重新构建。
本机重建使用已安装的官方演示文稿运行库。使用该运行库 Node 执行 `scripts/build.mjs`,参数1为仓库绝对路径,参数2为新的输出文件名,例如 `知识库与腾讯ima教育应用培训-v2.pptx`。构建会生成逐页预览、检查文件并导出新版本,保留旧版本。运行库位置见源码开头,换电脑需要调整。
## 演示边界与授课准备
- 官方界面截图取自 https://ima.qq.com/ 的未登录首页,日期2026-11-03。
- 模拟教学资料和模拟校务制度均已明确标注,不能作为课标、教材或学校正式规定。
- 预览与文件检查已完成,尚未在 PowerPoint 原生程序中检查。
- 授课前需用实际账号验证登录、Markdown资料导入、原文来源、笔记和共享入口,确认账号可用额度与现场网络。
- 产品参考:https://ima.tencent.com/download 。参考课程:http://gitea.werich.top/speech/Ai_education 。
默认不提交、不推送。
## 网页播放
- 方向键或空格翻页,Home / End 到首尾页。
- M:搜索目录,N:当前页讲师备注,F:全屏,R:阅读模式。
- 手机可左右滑动,阅读模式适合在小屏上查看全文。截图可点击放大。
- 第14、27页可复制提问模板;第26页有12分钟计时器,切页后继续;第28页可勾选完成清单。
- “资料”提供五份Markdown材料及ZIP整包下载,全部内嵌在网页内。
- 备注会显示在当前投影上,按需打开。刷新页面后练习计时和清单重置。
- 生成文件无网络依赖,访问官网或使用ima需要联网。网页不调用AI、不上传资料。
此版仅生成本地网页,尚未发布到公网,也未自动提交或推送。
## 文件组织
```text
index.html # 网页入口,构建生成,可单独离线分享
src/ # 网页页面、播放器、样式与顺序清单
scripts/ # 网页与PPT构建脚本
assets/ # 图片素材
materials/ # 练习资料源码
docs/ # 课程大纲
outputs/ # PPT、ZIP练习包及预览图
work/ # 验证记录
```
在仓库根目录运行 `python3 scripts/build_web.py` 会重新生成根目录 `index.html`,并更新 `outputs/培训练习材料.zip`。`--output` 可指定其他HTML输出位置,ZIP练习包始终保存在 `outputs/`。