html-ppt-presenter-mode

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HTML PPT · Presenter Mode (演讲者模式)

A focused entry point into the

html-ppt

master skill that lands the user directly on the presenter-mode-reveal
full-deck template.

这是

html-ppt

主技能的专属入口，可直接将用户引导至**

presenter-mode-reveal

**完整演示文稿模板。

When this card is picked

选择此卡片的场景

The Examples gallery wires "Use this prompt" to the example_prompt above. When you accept that prompt, this card is the right pick if the user wants exactly the visual identity of

presenter-mode-reveal

(see the upstream full-decks catalog for screenshots and rationale).

示例库将“使用此提示”关联到上述示例提示。当用户接受该提示后，如果他们希望完全采用

presenter-mode-reveal

的视觉风格，那么选择此卡片就对了（可查看上游的完整演示文稿目录获取截图和设计说明）。

How to author the deck

如何制作演示文稿

Read the master skill first. All authoring rules live in
```
skills/html-ppt/SKILL.md
```
— content/audience checklist, token rules, layout reuse, presenter mode, the keyboard runtime, and the "never put presenter-only text on the slide" rule.

Start from the matching template folder:

skills/html-ppt/templates/full-decks/presenter-mode-reveal/

— copy

index.html

and

style.css

into the project, keep the

.tpl-presenter-mode-reveal

body class.

Bring the shared runtime with the template. The upstream
```
index.html
```
links the shared CSS/JS via
```
../../../assets/...
```
because it sits three folders deep inside
```
skills/html-ppt/templates/full-decks/
```
. Once you copy
```
index.html
```
into the project, those parent-relative URLs no longer resolve and
```
base.css
```
,
```
animations.css
```
, and
```
runtime.js
```
will 404 — meaning the deck never activates and slide navigation is dead. Pick one of these two recipes per project:
- Recipe A — copy + rewrite (preferred): copy
```
skills/html-ppt/assets/fonts.css
```
  ,
```
skills/html-ppt/assets/base.css
```
  ,
```
skills/html-ppt/assets/animations/animations.css
```
  , and
```
skills/html-ppt/assets/runtime.js
```
  into a project-local
```
assets/
```
  (with
```
assets/animations/animations.css
```
  ), then rewrite the four
```
<link>
```
  /
```
<script>
```
  tags in
```
index.html
```
  from
```
../../../assets/...
```
  to the matching project-local paths (
```
assets/fonts.css
```
  ,
```
assets/base.css
```
  ,
```
assets/animations/animations.css
```
  ,
```
assets/runtime.js
```
  ).
- Recipe B — inline: read the same four files and replace each
```
<link rel="stylesheet" href="../../../assets/...">
```
  with a
```
<style>...</style>
```
  containing the file's contents, and the
```
<script src="../../../assets/runtime.js">
```
  with a
```
<script>...</script>
```
  containing
```
runtime.js
```
  . Yields a single self-contained
```
index.html
```
  . Either way, do not ship the upstream
```
../../../assets/...
```
  URLs verbatim into a project artifact — they only work in-tree.
Pick a theme. Default tokens look fine; if the user wants a different feel, swap in any of the 36 themes from
```
skills/html-ppt/assets/themes/*.css
```
via
```
<link id="theme-link">
```
and let
```
T
```
cycle.
Replace demo content, not classes. The
```
.tpl-presenter-mode-reveal
```
scoped CSS only recognises the structural classes shipped in the template — keep them.
Speaker notes go inside
<aside class="notes">
or
<div class="notes">
— never as visible text on the slide.

先阅读主技能文档：所有创作规则都在
```
skills/html-ppt/SKILL.md
```
中——包括内容/受众检查清单、令牌规则、布局复用、演讲者模式、键盘运行机制，以及“切勿将仅演讲者可见的文本放在幻灯片上”的规则。

从匹配的模板文件夹开始：

skills/html-ppt/templates/full-decks/presenter-mode-reveal/

——将

index.html

和

style.css

复制到项目中，保留

.tpl-presenter-mode-reveal

的body类。

为模板引入共享运行时文件：上游的
```
index.html
```
通过
```
../../../assets/...
```
链接共享CSS/JS文件，因为它位于
```
skills/html-ppt/templates/full-decks/
```
下三层目录。一旦将
```
index.html
```
复制到项目中，这些相对父级的URL将无法解析，
```
base.css
```
、
```
animations.css
```
和
```
runtime.js
```
会返回404错误——这意味着演示文稿无法激活，幻灯片导航将失效。请根据项目选择以下两种方案之一：
- 方案A——复制并重写（推荐）：将
```
skills/html-ppt/assets/fonts.css
```
  、
```
skills/html-ppt/assets/base.css
```
  、
```
skills/html-ppt/assets/animations/animations.css
```
  和
```
skills/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直接用于项目成品中——它们仅在原项目目录结构下有效。
选择主题：默认令牌样式效果良好；如果用户想要不同的风格，可以通过
```
<link id="theme-link">
```
引入
```
skills/html-ppt/assets/themes/*.css
```
中的任意36套主题，按T键即可切换主题。
替换演示内容，保留样式类：
```
.tpl-presenter-mode-reveal
```
作用域下的CSS仅识别模板中自带的结构化样式类——请保留这些类。
演讲者备注放在
<aside class="notes">
或
<div class="notes">
标签内——绝不要作为幻灯片上的可见文本。

Attribution

版权说明

Visual system, layouts, themes and the runtime keyboard model come from the upstream MIT-licensed

lewislulu/html-ppt-skill

. The LICENSE file ships at

skills/html-ppt/LICENSE

; please keep it in place when redistributing.

视觉系统、布局、主题和运行时键盘机制均源自MIT许可的上游项目

lewislulu/html-ppt-skill

。许可文件位于

skills/html-ppt/LICENSE

；如需分发，请保留该文件。