html-ppt-weekly-report

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

HTML PPT · Weekly Report

HTML PPT · 周报模板

A focused entry point into the

html-ppt

master skill that lands the user directly on the weekly-report
full-deck template.

这是

html-ppt

主技能的专属入口，可直接将用户引导至 weekly-report
完整演示文稿模板。

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

weekly-report

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

示例库将“使用此提示”关联至上方的example_prompt。当您接受该提示后，如果用户需要完全匹配

weekly-report

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

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/weekly-report/

— copy

index.html

and

style.css

into the project, keep the

.tpl-weekly-report

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-weekly-report
```
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/weekly-report/

— 将

index.html

和

style.css

复制到项目中，保留

.tpl-weekly-report

的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-weekly-report
```
作用域下的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

。LICENSE文件位于

skills/html-ppt/LICENSE

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