html-ppt-tech-sharing

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HTML PPT · Tech Sharing

HTML PPT · 技术分享

A focused entry point into the

html-ppt

master skill that lands the user directly on the tech-sharing
full-deck template.

这是指向

html-ppt

主技能的专属入口，可直接为用户打开**

tech-sharing

**完整演示文稿模板。

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

tech-sharing

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

示例图库将“使用此提示”关联到上述示例提示。当你接受该提示后，如果用户恰好需要

tech-sharing

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

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/tech-sharing/
```
— copy
```
index.html
```
and
```
style.css
```
into the project, keep the
```
.tpl-tech-sharing
```
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-tech-sharing
```
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/tech-sharing/
```
——将
```
index.html
```
和
```
style.css
```
复制到项目中，保留
```
.tpl-tech-sharing
```
的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-tech-sharing
```
作用域下的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

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