html-ppt-course-module

HTML PPT · 课程模块

进入主技能 html-ppt 的专用入口，可直接使用 course-module 全套演示文稿模板。

选择此卡片的情况

Examples 画廊会将“使用此提示词”关联到上方的 example_prompt。接受该提示词后，如果用户需要完全采用 course-module 的视觉风格，则应选择此卡片（截图和设计说明请参阅上游全套演示文稿目录）。

如何编写演示文稿

1. 先阅读主技能。 所有编写规则都在 design-templates/html-ppt/SKILL.md 中，包括内容/受众检查清单、 设计令牌规则、布局复用、演讲者模式、键盘运行时，以及 “切勿在幻灯片上放置仅供演讲者查看的文本”规则。
2. 从匹配的模板文件夹开始： design-templates/html-ppt/templates/full-decks/course-module/ —— 将 index.html 和 style.css 复制到项目中，并保留 .tpl-course-module body 类。
3. 将共享运行时与模板一并引入。 上游的 index.html 通过 ../../../assets/... 引用共享 CSS/JS，因为它位于 design-templates/html-ppt/templates/full-decks/ 下三层目录中。 将 index.html 复制到项目后，这些相对上级目录的 URL 将无法解析，base.css、animations.css 和 runtime.js 会返回 404，导致演示文稿无法启动，幻灯片导航也会失效。每个项目可选择以下两种方案之一：
   • 方案 A — 复制并改写（推荐）： 将 design-templates/html-ppt/assets/fonts.css、design-templates/html-ppt/assets/base.css、 design-templates/html-ppt/assets/animations/animations.css 和 design-templates/html-ppt/assets/runtime.js 复制到项目本地的 assets/ 目录（其中包含 assets/animations/animations.css），然后将 index.html 中的四个 <link>/<script> 标签从 ../../../assets/... 改为对应的项目本地路径 （assets/fonts.css、assets/base.css、 assets/animations/animations.css、assets/runtime.js）。
   • 方案 B — 内嵌： 读取同样的四个文件，将每个 <link rel="stylesheet" href="../../../assets/..."> 替换为包含文件内容的 <style>...</style>，并将 <script src="../../../assets/runtime.js"> 替换为包含 runtime.js 内容的 <script>...</script>。这样会生成一个独立的 index.html。 无论采用哪种方案，都不要将上游的 ../../../assets/... URL 原样放入项目产物中——它们只在仓库目录树内有效。
4. 选择主题。 默认设计令牌效果不错；如果用户想要不同的风格，可通过 <link id="theme-link"> 引入 design-templates/html-ppt/assets/themes/*.css 中的任一主题（共 36 种），并让 T 键循环切换。
5. 替换演示内容，而非类名。 .tpl-course-module 作用域内的 CSS 只会识别模板中提供的结构类——请保留这些类。
6. 演讲者备注应放在 <aside class="notes"> 或 <div class="notes"> 内——绝不能将其作为可见文本放在幻灯片上。

致谢

视觉系统、布局、主题和运行时键盘模型来自上游采用 MIT 许可证的 lewislulu/html-ppt-skill。LICENSE 文件位于 design-templates/html-ppt/LICENSE；重新分发时请保留该文件。