html-ppt-knowledge-arch-blueprint

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HTML PPT · 奶油蓝图架构

A focused entry point into the

html-ppt

master skill that lands the user directly on the knowledge-arch-blueprint
full-deck template.

这是

html-ppt

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

knowledge-arch-blueprint

**完整演示文稿模板。

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

knowledge-arch-blueprint

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

示例画廊将“使用此提示”关联到上述示例提示。当用户接受该提示后，如果用户想要完全匹配

knowledge-arch-blueprint

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

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/knowledge-arch-blueprint/

— copy

index.html

and

style.css

into the project, keep the

.tpl-knowledge-arch-blueprint

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-knowledge-arch-blueprint
```
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/knowledge-arch-blueprint/

—— 将

index.html

和

style.css

复制到项目中，保留

.tpl-knowledge-arch-blueprint

的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-knowledge-arch-blueprint
```
作用域的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

；重新分发时请保留该文件。