html-ppt-dir-key-nav-minimal

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HTML PPT · 8 色极简方向键

HTML PPT · 8色极简方向键

A focused entry point into the

html-ppt

master skill that lands the user directly on the dir-key-nav-minimal
full-deck template.

这是

html-ppt

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

dir-key-nav-minimal

**完整演示文稿模板。

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

dir-key-nav-minimal

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

示例画廊将“使用此提示”关联至上方的示例提示。当用户接受该提示后，若其明确需要

dir-key-nav-minimal

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

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/dir-key-nav-minimal/

— copy

index.html

and

style.css

into the project, keep the

.tpl-dir-key-nav-minimal

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-dir-key-nav-minimal
```
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/dir-key-nav-minimal/

——将

index.html

和

style.css

复制到项目中，保留

.tpl-dir-key-nav-minimal

的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-dir-key-nav-minimal
```
作用域下的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

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