5dd70b5016
Some checks failed
ci / Validate workspace (push) Successful in 12m32s
landing-page-ci / Validate landing page (push) Successful in 9m41s
landing-page-deploy / Deploy landing page (push) Failing after 5m23s
github-metrics / Generate repository metrics SVG (push) Failing after 2m3s
refresh-contributors-wall / Refresh contributors wall cache bust (push) Failing after 11s
This repository contains the open-design daemon CLI source code, built and packaged at https://helix-mind.ai/cli/open-design/latest.tgz for use by the HelixMind /design slash command. Licenses: Apache-2.0 (root) + MIT (skills/*)
79 lines
4.2 KiB
Markdown
79 lines
4.2 KiB
Markdown
---
|
||
name: html-ppt-tech-sharing
|
||
description: Conference / internal tech-talk deck — GitHub-dark, JetBrains Mono, terminal code blocks, agenda + Q&A pages. Use for engineering presentations, internal sharing sessions, conference talks, and code-heavy walkthroughs.
|
||
triggers:
|
||
- "tech sharing"
|
||
- "tech talk"
|
||
- "技术分享"
|
||
- "engineering talk"
|
||
- "conference talk"
|
||
- "dev talk"
|
||
od:
|
||
mode: deck
|
||
scenario: engineering
|
||
featured: 22
|
||
upstream: "https://github.com/lewislulu/html-ppt-skill"
|
||
preview:
|
||
type: html
|
||
entry: index.html
|
||
design_system:
|
||
requires: false
|
||
speaker_notes: true
|
||
animations: true
|
||
example_prompt: "帮我用 html-ppt-tech-sharing 模板做一份 8 页的技术分享 PPT。先确认：分享主题、目标听众（同事 / 社区 / 客户）、要不要包含代码片段和 benchmark。GitHub 暗色主题 + JetBrains Mono，agenda + Q&A 页备好。"
|
||
---
|
||
# HTML PPT · Tech Sharing
|
||
|
||
A focused entry point into the [`html-ppt`](../html-ppt/SKILL.md) master skill that lands the user directly on the **`tech-sharing`** full-deck template.
|
||
|
||
## 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](../html-ppt/references/full-decks.md) for screenshots and rationale).
|
||
|
||
## How to author the deck
|
||
|
||
1. **Read the master skill first.** All authoring rules live in
|
||
[`skills/html-ppt/SKILL.md`](../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.
|
||
2. **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.
|
||
3. **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.
|
||
4. **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.
|
||
5. **Replace demo content, not classes.** The `.tpl-tech-sharing` scoped CSS only
|
||
recognises the structural classes shipped in the template — keep them.
|
||
6. **Speaker notes go inside `<aside class="notes">` or `<div class="notes">`** — never as visible text on the slide.
|
||
|
||
## Attribution
|
||
|
||
Visual system, layouts, themes and the runtime keyboard model come from
|
||
the upstream MIT-licensed [`lewislulu/html-ppt-skill`](https://github.com/lewislulu/html-ppt-skill). The
|
||
LICENSE file ships at `skills/html-ppt/LICENSE`; please keep it in place when
|
||
redistributing.
|