Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

chore(examples): move example projects to a separate repository

hugohe300202b8ed4f3
diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml
deleted file mode 100644
index d9935c95..00000000
--- a/.github/workflows/deploy-pages.yml
+++ /dev/null
@@ -1,58 +0,0 @@
-# GitHub Pages 部署工作流
-# 自动将 PPT Master 示例项目部署到 GitHub Pages
-
-name: Deploy to GitHub Pages
-
-on:
- # 推送到 main 分支时,仅网页相关文件变更才触发
- push:
- branches: ["main"]
- paths:
- - 'index.html'
- - 'viewer.html'
- - 'examples/**'
- - '.github/workflows/deploy-pages.yml'
- # 允许手动触发(不受路径限制)
- workflow_dispatch:
-
-# 设置 GITHUB_TOKEN 权限
-permissions:
- contents: read
- pages: write
- id-token: write
-
-# 防止并发部署
-concurrency:
- group: "pages"
- cancel-in-progress: false
-
-jobs:
- # 构建任务
- build:
- runs-on: ubuntu-latest
- steps:
- - name: Checkout
- uses: actions/checkout@v4
-
- - name: Setup Pages
- uses: actions/configure-pages@v4
- with:
- enablement: true
-
- - name: Upload artifact
- uses: actions/upload-pages-artifact@v3
- with:
- # 上传整个仓库(包含 examples、templates 等)
- path: '.'
-
- # 部署任务
- deploy:
- environment:
- name: github-pages
- url: ${{ steps.deployment.outputs.page_url }}
- runs-on: ubuntu-latest
- needs: build
- steps:
- - name: Deploy to GitHub Pages
- id: deployment
- uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
index 1095b0b2..20295c71 100644
--- a/.gitignore
+++ b/.gitignore
@@ -180,7 +180,7 @@ TODO.md
PERSONAL_NOTES.md
# Projects directory - Work-in-progress projects (not version controlled)
-# Completed projects should be moved to examples/
+# Completed projects are published through the separate examples repository
# Use cloud sync (iCloud/Dropbox) for backup and multi-device access
projects/*
!projects/README.md
diff --git a/AGENTS.md b/AGENTS.md
index e03ab8fa..b55c03d3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -119,5 +119,4 @@ For serial post-processing and export, follow [`generate-pptx.md`](skills/ppt-ma
- `skills/ppt-master/workflows/` — top-level route authorities plus supporting child workflows, profiles, stages, and governance runbooks.
- `docs/` — user-facing documentation (FAQ, installation, technical design, templates guide, audio narration).
- `docs/rules/` — repo-wide style rules.
-- `examples/` — example projects.
- `projects/` — user project workspace.
diff --git a/README.md b/README.md
index a9ba62ab..0ea357b2 100644
--- a/README.md
+++ b/README.md
@@ -49,8 +49,8 @@ Thanks to [Kimi](https://www.kimi.com/code/?aff=ppt-master) for sponsoring this
> **Editable is already table stakes — what sets PPT Master apart is native depth.** It hands you a real PowerPoint: slide masters, native shapes, data-backed charts and tables — not flat text boxes, and not a filled-in template. It also does more than lay slides out nicely — it reasons the argument into shape first, then designs; and that native depth keeps **converging with PowerPoint itself**, adding more of its native capabilities release after release. In form, it's a workflow that runs inside any agent-capable AI tool: hand the AI your topic or material, and it generates on your machine — your data stays local, no platform or model lock-in. How it works and where the limits are → [Product Positioning](#product-positioning).
<p align="center">
- <a href="https://hugohe3.github.io/ppt-master/"><strong>Live Demo</strong></a> ·
- <a href="./examples/"><strong>Examples</strong></a> ·
+ <a href="https://hugohe3.github.io/ppt-master-examples/"><strong>Live Demo</strong></a> ·
+ <a href="https://github.com/hugohe3/ppt-master-examples"><strong>Examples</strong></a> ·
<a href="./docs/faq.md"><strong>FAQ</strong></a> ·
<a href="./docs/roadmap.md"><strong>Roadmap</strong></a>
</p>
@@ -62,42 +62,42 @@ Thanks to [Kimi](https://www.kimi.com/code/?aff=ppt-master) for sponsoring this
<table>
<tr>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_pritzker_2026"><img src="docs/assets/screenshots/preview_pritzker_2026.png" alt="Editorial magazine — Pritzker 2026 architecture review" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_pritzker_2026"><img src="docs/assets/screenshots/preview_pritzker_2026.png" alt="Editorial magazine — Pritzker 2026 architecture review" /></a><br/>
<sub><b>Editorial Magazine</b> — architecture photography, calm typographic grid<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_pritzker_2026">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_pritzker_2026/exports/pritzker_2026.pptx">Download .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_pritzker_2026">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_pritzker_2026/exports/pritzker_2026.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_global_ai_capital_2026"><img src="docs/assets/screenshots/preview_global_ai_capital.png" alt="Data journalism — Global AI Capital 2026" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_global_ai_capital_2026"><img src="docs/assets/screenshots/preview_global_ai_capital.png" alt="Data journalism — Global AI Capital 2026" /></a><br/>
<sub><b>Data Journalism</b> — Bloomberg-style dark dashboard, chart-driven<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_global_ai_capital_2026">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_global_ai_capital_2026/exports/global_ai_capital_2026.pptx">Download .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_global_ai_capital_2026">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_global_ai_capital_2026/exports/global_ai_capital_2026.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_swiss_grid_systems"><img src="docs/assets/screenshots/preview_swiss_grid.png" alt="Swiss typographic grid — Grid Systems primer" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_swiss_grid_systems"><img src="docs/assets/screenshots/preview_swiss_grid.png" alt="Swiss typographic grid — Grid Systems primer" /></a><br/>
<sub><b>Swiss Grid</b> — strict modular grid, restrained type, red-accent<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_swiss_grid_systems">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_swiss_grid_systems/exports/swiss_grid_systems.pptx">Download .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_swiss_grid_systems">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_swiss_grid_systems/exports/swiss_grid_systems.pptx">Download .pptx</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_glassmorphism_demo"><img src="docs/assets/screenshots/preview_glassmorphism_demo.png" alt="Glassmorphism SaaS — AI Agent engineering demo" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_glassmorphism_demo"><img src="docs/assets/screenshots/preview_glassmorphism_demo.png" alt="Glassmorphism SaaS — AI Agent engineering demo" /></a><br/>
<sub><b>Glassmorphism SaaS</b> — translucent layers, gradient depth, product UI<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_glassmorphism_demo">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_glassmorphism_demo/exports/glassmorphism_demo.pptx">Download .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_glassmorphism_demo">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_glassmorphism_demo/exports/glassmorphism_demo.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_sugar_rush_memphis"><img src="docs/assets/screenshots/preview_sugar_rush_memphis.png" alt="Memphis pop — Sugar Rush festival" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_sugar_rush_memphis"><img src="docs/assets/screenshots/preview_sugar_rush_memphis.png" alt="Memphis pop — Sugar Rush festival" /></a><br/>
<sub><b>Memphis Pop</b> — bold primaries, geometric patterns, playful energy<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_sugar_rush_memphis">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_sugar_rush_memphis/exports/sugar_rush_memphis.pptx">Download .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_sugar_rush_memphis">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_sugar_rush_memphis/exports/sugar_rush_memphis.pptx">Download .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_indie_bookstore_zine_guide"><img src="docs/assets/screenshots/preview_indie_bookstore_zine.png" alt="Risograph zine — Indie bookstore guide" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_indie_bookstore_zine_guide"><img src="docs/assets/screenshots/preview_indie_bookstore_zine.png" alt="Risograph zine — Indie bookstore guide" /></a><br/>
<sub><b>Risograph Zine</b> — duotone print, hand-made bookstore-culture feel<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_indie_bookstore_zine_guide">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_indie_bookstore_zine_guide/exports/indie_bookstore_zine_guide.pptx">Download .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_indie_bookstore_zine_guide">Flip online</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_indie_bookstore_zine_guide/exports/indie_bookstore_zine_guide.pptx">Download .pptx</a></sub>
</td>
</tr>
</table>
<p align="center">
- <sub>Downloading any .pptx and opening it in PowerPoint is the fastest way to see what it can really do.<br/><a href="https://hugohe3.github.io/ppt-master/">Flip through all examples online →</a> · <a href="./examples/"><code>examples/</code> directory</a> · <a href="./docs/why-ppt-master.md">Why PPT Master?</a></sub>
+ <sub>Downloading any .pptx and opening it in PowerPoint is the fastest way to see what it can really do.<br/><a href="https://hugohe3.github.io/ppt-master-examples/">Flip through all examples online →</a> · <a href="https://github.com/hugohe3/ppt-master-examples">Source repository</a> · <a href="./docs/why-ppt-master.md">Why PPT Master?</a></sub>
</p>
---
@@ -126,7 +126,7 @@ Why you'd choose it, and where it isn't the right fit → [Why PPT Master](./doc
> ### This is a tool, not a wishing well
> `harness + model = agent` — PPT Master only owns the workflow; the model sets the ceiling. Recommended: **Kimi K3 (or Claude) with a large context window (~1M tokens) + AI image generation (`gpt-image-2` or Google `gemini-3.1-flash-image`)**; other models can run the pipeline, with a quality gap.
>
-> And don't expect a finished, perfect deck in one shot. The tool's value is taking most of the tedious work off your plate; the polishing that's left is yours — a natively editable deck exists precisely so you can keep working on it, not a flat image you can't touch. The cheaper the model, the more there is to do; if results disappoint, upgrade the model first, then check your usage against [Getting Started](./docs/getting-started.md) and the example projects.
+> And don't expect a finished, perfect deck in one shot. The tool's value is taking most of the tedious work off your plate; the polishing that's left is yours — a natively editable deck exists precisely so you can keep working on it, not a flat image you can't touch. The cheaper the model, the more there is to do; if results disappoint, upgrade the model first, then check your usage against [Getting Started](./docs/getting-started.md) and the [example projects](https://hugohe3.github.io/ppt-master-examples/).
---
@@ -369,7 +369,7 @@ PPT Master reads the current process environment first, then the first `.env` fo
| 📖 | [SKILL.md](./skills/ppt-master/SKILL.md) | Core workflow and rules |
| 📐 | [Canvas Formats](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9, Xiaohongshu, WeChat, and 10+ formats |
| 🛠️ | [Scripts & Tools](./skills/ppt-master/scripts/README.md) | All scripts and commands |
-| 💼 | [Examples](./examples/README.md) | All example projects |
+| 💼 | [Examples](https://hugohe3.github.io/ppt-master-examples/) | All example projects |
| 🏗️ | [Technical Design](./docs/technical-design.md) | Architecture, design philosophy, why SVG |
| ❓ | [FAQ](./docs/faq.md) | Model selection, cost, layout troubleshooting, custom templates |
diff --git a/README_CN.md b/README_CN.md
index 0016bff0..1a4e82c8 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -49,8 +49,8 @@
> **可编辑早已是及格线——真正拉开差距的是原生深度。** PPT Master 交给你的是一份真正的 PowerPoint:母版、原生形状、数据驱动的图表与表格,而不是一堆扁平文本框,也不是套模板填空的结果。它还不止把幻灯片排得好看——先替你把逻辑理顺,再谈视觉;而这份原生深度在**持续向 PowerPoint 本身靠拢**,逐版本补齐更多原生能力。形态上,它是一套在有 Agent 能力的 AI 工具里运行的工作流:把你的主题或材料交给 AI,就在你本机生成,数据不出本地,不锁定任何平台和模型。工作原理与能力边界 → [产品定位](#产品定位)。
<p align="center">
- <a href="https://hugohe3.github.io/ppt-master/"><strong>在线预览</strong></a> ·
- <a href="./examples/"><strong>示例下载</strong></a> ·
+ <a href="https://hugohe3.github.io/ppt-master-examples/"><strong>在线预览</strong></a> ·
+ <a href="https://github.com/hugohe3/ppt-master-examples"><strong>示例下载</strong></a> ·
<a href="./docs/zh/faq.md"><strong>常见问题</strong></a> ·
<a href="./docs/zh/roadmap.md"><strong>路线图</strong></a>
</p>
@@ -62,42 +62,42 @@
<table>
<tr>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_pritzker_2026"><img src="docs/assets/screenshots/preview_pritzker_2026.png" alt="杂志风 — 普利兹克奖 2026" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_pritzker_2026"><img src="docs/assets/screenshots/preview_pritzker_2026.png" alt="杂志风 — 普利兹克奖 2026" /></a><br/>
<sub><b>杂志风</b> — 建筑摄影 + 排版网格,冷静克制的编辑感<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_pritzker_2026">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_pritzker_2026/exports/pritzker_2026.pptx">下载 .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_pritzker_2026">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_pritzker_2026/exports/pritzker_2026.pptx">下载 .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_global_ai_capital_2026"><img src="docs/assets/screenshots/preview_global_ai_capital.png" alt="新闻风 — 2026 全球 AI 资本格局" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_global_ai_capital_2026"><img src="docs/assets/screenshots/preview_global_ai_capital.png" alt="新闻风 — 2026 全球 AI 资本格局" /></a><br/>
<sub><b>新闻 / 财经数据风</b> — 深色仪表盘,图表驱动,彭博风<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_global_ai_capital_2026">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_global_ai_capital_2026/exports/global_ai_capital_2026.pptx">下载 .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_global_ai_capital_2026">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_global_ai_capital_2026/exports/global_ai_capital_2026.pptx">下载 .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_swiss_grid_systems"><img src="docs/assets/screenshots/preview_swiss_grid.png" alt="瑞士风 — 网格系统入门" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_swiss_grid_systems"><img src="docs/assets/screenshots/preview_swiss_grid.png" alt="瑞士风 — 网格系统入门" /></a><br/>
<sub><b>瑞士风</b> — 严格栅格,克制字体,红色点缀<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_swiss_grid_systems">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_swiss_grid_systems/exports/swiss_grid_systems.pptx">下载 .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_swiss_grid_systems">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_swiss_grid_systems/exports/swiss_grid_systems.pptx">下载 .pptx</a></sub>
</td>
</tr>
<tr>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_glassmorphism_demo"><img src="docs/assets/screenshots/preview_glassmorphism_demo.png" alt="毛玻璃风 — AI Agent 工程化 Demo" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_glassmorphism_demo"><img src="docs/assets/screenshots/preview_glassmorphism_demo.png" alt="毛玻璃风 — AI Agent 工程化 Demo" /></a><br/>
<sub><b>毛玻璃 SaaS</b> — 半透明叠层,渐变景深,产品 UI 感<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_glassmorphism_demo">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_glassmorphism_demo/exports/glassmorphism_demo.pptx">下载 .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_glassmorphism_demo">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_glassmorphism_demo/exports/glassmorphism_demo.pptx">下载 .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_sugar_rush_memphis"><img src="docs/assets/screenshots/preview_sugar_rush_memphis.png" alt="孟菲斯风 — Sugar Rush 音乐节" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_sugar_rush_memphis"><img src="docs/assets/screenshots/preview_sugar_rush_memphis.png" alt="孟菲斯风 — Sugar Rush 音乐节" /></a><br/>
<sub><b>孟菲斯波普</b> — 高饱和原色,几何图形,俏皮活力<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_sugar_rush_memphis">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_sugar_rush_memphis/exports/sugar_rush_memphis.pptx">下载 .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_sugar_rush_memphis">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_sugar_rush_memphis/exports/sugar_rush_memphis.pptx">下载 .pptx</a></sub>
</td>
<td align="center" width="33%">
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_indie_bookstore_zine_guide"><img src="docs/assets/screenshots/preview_indie_bookstore_zine.png" alt="Zine 风 — 独立书店指南" /></a><br/>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_indie_bookstore_zine_guide"><img src="docs/assets/screenshots/preview_indie_bookstore_zine.png" alt="Zine 风 — 独立书店指南" /></a><br/>
<sub><b>Risograph Zine</b> — 双色印刷质感,手作书店文化<br/>
- <a href="https://hugohe3.github.io/ppt-master/viewer.html?project=ppt169_indie_bookstore_zine_guide">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master/main/examples/ppt169_indie_bookstore_zine_guide/exports/indie_bookstore_zine_guide.pptx">下载 .pptx</a></sub>
+ <a href="https://hugohe3.github.io/ppt-master-examples/viewer.html?project=ppt169_indie_bookstore_zine_guide">在线翻页</a> · <a href="https://raw.githubusercontent.com/hugohe3/ppt-master-examples/main/examples/ppt169_indie_bookstore_zine_guide/exports/indie_bookstore_zine_guide.pptx">下载 .pptx</a></sub>
</td>
</tr>
</table>
<p align="center">
- <sub>下载任意一份 .pptx 在 PowerPoint 里打开,是感受真实产出水平最快的方式。<br/><a href="https://hugohe3.github.io/ppt-master/">在线翻看全部示例 →</a> · <a href="./examples/"><code>examples/</code> 目录</a> · <a href="./docs/zh/why-ppt-master.md">为什么选 PPT Master?</a></sub>
+ <sub>下载任意一份 .pptx 在 PowerPoint 里打开,是感受真实产出水平最快的方式。<br/><a href="https://hugohe3.github.io/ppt-master-examples/">在线翻看全部示例 →</a> · <a href="https://github.com/hugohe3/ppt-master-examples">示例仓库</a> · <a href="./docs/zh/why-ppt-master.md">为什么选 PPT Master?</a></sub>
</p>
---
@@ -126,7 +126,7 @@
> ### 这是一个工具,不是一个许愿池
> `harness + model = agent`——PPT Master 只负责工作流,产出上限由模型决定。推荐 **Kimi K3(或 Claude)大上下文窗口(~100 万 token)+ AI 生图(`gpt-image-2` 或 Google `gemini-3.1-flash-image`)**;其他模型能跑通流程,但有质量差距。
>
-> 也别指望一把就拿到完美成品。它的价值是帮你把大部分枯燥的活儿干掉,剩下的打磨交给你——做原生可编辑的 PPT,本就是为了让你接着改,而不是甩给你一张改不动的图。模型越便宜,要补的人工就越多;效果不理想,先升级模型,再对照[快速入门](./docs/zh/getting-started.md)和示例工程检查用法。
+> 也别指望一把就拿到完美成品。它的价值是帮你把大部分枯燥的活儿干掉,剩下的打磨交给你——做原生可编辑的 PPT,本就是为了让你接着改,而不是甩给你一张改不动的图。模型越便宜,要补的人工就越多;效果不理想,先升级模型,再对照[快速入门](./docs/zh/getting-started.md)和[示例工程](https://hugohe3.github.io/ppt-master-examples/)检查用法。
---
@@ -374,7 +374,7 @@ PPT Master 会优先读取当前进程环境变量,然后按顺序读取第一
| 📖 | [SKILL.md](./skills/ppt-master/SKILL.md) | 核心流程与规则 |
| 📐 | [画布格式](./skills/ppt-master/references/canvas-formats.md) | PPT 16:9、小红书、朋友圈等 10+ 种格式 |
| 🛠️ | [脚本与工具](./skills/ppt-master/scripts/README.md) | 所有脚本和命令 |
-| 💼 | [示例](./examples/README.md) | 所有示例项目 |
+| 💼 | [示例](https://hugohe3.github.io/ppt-master-examples/) | 所有示例项目 |
| 🏗️ | [技术路线](./docs/zh/technical-design.md) | 架构、设计哲学、为什么选 SVG |
| ❓ | [常见问题](./docs/zh/faq.md) | 模型选择、费用、排版问题排查、自定义模板 |
diff --git a/docs/why-ppt-master.md b/docs/why-ppt-master.md
index 0a3ac404..6329f5ec 100644
--- a/docs/why-ppt-master.md
+++ b/docs/why-ppt-master.md
@@ -82,7 +82,7 @@ The choice is yours — and it doesn't stop at editors and models. Native chart
A deck's design is set by two independent axes you combine freely: the **narrative skeleton** (mode, see the section above) decides how it argues, and the **visual style** decides how it looks — 18 built-ins from `swiss-minimal` and `editorial` to `dark-tech`, `brutalist`, and `ink-wash`, each with a `custom` option. Any one pairs with any other, locked once at confirmation and held stable across the deck.
-The [examples/](../examples/) directory spans government fiscal analysis, AI architecture, editorial magazine, data journalism, Swiss grid, Memphis pop, risograph zine, and more.
+The [PPT Master examples site](https://hugohe3.github.io/ppt-master-examples/) spans government fiscal analysis, AI architecture, editorial magazine, data journalism, Swiss grid, Memphis pop, risograph zine, and more.
### Full Source-Document Input
diff --git a/docs/zh/why-ppt-master.md b/docs/zh/why-ppt-master.md
index b00986fa..b4c1d5d0 100644
--- a/docs/zh/why-ppt-master.md
+++ b/docs/zh/why-ppt-master.md
@@ -82,7 +82,7 @@ PPT Master 是一个框架,不是某个 IDE 的插件。**编辑器方面**,
一份 deck 的设计由两条独立的轴决定、可自由组合:**叙事骨架**(mode,见上一节)决定怎么讲,**视觉风格**(visual style)决定长什么样——18 种内置,从 `swiss-minimal`、`editorial` 到 `dark-tech`、`brutalist`、`ink-wash`,都可再加 `custom`。任意一个配任意一个,在确认阶段锁定一次、全程稳定。
-[examples/](../../examples/) 目录涵盖政府财政分析、AI 架构、杂志编辑、数据新闻、瑞士网格、孟菲斯波普、Riso 版画等等。
+[PPT Master 示例站](https://hugohe3.github.io/ppt-master-examples/)涵盖政府财政分析、AI 架构、杂志编辑、数据新闻、瑞士网格、孟菲斯波普、Riso 版画等等。
### 全格式源文档输入
diff --git a/index.html b/index.html
index 0f4b5205..67d6c85d 100644
--- a/index.html
+++ b/index.html
@@ -1,667 +1,14 @@
-<!DOCTYPE html>
+<!doctype html>
<html lang="en">
-
<head>
- <meta charset="UTF-8">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>PPT Master — AI generates natively editable PPTX from any document</title>
- <meta name="description" content="Drop in a PDF, DOCX, URL, or Markdown — get back a natively editable PowerPoint with real shapes, not images. Open source templates and live examples.">
- <meta property="og:title" content="PPT Master — AI generates natively editable PPTX">
- <meta property="og:description" content="Drop in any document, get back a natively editable PowerPoint with real shapes, real text boxes, and real charts. Not images. Click anything and edit it.">
- <meta property="og:image" content="https://hugohe3.github.io/ppt-master/docs/assets/screenshots/preview_pritzker_2026.png">
- <meta property="og:url" content="https://hugohe3.github.io/ppt-master/">
- <meta property="og:type" content="website">
- <meta name="twitter:card" content="summary_large_image">
- <meta name="twitter:title" content="PPT Master — AI generates natively editable PPTX">
- <meta name="twitter:description" content="Drop in any document, get back a natively editable PowerPoint with real shapes. Not images. Open source.">
- <meta name="twitter:image" content="https://hugohe3.github.io/ppt-master/docs/assets/screenshots/preview_pritzker_2026.png">
- <link rel="icon"
- href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 48 32' fill='none' stroke='%235b8def' stroke-width='3' stroke-linecap='round' stroke-linejoin='round'><rect x='2' y='2' width='44' height='28' rx='2.5'/><line x1='9' y1='11' x2='22' y2='11'/><line x1='9' y1='17' x2='32' y2='17'/><line x1='9' y1='23' x2='26' y2='23'/></svg>">
- <style>
- :root {
- /* Editorial dark — single accent, neutral surfaces */
- --primary: #5b8def;
- --primary-light: #88aaff;
- --secondary: #5b8def;
- --dark: #161618;
- --darker: #0d0d0f;
- --text: #e6e6e9;
- --text-muted: #8a8a93;
- --surface: #16161a;
- --surface-hover: #1d1d20;
- --border: #26262a;
- --success: #5b8def;
- --warning: #5b8def;
- --accent: #5b8def;
- }
-
- * {
- margin: 0;
- padding: 0;
- box-sizing: border-box;
- }
-
- body {
- font-family: -apple-system, BlinkMacSystemFont, 'Inter', 'Segoe UI', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif;
- background: var(--darker);
- color: var(--text);
- min-height: 100vh;
- line-height: 1.6;
- -webkit-font-smoothing: antialiased;
- -moz-osx-font-smoothing: grayscale;
- font-feature-settings: 'cv02', 'cv03', 'cv04', 'cv11';
- }
-
- /* Header */
- .header {
- background: var(--darker);
- padding: 120px 20px 80px;
- text-align: center;
- position: relative;
- overflow: hidden;
- border-bottom: 1px solid var(--border);
- }
-
- .header::before {
- content: '';
- position: absolute;
- top: -300px;
- left: 50%;
- transform: translateX(-50%);
- width: 1100px;
- height: 700px;
- background: radial-gradient(circle, rgba(91, 141, 239, 0.12) 0%, transparent 60%);
- pointer-events: none;
- }
-
- .header-content {
- position: relative;
- z-index: 1;
- max-width: 820px;
- margin: 0 auto;
- }
-
- .logo {
- display: inline-flex;
- align-items: center;
- justify-content: center;
- color: var(--primary);
- margin-bottom: 28px;
- opacity: 0.95;
- }
-
- .logo svg {
- width: 56px;
- height: auto;
- }
-
- .eyebrow {
- display: inline-block;
- font-size: 0.78rem;
- font-weight: 500;
- letter-spacing: 0.12em;
- text-transform: uppercase;
- color: var(--text-muted);
- margin-bottom: 20px;
- padding: 6px 14px;
- border: 1px solid var(--border);
- border-radius: 999px;
- background: var(--surface);
- }
-
- .header h1 {
- font-size: 3.75rem;
- font-weight: 700;
- line-height: 1.05;
- letter-spacing: -0.025em;
- margin-bottom: 20px;
- color: var(--text);
- }
-
- .header p {
- font-size: 1.15rem;
- color: var(--text-muted);
- max-width: 620px;
- margin: 0 auto;
- line-height: 1.55;
- }
-
- .header-cta {
- display: flex;
- justify-content: center;
- gap: 12px;
- margin-top: 36px;
- flex-wrap: wrap;
- }
-
- .cta-btn {
- display: inline-flex;
- align-items: center;
- gap: 8px;
- padding: 11px 22px;
- border-radius: 8px;
- font-size: 0.95rem;
- font-weight: 500;
- text-decoration: none;
- transition: background 0.18s ease, border-color 0.18s ease, transform 0.18s ease;
- border: 1px solid transparent;
- cursor: pointer;
- letter-spacing: -0.01em;
- }
-
- .cta-btn.primary {
- background: var(--primary);
- color: #fff;
- }
-
- .cta-btn.primary:hover {
- background: #4a7be0;
- transform: translateY(-1px);
- }
-
- .cta-btn.secondary {
- background: transparent;
- color: var(--text);
- border-color: var(--border);
- }
-
- .cta-btn.secondary:hover {
- background: var(--surface);
- border-color: #3a3a40;
- transform: translateY(-1px);
- }
-
- .stats {
- display: inline-flex;
- justify-content: center;
- gap: 0;
- margin-top: 56px;
- border: 1px solid var(--border);
- border-radius: 12px;
- background: var(--surface);
- overflow: hidden;
- }
-
- .stat {
- text-align: center;
- padding: 18px 32px;
- border-right: 1px solid var(--border);
- }
-
- .stat:last-child {
- border-right: none;
- }
-
- .stat-value {
- font-size: 1.75rem;
- font-weight: 600;
- color: var(--text);
- letter-spacing: -0.02em;
- line-height: 1.1;
- }
-
- .stat-label {
- font-size: 0.78rem;
- color: var(--text-muted);
- letter-spacing: 0.08em;
- text-transform: uppercase;
- margin-top: 4px;
- }
-
- /* Navigation */
- .nav {
- background: rgba(13, 13, 15, 0.85);
- backdrop-filter: blur(12px);
- -webkit-backdrop-filter: blur(12px);
- border-bottom: 1px solid var(--border);
- padding: 14px 20px;
- position: sticky;
- top: 0;
- z-index: 100;
- }
-
- .nav-content {
- max-width: 1400px;
- margin: 0 auto;
- display: flex;
- justify-content: center;
- gap: 4px;
- flex-wrap: wrap;
- }
-
- .nav-btn {
- background: transparent;
- border: 1px solid transparent;
- color: var(--text-muted);
- padding: 7px 16px;
- border-radius: 8px;
- cursor: pointer;
- font-size: 0.9rem;
- font-weight: 500;
- transition: color 0.18s ease, background 0.18s ease, border-color 0.18s ease;
- letter-spacing: -0.005em;
- }
-
- .nav-btn:hover {
- color: var(--text);
- background: var(--surface);
- }
-
- .nav-btn.active {
- color: var(--text);
- background: var(--surface);
- border-color: var(--border);
- }
-
- /* Main Content */
- .main {
- max-width: 1400px;
- margin: 0 auto;
- padding: 56px 20px 80px;
- }
-
- .section-title {
- display: flex;
- align-items: baseline;
- justify-content: space-between;
- gap: 10px;
- font-size: 1.25rem;
- font-weight: 600;
- margin-bottom: 28px;
- color: var(--text);
- letter-spacing: -0.015em;
- }
-
- .section-title .count {
- font-size: 0.85rem;
- font-weight: 400;
- color: var(--text-muted);
- letter-spacing: 0;
- }
-
- /* Project Grid */
- .projects-grid {
- display: grid;
- grid-template-columns: repeat(auto-fill, minmax(360px, 1fr));
- gap: 20px;
- margin-bottom: 50px;
- }
-
- .project-card {
- display: block;
- background: var(--surface);
- border: 1px solid var(--border);
- border-radius: 12px;
- overflow: hidden;
- transition: border-color 0.2s ease, transform 0.2s ease, box-shadow 0.2s ease;
- cursor: pointer;
- color: inherit;
- text-decoration: none;
- }
-
- .project-card:hover {
- transform: translateY(-3px);
- border-color: #3a3a40;
- box-shadow: 0 8px 28px rgba(0, 0, 0, 0.35);
- }
-
- .card-preview {
- aspect-ratio: 16 / 9;
- background: var(--darker);
- position: relative;
- overflow: hidden;
- display: flex;
- align-items: center;
- justify-content: center;
- border-bottom: 1px solid var(--border);
- }
-
- .card-preview img {
- width: 100%;
- height: 100%;
- object-fit: contain;
- background: var(--darker);
- }
-
- .card-preview .placeholder {
- font-size: 2.5rem;
- opacity: 0.25;
- color: var(--text-muted);
- }
-
- .card-badge {
- position: absolute;
- top: 12px;
- right: 12px;
- background: var(--primary);
- color: white;
- padding: 3px 10px;
- border-radius: 6px;
- font-size: 0.7rem;
- font-weight: 600;
- letter-spacing: 0.04em;
- text-transform: uppercase;
- }
-
- .card-content {
- padding: 18px 20px 20px;
- }
-
- .card-title {
- font-size: 1.05rem;
- font-weight: 600;
- margin-bottom: 10px;
- color: var(--text);
- line-height: 1.35;
- letter-spacing: -0.01em;
- }
-
- .card-meta {
- display: flex;
- gap: 14px;
- margin-bottom: 10px;
- font-size: 0.8rem;
- color: var(--text-muted);
- }
-
- .card-meta span {
- display: flex;
- align-items: center;
- gap: 5px;
- }
-
- .card-desc {
- font-size: 0.875rem;
- color: var(--text-muted);
- line-height: 1.55;
- display: -webkit-box;
- -webkit-line-clamp: 2;
- -webkit-box-orient: vertical;
- overflow: hidden;
- }
-
- .card-tags {
- display: flex;
- flex-wrap: wrap;
- gap: 6px;
- margin-top: 14px;
- }
-
- .tag {
- background: transparent;
- padding: 3px 9px;
- border-radius: 6px;
- border: 1px solid var(--border);
- font-size: 0.72rem;
- color: var(--text-muted);
- letter-spacing: -0.005em;
- }
-
- .tag.style-consulting,
- .tag.style-general,
- .tag.style-creative,
- .tag.style-editorial {
- background: rgba(91, 141, 239, 0.08);
- color: var(--primary-light);
- border-color: rgba(91, 141, 239, 0.22);
- }
-
- /* Footer */
- .footer {
- background: var(--darker);
- border-top: 1px solid var(--border);
- padding: 48px 20px 40px;
- text-align: center;
- }
-
- .footer-links {
- display: flex;
- justify-content: center;
- gap: 28px;
- margin-bottom: 24px;
- flex-wrap: wrap;
- }
-
- .footer-links a {
- color: var(--text-muted);
- text-decoration: none;
- font-size: 0.9rem;
- transition: color 0.18s ease;
- }
-
- .footer-links a:hover {
- color: var(--text);
- }
-
- .footer-copy {
- color: var(--text-muted);
- font-size: 0.85rem;
- }
-
- .footer-copy a {
- color: var(--text);
- text-decoration: none;
- border-bottom: 1px solid var(--border);
- transition: border-color 0.18s ease;
- }
-
- .footer-copy a:hover {
- border-color: var(--text-muted);
- }
-
- /* Responsive */
- @media (max-width: 768px) {
- .header {
- padding: 80px 20px 60px;
- }
-
- .header h1 {
- font-size: 2.25rem;
- }
-
- .header p {
- font-size: 1rem;
- }
-
- .header-cta {
- flex-direction: column;
- align-items: stretch;
- width: 100%;
- max-width: 280px;
- margin-left: auto;
- margin-right: auto;
- }
-
- .stats {
- margin-top: 36px;
- flex-wrap: nowrap;
- }
-
- .stat {
- padding: 14px 18px;
- }
-
- .stat-value {
- font-size: 1.4rem;
- }
-
- .projects-grid {
- grid-template-columns: 1fr;
- }
- }
-
- /* Hidden class for filtering */
- .hidden {
- display: none !important;
- }
- </style>
+ <meta charset="utf-8">
+ <meta name="viewport" content="width=device-width, initial-scale=1">
+ <meta http-equiv="refresh" content="0; url=https://hugohe3.github.io/ppt-master-examples/">
+ <link rel="canonical" href="https://hugohe3.github.io/ppt-master-examples/">
+ <title>PPT Master Examples</title>
+ <style>body { margin: 3rem; font: 1rem/1.5 system-ui, sans-serif; }</style>
</head>
-
<body>
- <header class="header">
- <div class="header-content">
- <div class="logo" aria-hidden="true">
- <svg viewBox="0 0 48 32" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
- <rect x="2" y="2" width="44" height="28" rx="2.5"/>
- <line x1="9" y1="11" x2="22" y2="11"/>
- <line x1="9" y1="17" x2="32" y2="17"/>
- <line x1="9" y1="23" x2="26" y2="23"/>
- </svg>
- </div>
- <div class="eyebrow">Open source · MIT</div>
- <h1>PPT Master</h1>
- <p>AI generates natively editable PPTX from any document — real PowerPoint shapes, not images.</p>
- <div class="header-cta">
- <a href="https://github.com/hugohe3/ppt-master" class="cta-btn primary" target="_blank">Star on GitHub</a>
- <a href="https://github.com/hugohe3/ppt-master#quick-start" class="cta-btn secondary" target="_blank">Get Started</a>
- </div>
- <div class="stats">
- <div class="stat">
- <div class="stat-value" id="examples-count">...</div>
- <div class="stat-label">Examples</div>
- </div>
- <div class="stat">
- <div class="stat-value" id="pages-count">...</div>
- <div class="stat-label">Pages</div>
- </div>
- <div class="stat">
- <div class="stat-value" id="templates-count">...</div>
- <div class="stat-label">Templates</div>
- </div>
- </div>
- </div>
- </header>
-
- <nav class="nav">
- <div class="nav-content">
- <button class="nav-btn active" data-filter="all">All</button>
- <button class="nav-btn" data-filter="consulting">Consulting</button>
- <button class="nav-btn" data-filter="general">General</button>
- <button class="nav-btn" data-filter="creative">Creative</button>
- <button class="nav-btn" data-filter="editorial">Editorial</button>
- </div>
- </nav>
-
- <main class="main">
- <div class="projects-grid" id="projects-grid">
- <!-- Projects will be inserted here by JavaScript -->
- </div>
- </main>
-
- <footer class="footer">
- <div class="footer-links">
- <a href="https://github.com/hugohe3/ppt-master" target="_blank">GitHub</a>
- <a href="https://github.com/hugohe3/ppt-master#quick-start" target="_blank">Quick Start</a>
- <a href="https://github.com/hugohe3/ppt-master/blob/main/docs/faq.md" target="_blank">FAQ</a>
- <a href="https://github.com/hugohe3/ppt-master/discussions" target="_blank">Discussions</a>
- </div>
- <p class="footer-copy">PPT Master © 2025–2026 · Built by <a href="https://www.hehugo.com/" target="_blank">Hugo He</a></p>
- </footer>
-
- <script>
- const EXAMPLES_DATA_URL = 'examples/examples.json';
- let projects = [];
- let activeFilter = 'all';
-
- async function initProjects() {
- try {
- const data = await loadExamplesData();
- projects = data.projects || [];
- updateStats(data.stats);
- renderProjects(activeFilter);
- } catch (error) {
- showLoadError(error);
- }
- }
-
- async function loadExamplesData() {
- const response = await fetch(EXAMPLES_DATA_URL, { cache: 'no-cache' });
- if (!response.ok) {
- throw new Error(`Failed to load ${EXAMPLES_DATA_URL}: ${response.status}`);
- }
- return response.json();
- }
-
- function updateStats(stats = {}) {
- document.getElementById('examples-count').textContent = stats.examples ?? projects.length;
- document.getElementById('pages-count').textContent = stats.pages ?? projects.reduce((sum, project) => sum + (project.slides?.length || 0), 0);
- document.getElementById('templates-count').textContent = stats.templates ?? '...';
- }
-
- function showLoadError(error) {
- console.error(error);
- const grid = document.getElementById('projects-grid');
- grid.innerHTML = '<div class="project-card"><div class="card-content"><h3 class="card-title">Unable to load examples</h3><p class="card-desc">Start a local web server or check examples/examples.json.</p></div></div>';
- }
-
- // Render projects
- function renderProjects(filter = 'all') {
- const grid = document.getElementById('projects-grid');
- grid.innerHTML = '';
-
- const filtered = filter === 'all'
- ? projects
- : projects.filter(p => p.style === filter);
-
- filtered.forEach(project => {
- const card = document.createElement('a');
- card.className = 'project-card';
- card.href = `viewer.html?project=${encodeURIComponent(project.id)}`;
-
- const styleClass = `style-${project.style || 'general'}`;
- const tags = project.tags || [];
- const pages = project.slides?.length || 0;
- const cover = project.cover || project.slides?.[0]?.file || '';
- const folder = project.folder || `${project.id}/svg_final`;
- const coverUrl = encodeURI(`examples/${folder}/${cover}`);
- const img = document.createElement('img');
- img.src = coverUrl;
- img.alt = project.title;
- img.onerror = function () {
- this.onerror = null;
- this.parentElement.innerHTML = '<div class="placeholder">—</div>';
- };
-
- card.innerHTML = `
- <div class="card-preview">
- ${project.isNew ? '<span class="card-badge new">New</span>' : ''}
- </div>
- <div class="card-content">
- <h3 class="card-title">${project.title}</h3>
- <div class="card-meta">
- <span>${pages} pages</span>
- <span>·</span>
- <span>${project.styleName}</span>
- </div>
- <p class="card-desc">${project.desc}</p>
- <div class="card-tags">
- <span class="tag ${styleClass}">${project.styleName}</span>
- ${tags.map(t => `<span class="tag">${t}</span>`).join('')}
- </div>
- </div>
- `;
-
- // Insert image into card-preview
- const preview = card.querySelector('.card-preview');
- preview.insertBefore(img, preview.firstChild);
-
- grid.appendChild(card);
- });
- }
-
- // Filter buttons
- document.querySelectorAll('.nav-btn').forEach(btn => {
- btn.addEventListener('click', () => {
- document.querySelectorAll('.nav-btn').forEach(b => b.classList.remove('active'));
- btn.classList.add('active');
- activeFilter = btn.dataset.filter;
- renderProjects(activeFilter);
- });
- });
-
- // Initial render
- initProjects();
- </script>
+ <p>Examples have moved to <a href="https://hugohe3.github.io/ppt-master-examples/">PPT Master Examples</a>.</p>
</body>
-
</html>
diff --git a/projects/README.md b/projects/README.md
index e893fd91..056a676f 100644
--- a/projects/README.md
+++ b/projects/README.md
@@ -46,5 +46,5 @@ Projects can remain at different stages and do not necessarily have all artifact
- Contents under this directory are excluded by `.gitignore`
- `svg_final/` may be opened directly or inserted manually as an SVG image; PowerPoint's manual Convert to Shape behavior is not supported
-- Completed projects can be moved to the `examples/` directory for sharing
+- Completed projects can be published through the [PPT Master examples repository](https://github.com/hugohe3/ppt-master-examples)
- Files outside the workspace are copied by default; files within the workspace are moved directly to the project's `sources/`
diff --git a/skills/ppt-master/scripts/batch_validate.py b/skills/ppt-master/scripts/batch_validate.py
index 0981fe57..72f65b8a 100644
--- a/skills/ppt-master/scripts/batch_validate.py
+++ b/skills/ppt-master/scripts/batch_validate.py
@@ -5,10 +5,8 @@ PPT Master - Batch Project Validation Tool
Checks the structural integrity and compliance of multiple projects at once.
Usage:
- python3 scripts/batch_validate.py examples
python3 scripts/batch_validate.py projects
python3 scripts/batch_validate.py --all
- python3 scripts/batch_validate.py examples projects
"""
import argparse
@@ -265,14 +263,12 @@ def build_parser() -> argparse.ArgumentParser:
description="Validate one or more PPT Master project directories.",
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog="""Examples:
- python3 scripts/batch_validate.py examples
python3 scripts/batch_validate.py projects
- python3 scripts/batch_validate.py examples projects
python3 scripts/batch_validate.py --all
""",
)
parser.add_argument("directories", nargs="*", help="Directories to scan")
- parser.add_argument("--all", action="store_true", help="Validate examples and projects")
+ parser.add_argument("--all", action="store_true", help="Validate the default projects directory")
parser.add_argument("--export", action="store_true", help="Write a validation report")
parser.add_argument(
"--output",
@@ -290,7 +286,7 @@ def main(argv: list[str] | None = None) -> int:
validator = BatchValidator()
if args.all:
- directories = ['examples', 'projects']
+ directories = ['projects']
else:
directories = args.directories
diff --git a/skills/ppt-master/scripts/config.py b/skills/ppt-master/scripts/config.py
index 04820712..61ebd910 100644
--- a/skills/ppt-master/scripts/config.py
+++ b/skills/ppt-master/scripts/config.py
@@ -40,7 +40,6 @@ WORKFLOWS_DIR = PROJECT_ROOT / 'workflows'
# Repository root directory
REPO_ROOT = PROJECT_ROOT.parent.parent
-EXAMPLES_DIR = REPO_ROOT / 'examples'
PROJECTS_DIR = REPO_ROOT / 'projects'
# Template subdirectories
diff --git a/skills/ppt-master/scripts/docs/project.md b/skills/ppt-master/scripts/docs/project.md
index e04ea7bc..ddd91105 100644
--- a/skills/ppt-master/scripts/docs/project.md
+++ b/skills/ppt-master/scripts/docs/project.md
@@ -216,21 +216,20 @@ python3 scripts/project_utils.py <project_path>
Batch-check project structure and compliance.
```bash
-python3 scripts/batch_validate.py examples
-python3 scripts/batch_validate.py examples projects
+python3 scripts/batch_validate.py projects
python3 scripts/batch_validate.py --all
-python3 scripts/batch_validate.py examples --export
+python3 scripts/batch_validate.py projects --export
```
-Use this for repository-wide health checks before release or cleanup.
+Use this for multi-project health checks before release or cleanup.
## `generate_examples_index.py`
-Rebuild `examples/README.md` automatically.
+Rebuild the examples `README.md` index. The example projects live in the separate
+[ppt-master-examples](https://github.com/hugohe3/ppt-master-examples) repository.
```bash
-python3 scripts/generate_examples_index.py
-python3 scripts/generate_examples_index.py examples
+python3 scripts/generate_examples_index.py <path-to>/ppt-master-examples/examples
```
## `pptx_template_import.py`
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index 301fe117..03ef7533 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -729,14 +729,14 @@ Requirements:
Validate SVG technical compliance.
```bash
-python3 scripts/svg_quality_checker.py examples/project/svg_output/01_cover.svg
-python3 scripts/svg_quality_checker.py examples/project/svg_output
-python3 scripts/svg_quality_checker.py examples/project
-python3 scripts/svg_quality_checker.py examples/project --stage first-page
-python3 scripts/svg_quality_checker.py examples/project --stage final --json
-python3 scripts/svg_quality_checker.py examples/project --format ppt169
-python3 scripts/svg_quality_checker.py --all examples
-python3 scripts/svg_quality_checker.py examples/project --export
+python3 scripts/svg_quality_checker.py projects/project/svg_output/01_cover.svg
+python3 scripts/svg_quality_checker.py projects/project/svg_output
+python3 scripts/svg_quality_checker.py projects/project
+python3 scripts/svg_quality_checker.py projects/project --stage first-page
+python3 scripts/svg_quality_checker.py projects/project --stage final --json
+python3 scripts/svg_quality_checker.py projects/project --format ppt169
+python3 scripts/svg_quality_checker.py --all projects
+python3 scripts/svg_quality_checker.py projects/project --export
python3 scripts/svg_quality_checker.py path/to/template/templates --template-mode
```
@@ -806,7 +806,7 @@ Use this after SVG generation to inspect existing SVG geometry when manual compa
### `flatten_tspan.py`
```bash
-python3 scripts/svg_finalize/flatten_tspan.py examples/<project>/svg_output
+python3 scripts/svg_finalize/flatten_tspan.py projects/<project>/svg_output
python3 scripts/svg_finalize/flatten_tspan.py path/to/input.svg path/to/output.svg
```
diff --git a/skills/ppt-master/scripts/finalize_svg.py b/skills/ppt-master/scripts/finalize_svg.py
index 7156a5bc..0680cf23 100644
--- a/skills/ppt-master/scripts/finalize_svg.py
+++ b/skills/ppt-master/scripts/finalize_svg.py
@@ -24,7 +24,7 @@ Usage:
Examples:
python3 scripts/finalize_svg.py projects/my_project
- python3 scripts/finalize_svg.py examples/ppt169_demo --only embed-icons
+ python3 scripts/finalize_svg.py projects/ppt169_demo --only embed-icons
Processing options:
embed-icons - Expand project icons and static same-document <use>
diff --git a/skills/ppt-master/scripts/generate_examples_index.py b/skills/ppt-master/scripts/generate_examples_index.py
index 9a41ab84..e25cb225 100644
--- a/skills/ppt-master/scripts/generate_examples_index.py
+++ b/skills/ppt-master/scripts/generate_examples_index.py
@@ -5,8 +5,10 @@ PPT Master - Examples Index Generator
Automatically scans the examples directory and generates a README.md index file.
Usage:
- python3 scripts/generate_examples_index.py
- python3 scripts/generate_examples_index.py examples
+ python3 scripts/generate_examples_index.py <examples_dir>
+
+The example projects live in the separate ppt-master-examples repository;
+pass the path to its examples/ directory.
"""
import argparse
@@ -220,9 +222,7 @@ def build_parser() -> argparse.ArgumentParser:
)
parser.add_argument(
"examples_dir",
- nargs="?",
- default="examples",
- help="Examples directory (default: examples)",
+ help="Path to the examples/ directory of the ppt-master-examples repository",
)
return parser
diff --git a/skills/ppt-master/scripts/svg_finalize/embed_images.py b/skills/ppt-master/scripts/svg_finalize/embed_images.py
index 482faa86..0a64fc87 100644
--- a/skills/ppt-master/scripts/svg_finalize/embed_images.py
+++ b/skills/ppt-master/scripts/svg_finalize/embed_images.py
@@ -8,8 +8,8 @@ Usage:
python3 scripts/svg_finalize/embed_images.py *.svg
Examples:
- python3 scripts/svg_finalize/embed_images.py examples/ppt169_demo/svg_output/01_cover.svg
- python3 scripts/svg_finalize/embed_images.py examples/ppt169_demo/svg_output/*.svg
+ python3 scripts/svg_finalize/embed_images.py projects/ppt169_demo/svg_output/01_cover.svg
+ python3 scripts/svg_finalize/embed_images.py projects/ppt169_demo/svg_output/*.svg
"""
import os
diff --git a/skills/ppt-master/scripts/svg_finalize/svg_rect_to_path.py b/skills/ppt-master/scripts/svg_finalize/svg_rect_to_path.py
index b793bac9..ffb797c1 100644
--- a/skills/ppt-master/scripts/svg_finalize/svg_rect_to_path.py
+++ b/skills/ppt-master/scripts/svg_finalize/svg_rect_to_path.py
@@ -12,8 +12,8 @@ Usage:
python3 scripts/svg_finalize/svg_rect_to_path.py <project_path> -s final -o svg_rounded
Examples:
- python3 scripts/svg_finalize/svg_rect_to_path.py examples/ppt169_demo
- python3 scripts/svg_finalize/svg_rect_to_path.py examples/ppt169_demo/svg_output/01_cover.svg
+ python3 scripts/svg_finalize/svg_rect_to_path.py projects/ppt169_demo
+ python3 scripts/svg_finalize/svg_rect_to_path.py projects/ppt169_demo/svg_output/01_cover.svg
Output:
- Directory mode: outputs to svg_rounded/ subdirectory
@@ -240,9 +240,9 @@ def main() -> None:
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog='''
Examples:
- %(prog)s examples/ppt169_demo
- %(prog)s examples/ppt169_demo -s final
- %(prog)s examples/ppt169_demo/svg_output/01_cover.svg
+ %(prog)s projects/ppt169_demo
+ %(prog)s projects/ppt169_demo -s final
+ %(prog)s projects/ppt169_demo/svg_output/01_cover.svg
What it does:
Converts <rect> elements with rx/ry to equivalent <path> elements.
diff --git a/skills/ppt-master/scripts/svg_quality/cli.py b/skills/ppt-master/scripts/svg_quality/cli.py
index 374ece6a..6326c1cf 100644
--- a/skills/ppt-master/scripts/svg_quality/cli.py
+++ b/skills/ppt-master/scripts/svg_quality/cli.py
@@ -61,11 +61,11 @@ def print_usage() -> None:
print(" python3 scripts/svg_quality_checker.py <svg_file>")
print(" python3 scripts/svg_quality_checker.py <directory>")
print(" python3 scripts/svg_quality_checker.py <workspace>/templates --template-mode")
- print(" python3 scripts/svg_quality_checker.py --all examples")
+ print(" python3 scripts/svg_quality_checker.py --all projects")
print("\nExamples:")
- print(" python3 scripts/svg_quality_checker.py examples/project/svg_output/slide_01.svg")
- print(" python3 scripts/svg_quality_checker.py examples/project/svg_output")
- print(" python3 scripts/svg_quality_checker.py examples/project")
+ print(" python3 scripts/svg_quality_checker.py projects/project/svg_output/slide_01.svg")
+ print(" python3 scripts/svg_quality_checker.py projects/project/svg_output")
+ print(" python3 scripts/svg_quality_checker.py projects/project")
print(" python3 scripts/svg_quality_checker.py templates/layouts/presentation_core/templates --template-mode")
print(" python3 scripts/svg_quality_checker.py templates/decks/中国电信/templates --template-mode")
print("\nOptions:")
@@ -142,7 +142,7 @@ def main() -> None:
if stage != "final":
print("[ERROR] --stage first-page does not support --all")
sys.exit(1)
- base_dir = sys.argv[2] if len(sys.argv) > 2 else "examples"
+ base_dir = sys.argv[2] if len(sys.argv) > 2 else "projects"
from project_utils import find_all_projects
projects = find_all_projects(base_dir)
diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.py
index 60133912..0c7c4001 100644
--- a/skills/ppt-master/scripts/svg_quality_checker.py
+++ b/skills/ppt-master/scripts/svg_quality_checker.py
@@ -7,7 +7,7 @@ Implementation lives in ``svg_quality/``.
Usage:
python3 scripts/svg_quality_checker.py <svg_file>
python3 scripts/svg_quality_checker.py <directory>
- python3 scripts/svg_quality_checker.py --all examples
+ python3 scripts/svg_quality_checker.py --all projects
Examples:
python3 scripts/svg_quality_checker.py projects/demo --stage final --json
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
index aaeb7b8b..cb1824f1 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
@@ -817,13 +817,13 @@ def main(argv: list[str] | None = None) -> int:
formatter_class=argparse.RawDescriptionHelpFormatter,
epilog=f'''
Examples:
- %(prog)s examples/ppt169_demo # Default: native pptx -> exports/, svg_output -> backup/<ts>/
- %(prog)s examples/ppt169_demo -o out.pptx # Explicit path (no backup/)
+ %(prog)s projects/ppt169_demo # Default: native pptx -> exports/, svg_output -> backup/<ts>/
+ %(prog)s projects/ppt169_demo -o out.pptx # Explicit path (no backup/)
%(prog)s projects/quick_generate_demo --quick-generate # Lockless flat export with normal postflight
# Disable transition / change transition effect
- %(prog)s examples/ppt169_demo -t none
- %(prog)s examples/ppt169_demo -t push --transition-duration 1.0
+ %(prog)s projects/ppt169_demo -t none
+ %(prog)s projects/ppt169_demo -t push --transition-duration 1.0
SVG source directory (-s):
output - svg_output (hand-authored source; native default)
@@ -870,7 +870,7 @@ Speaker notes:
- Disabled by default in Quick Generate; use --with-notes to enable
Recorded narration:
- %(prog)s examples/ppt169_demo --recorded-narration audio \\
+ %(prog)s projects/ppt169_demo --recorded-narration audio \\
--inherit-motion-from validation/<base>.report.json
- Keeps speaker notes when enabled
- Prepares PowerPoint recorded timings and narrations
@@ -884,7 +884,7 @@ Recorded narration:
- Sets slide auto-advance from audio duration so video export can use
"recorded timings and narrations"
- Rejects on-click object animations; use after-previous or with-previous
- %(prog)s examples/ppt169_demo --narration-audio-dir audio
+ %(prog)s projects/ppt169_demo --narration-audio-dir audio
- Lower-level audio embedding: embeds matched files but allows partial matches
- Use only when you do not need a complete recorded-timings export
''',
diff --git a/viewer.html b/viewer.html
deleted file mode 100644
index 1a15d2e9..00000000
--- a/viewer.html
+++ /dev/null
@@ -1,930 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
- <meta charset="UTF-8">
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
- <meta name="description" content="PPT Master Slide Gallery — Browse and view SVG presentation slides across various topics">
- <meta name="keywords" content="slides, SVG, presentation, PPT, PowerPoint">
- <meta property="og:title" content="Slide Gallery — PPT Master">
- <meta property="og:description" content="Browse example presentations — AI-generated, natively editable PowerPoint from any document.">
- <meta property="og:url" content="https://hugohe3.github.io/ppt-master/viewer.html">
- <meta property="og:type" content="website">
- <title>Slide Gallery — PPT Master</title>
-
- <!-- Tailwind CSS -->
- <script src="https://cdn.tailwindcss.com"></script>
- <script>
- tailwind.config = {
- theme: {
- extend: {
- colors: {
- brand: {
- 50: '#eef3ff',
- 100: '#dde7ff',
- 200: '#c0d2ff',
- 300: '#9bb6ff',
- 400: '#7da0ff',
- 500: '#5b8def',
- 600: '#4a7be0',
- 700: '#3b65c2',
- 800: '#2f4f99',
- 900: '#243d75',
- }
- },
- fontFamily: {
- sans: ['Inter', 'system-ui', '-apple-system', 'PingFang SC', 'Microsoft YaHei', 'sans-serif'],
- }
- }
- }
- }
- </script>
-
- <!-- Fonts & Icons -->
- <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
-
- <!-- Favicon -->
- <link rel="icon"
- href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 48 32' fill='none' stroke='%235b8def' stroke-width='3' stroke-linecap='round' stroke-linejoin='round'><rect x='2' y='2' width='44' height='28' rx='2.5'/><line x1='9' y1='11' x2='22' y2='11'/><line x1='9' y1='17' x2='32' y2='17'/><line x1='9' y1='23' x2='26' y2='23'/></svg>">
-
- <style>
- :root {
- --primary: #5b8def;
- --primary-light: #88aaff;
- --darker: #0d0d0f;
- --surface: #16161a;
- --surface-hover: #1d1d20;
- --border: #26262a;
- --text: #e6e6e9;
- --text-muted: #8a8a93;
- }
-
- body {
- font-family: 'Inter', system-ui, -apple-system, 'PingFang SC', 'Microsoft YaHei', sans-serif;
- background: var(--darker);
- color: var(--text);
- min-height: 100vh;
- -webkit-font-smoothing: antialiased;
- -moz-osx-font-smoothing: grayscale;
- }
-
- /* Subtle ambient glow at the top of the page */
- body::before {
- content: '';
- position: fixed;
- top: -300px;
- left: 50%;
- transform: translateX(-50%);
- width: 1200px;
- height: 700px;
- background: radial-gradient(circle, rgba(91, 141, 239, 0.08) 0%, transparent 60%);
- pointer-events: none;
- z-index: 0;
- }
-
- .glass {
- background: var(--surface);
- border: 1px solid var(--border);
- backdrop-filter: blur(10px);
- }
-
- /* Override Tailwind utility colors for dark theme */
- .text-gray-800,
- .text-gray-700 { color: var(--text) !important; }
- .text-gray-600,
- .text-gray-500,
- .text-gray-400 { color: var(--text-muted) !important; }
- .bg-white { background: var(--surface) !important; }
- .bg-gray-50 { background: var(--surface-hover) !important; }
- .bg-gray-100 { background: var(--surface) !important; }
- .border-gray-200,
- .border-gray-100 { border-color: var(--border) !important; }
- .hover\:bg-gray-50:hover { background: var(--surface-hover) !important; }
- .bg-brand-50 { background: rgba(91, 141, 239, 0.08) !important; }
- .drop-shadow-lg,
- .drop-shadow { filter: none !important; }
-
- kbd {
- background: var(--surface) !important;
- color: var(--text-muted) !important;
- border: 1px solid var(--border) !important;
- }
-
- .collection-card {
- display: block;
- transition: transform 0.2s ease, border-color 0.2s ease, box-shadow 0.2s ease;
- cursor: pointer;
- border: 1px solid var(--border);
- color: inherit;
- text-decoration: none;
- }
-
- .collection-card:hover {
- transform: translateY(-3px);
- border-color: #3a3a40;
- box-shadow: 0 8px 28px rgba(0, 0, 0, 0.4);
- }
-
- .slide-container {
- box-shadow: 0 12px 32px rgba(0, 0, 0, 0.4);
- transition: transform 0.3s ease;
- }
-
- .thumbnail {
- transition: transform 0.18s ease, box-shadow 0.18s ease;
- cursor: pointer;
- }
-
- .thumbnail:hover {
- transform: scale(1.04);
- box-shadow: 0 4px 12px rgba(0, 0, 0, 0.4);
- }
-
- .nav-btn {
- transition: transform 0.18s ease, background 0.18s ease, color 0.18s ease, border-color 0.18s ease;
- }
-
- .nav-btn:hover:not(:disabled) {
- transform: scale(1.06);
- }
-
- .nav-btn:disabled {
- opacity: 0.4;
- cursor: not-allowed;
- }
-
- /* Custom Scrollbar */
- ::-webkit-scrollbar {
- width: 6px;
- height: 6px;
- }
-
- ::-webkit-scrollbar-track {
- background: var(--darker);
- border-radius: 3px;
- }
-
- ::-webkit-scrollbar-thumb {
- background: var(--border);
- border-radius: 3px;
- }
-
- ::-webkit-scrollbar-thumb:hover {
- background: #3a3a40;
- }
-
- .fade-in {
- animation: fadeIn 0.3s ease-out;
- }
-
- @keyframes fadeIn {
- from {
- opacity: 0;
- transform: scale(0.98);
- }
-
- to {
- opacity: 1;
- transform: scale(1);
- }
- }
-
- .slide-enter {
- animation: slideEnter 0.4s ease-out;
- }
-
- @keyframes slideEnter {
- from {
- opacity: 0;
- transform: translateY(20px);
- }
-
- to {
- opacity: 1;
- transform: translateY(0);
- }
- }
-
- /* Fullscreen styles */
- .fullscreen-overlay {
- position: fixed;
- top: 0;
- left: 0;
- width: 100vw;
- height: 100vh;
- background: rgba(0, 0, 0, 0.95);
- z-index: 1000;
- display: flex;
- align-items: center;
- justify-content: center;
- }
-
- .fullscreen-overlay.hidden {
- display: none;
- }
-
- .fullscreen-overlay object,
- .fullscreen-overlay img {
- width: 95vw;
- height: 90vh;
- max-width: 95vw;
- max-height: 90vh;
- object-fit: contain;
- }
-
- .progress-bar {
- height: 4px;
- transition: width 0.3s ease;
- }
-
- .dropdown-menu {
- max-height: min(70vh, 560px);
- overflow-x: hidden;
- overflow-y: auto;
- overscroll-behavior: contain;
- }
-
- /* Expanded view for slide viewer */
- .viewer-expanded {
- max-width: 95vw !important;
- }
-
- /* Theater mode - hide sidebar */
- .theater-mode .sidebar-panel {
- display: none;
- }
-
- .theater-mode .main-slide-area {
- flex: 1;
- max-width: 100%;
- }
-
- .theater-mode .slide-container object {
- max-height: 75vh;
- width: auto;
- margin: 0 auto;
- }
-
- /* Better slide sizing for large screens */
- @media (min-width: 1920px) {
- .viewer-expanded {
- max-width: 90vw !important;
- }
-
- .slide-container object {
- max-height: 70vh;
- }
- }
-
- @media (min-width: 2560px) {
- .viewer-expanded {
- max-width: 85vw !important;
- }
- }
-
- /* View mode toggle button */
- .view-mode-btn {
- transition: background 0.18s ease, color 0.18s ease;
- }
-
- .view-mode-btn.active {
- background: var(--primary);
- color: #fff;
- }
-
- /* SVG object styling */
- .slide-container object {
- width: 100%;
- height: auto;
- min-height: 400px;
- }
- </style>
-</head>
-
-<body class="antialiased">
- <!-- Header -->
- <header class="glass shadow-lg sticky top-0 z-50">
- <div class="max-w-7xl mx-auto px-4 py-4">
- <div class="flex items-center justify-between">
- <div class="flex items-center space-x-4">
- <a href="index.html" class="text-gray-600 hover:text-brand-600 transition-colors">
- <i class="fas fa-arrow-left"></i>
- <span class="ml-2">Back to Projects</span>
- </a>
- </div>
-
- <!-- Collection Selector (shown when viewing slides) -->
- <div id="collectionSelector" class="hidden relative">
- <button onclick="toggleDropdown()"
- class="flex items-center space-x-2 px-4 py-2 bg-white rounded-lg shadow border border-gray-200 hover:border-brand-400 transition-colors">
- <span id="currentCollectionIcon" class="text-xl">🎴</span>
- <span id="currentCollectionName" class="font-medium text-gray-700">Select Collection</span>
- <i class="fas fa-chevron-down text-gray-400"></i>
- </button>
- <div id="dropdownMenu"
- class="dropdown-menu hidden absolute top-full left-0 mt-2 w-80 bg-white rounded-xl shadow-xl border border-gray-100 z-50">
- <!-- Dropdown items will be generated by JavaScript -->
- </div>
- </div>
-
- <div id="keyboardHints" class="hidden items-center space-x-2 text-sm">
- <!-- View Mode Toggle -->
- <div class="flex items-center space-x-1 mr-4 bg-gray-100 rounded-lg p-1">
- <button onclick="setViewMode('normal')" id="normalModeBtn"
- class="view-mode-btn px-3 py-1 rounded-md text-xs font-medium text-gray-600 hover:bg-white"
- title="Normal View">
- <i class="fas fa-columns"></i>
- </button>
- <button onclick="setViewMode('theater')" id="theaterModeBtn"
- class="view-mode-btn px-3 py-1 rounded-md text-xs font-medium text-gray-600 hover:bg-white"
- title="Theater Mode (T)">
- <i class="fas fa-tv"></i>
- </button>
- </div>
- <span class="text-gray-500">Shortcuts:</span>
- <kbd class="px-2 py-1 bg-gray-100 text-gray-600 text-xs rounded border">←</kbd>
- <kbd class="px-2 py-1 bg-gray-100 text-gray-600 text-xs rounded border">→</kbd>
- <span class="text-gray-500">Navigate</span>
- <kbd class="px-2 py-1 bg-gray-100 text-gray-600 text-xs rounded border ml-2">T</kbd>
- <span class="text-gray-500">Theater</span>
- <kbd class="px-2 py-1 bg-gray-100 text-gray-600 text-xs rounded border ml-2">F</kbd>
- <span class="text-gray-500">Fullscreen</span>
- <kbd class="px-2 py-1 bg-gray-100 text-gray-600 text-xs rounded border ml-2">ESC</kbd>
- <span class="text-gray-500">Back</span>
- </div>
- </div>
- </div>
- <!-- Progress bar -->
- <div id="progressBar" class="progress-bar bg-brand-500" style="width: 0%"></div>
- </header>
-
- <!-- Main Content -->
- <main id="mainContent" class="max-w-7xl mx-auto px-4 py-8 transition-all duration-300">
- <!-- Library View (Collection Selection) -->
- <div id="libraryView">
- <div class="text-center mb-12 pt-6">
- <h1 class="text-4xl font-bold mb-3" style="color: var(--text); letter-spacing: -0.025em;">
- Slide Gallery
- </h1>
- <p style="color: var(--text-muted);" class="text-lg">
- Select a collection to start browsing
- </p>
- </div>
-
- <!-- Collection Cards Grid -->
- <div id="collectionsGrid" class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">
- <!-- Cards will be generated by JavaScript -->
- </div>
-
- <!-- Empty State -->
- <div id="emptyState" class="hidden text-center py-20">
- <h3 class="text-xl font-medium" style="color: var(--text);">No slide collections found</h3>
- <p style="color: var(--text-muted);" class="mt-2">Please add slide configurations</p>
- </div>
- </div>
-
- <!-- Slide Viewer (Hidden by default) -->
- <div id="viewerView" class="hidden">
- <!-- Title Section -->
- <div class="text-center mb-8 slide-enter">
- <button onclick="backToLibrary()"
- class="inline-flex items-center px-4 py-2 mb-4 transition-colors"
- style="color: var(--text-muted);"
- onmouseover="this.style.color='var(--text)'"
- onmouseout="this.style.color='var(--text-muted)'">
- <i class="fas fa-th-large mr-2"></i>
- Back to Gallery
- </button>
- <h1 id="viewerTitle" class="text-3xl font-bold mb-2" style="color: var(--text); letter-spacing: -0.02em;">
- Slide Title
- </h1>
- <p id="viewerDescription" style="color: var(--text-muted);">
- Slide Description
- </p>
- </div>
-
- <!-- Slide Viewer -->
- <div id="slideViewerContainer" class="flex flex-col lg:flex-row gap-6 slide-enter">
- <!-- Main Slide -->
- <div class="main-slide-area flex-1">
- <div class="glass rounded-2xl p-4 slide-container">
- <object id="mainSlide" data="" type="image/svg+xml"
- class="w-full rounded-lg fade-in cursor-pointer" onclick="toggleFullscreen()">
- <p class="text-center text-gray-500 py-10">Loading SVG...</p>
- </object>
- </div>
-
- <!-- Navigation Controls -->
- <div class="flex items-center justify-center mt-6 space-x-4">
- <button id="prevBtn" onclick="prevSlide()"
- class="nav-btn w-12 h-12 rounded-full glass shadow-md flex items-center justify-center text-gray-600 border border-gray-200 hover:bg-brand-500 hover:text-white hover:border-brand-500">
- <i class="fas fa-chevron-left"></i>
- </button>
-
- <div class="flex items-center space-x-2 px-6 py-2 glass rounded-full shadow-md">
- <span id="currentPage" class="text-brand-600 font-bold">1</span>
- <span class="text-gray-400">/</span>
- <span id="totalPages" class="text-gray-600">1</span>
- </div>
-
- <button id="nextBtn" onclick="nextSlide()"
- class="nav-btn w-12 h-12 rounded-full glass shadow-md flex items-center justify-center text-gray-600 border border-gray-200 hover:bg-brand-500 hover:text-white hover:border-brand-500">
- <i class="fas fa-chevron-right"></i>
- </button>
-
- <button onclick="toggleFullscreen()"
- class="nav-btn w-12 h-12 rounded-full glass shadow-md flex items-center justify-center text-gray-600 border border-gray-200 hover:bg-brand-500 hover:text-white hover:border-brand-500 ml-4">
- <i class="fas fa-expand"></i>
- </button>
- </div>
- </div>
-
- <!-- Thumbnail Sidebar -->
- <div class="sidebar-panel lg:w-64 xl:w-72">
- <div class="glass rounded-2xl p-4 shadow-lg">
- <h3 class="text-sm font-semibold text-gray-600 mb-3 flex items-center">
- <i class="fas fa-th-large mr-2 text-brand-600"></i>
- Slide Index
- </h3>
- <div id="thumbnailContainer" class="space-y-3 max-h-[60vh] overflow-y-auto pr-2">
- <!-- Thumbnails will be generated by JavaScript -->
- </div>
- </div>
-
- <!-- Slide Info -->
- <div class="glass rounded-2xl p-4 shadow-lg mt-4">
- <h3 class="text-sm font-semibold text-gray-600 mb-3 flex items-center">
- <i class="fas fa-info-circle mr-2 text-brand-600"></i>
- Current Slide
- </h3>
- <p id="slideTitle" class="text-gray-800 font-medium">Title</p>
- <p id="slideDesc" class="text-sm text-gray-500 mt-1">Description</p>
- </div>
- </div>
- </div>
-
- <!-- Slide Overview -->
- <div class="mt-12 slide-enter">
- <h2 class="text-xl font-bold mb-6 flex items-center" style="color: var(--text); letter-spacing: -0.015em;">
- <i class="fas fa-list-ul mr-3" style="color: var(--text-muted);"></i>
- Overview
- </h2>
- <div id="overviewGrid" class="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-6 gap-4">
- <!-- Overview thumbnails will be generated by JavaScript -->
- </div>
- </div>
- </div>
- </main>
-
- <!-- Footer -->
- <footer class="mt-12 py-6" style="border-top: 1px solid var(--border);">
- <div class="max-w-7xl mx-auto px-4 text-center">
- <p class="text-sm" style="color: var(--text-muted);">
- PPT Master © 2025–2026 · Built by <a href="https://www.hehugo.com/" target="_blank" style="color: var(--text); text-decoration: none; border-bottom: 1px solid var(--border);">Hugo He</a>
- </p>
- </div>
- </footer>
-
- <!-- Fullscreen Overlay -->
- <div id="fullscreenOverlay" class="fullscreen-overlay hidden" onclick="toggleFullscreen()">
- <button class="absolute top-4 right-4 text-white text-2xl hover:text-gray-300 transition-colors">
- <i class="fas fa-times"></i>
- </button>
- <button onclick="event.stopPropagation(); prevSlide()"
- class="absolute left-4 top-1/2 -translate-y-1/2 w-12 h-12 rounded-full bg-white/20 hover:bg-white/30 flex items-center justify-center text-white transition-colors">
- <i class="fas fa-chevron-left"></i>
- </button>
- <object id="fullscreenImage" data="" type="image/svg+xml" class="fade-in">
- <p>Loading SVG...</p>
- </object>
- <button onclick="event.stopPropagation(); nextSlide()"
- class="absolute right-4 top-1/2 -translate-y-1/2 w-12 h-12 rounded-full bg-white/20 hover:bg-white/30 flex items-center justify-center text-white transition-colors">
- <i class="fas fa-chevron-right"></i>
- </button>
- <div class="absolute bottom-4 left-1/2 -translate-x-1/2 px-4 py-2 bg-black/50 rounded-full text-white text-sm">
- <span id="fullscreenPage">1</span> / <span id="fullscreenTotal">1</span>
- </div>
- </div>
-
- <script>
- const EXAMPLES_DATA_URL = 'examples/examples.json';
-
- // State
- let collections = [];
- let currentCollection = null;
- let currentSlide = 0;
- let isFullscreen = false;
- let dropdownOpen = false;
- let viewMode = 'normal';
-
- // Initialize
- document.addEventListener('DOMContentLoaded', initViewer);
-
- async function initViewer() {
- try {
- collections = await loadCollections();
- renderCollections();
-
- // Check URL for collection parameter
- const urlParams = new URLSearchParams(window.location.search);
- const collectionId = urlParams.get('project');
- if (collectionId) {
- const collection = collections.find(c => c.id === collectionId);
- if (collection) {
- openCollection(collection);
- }
- }
- } catch (error) {
- showLoadError(error);
- }
- }
-
- async function loadCollections() {
- const response = await fetch(EXAMPLES_DATA_URL, { cache: 'no-cache' });
- if (!response.ok) {
- throw new Error(`Failed to load ${EXAMPLES_DATA_URL}: ${response.status}`);
- }
- const data = await response.json();
- return (data.projects || []).map(project => ({
- ...project,
- slides: project.slides || [],
- cover: project.cover || project.slides?.[0]?.file || ''
- }));
- }
-
- function showLoadError(error) {
- console.error(error);
- document.getElementById('emptyState').classList.remove('hidden');
- document.querySelector('#emptyState h3').textContent = 'Unable to load slide collections';
- document.querySelector('#emptyState p').textContent = 'Start a local web server or check examples/examples.json.';
- }
-
- // Render collection cards
- function renderCollections() {
- const grid = document.getElementById('collectionsGrid');
-
- if (collections.length === 0) {
- document.getElementById('emptyState').classList.remove('hidden');
- return;
- }
-
- grid.innerHTML = collections.map(collection => {
- const cover = collection.cover || collection.slides[0]?.file || '';
- const coverPath = encodeURI(`examples/${collection.folder}/${cover}`);
- const collectionUrl = `viewer.html?project=${encodeURIComponent(collection.id)}`;
- return `
- <a href="${collectionUrl}" data-collection-id="${collection.id}" class="collection-card rounded-xl overflow-hidden" style="background: var(--surface);">
- <div class="relative" style="aspect-ratio: 16 / 9; background: var(--darker); border-bottom: 1px solid var(--border);">
- <object data="${coverPath}" type="image/svg+xml" class="w-full h-full object-contain" style="pointer-events:none">
- <div class="w-full h-full flex items-center justify-center text-3xl" style="opacity: 0.5;">${collection.icon}</div>
- </object>
- <div class="absolute bottom-3 right-3 px-2.5 py-1 rounded-md text-xs font-medium"
- style="background: rgba(13, 13, 15, 0.85); color: var(--text); border: 1px solid var(--border); backdrop-filter: blur(8px);">
- ${collection.slides.length} slides
- </div>
- </div>
- <div class="p-5" style="border-left: 3px solid ${collection.color};">
- <div class="flex items-center gap-2 mb-2">
- <span class="text-base">${collection.icon}</span>
- <h3 class="font-semibold text-base" style="color: var(--text); letter-spacing: -0.01em;">${collection.title}</h3>
- </div>
- <p class="text-sm line-clamp-2" style="color: var(--text-muted); line-height: 1.55;">${collection.description}</p>
- </div>
- </a>
- `}).join('');
-
- grid.querySelectorAll('.collection-card').forEach(card => {
- card.addEventListener('click', handleCollectionCardClick);
- });
-
- renderDropdown();
- }
-
- function handleCollectionCardClick(event) {
- if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
- return;
- }
-
- event.preventDefault();
- const collection = collections.find(item => item.id === event.currentTarget.dataset.collectionId);
- if (collection) {
- openCollection(collection);
- }
- }
-
- // Render dropdown menu
- function renderDropdown() {
- const dropdown = document.getElementById('dropdownMenu');
- dropdown.innerHTML = collections.map(collection => `
- <div class="flex items-center px-4 py-3 hover:bg-gray-50 cursor-pointer transition-colors ${currentCollection?.id === collection.id ? 'bg-brand-50' : ''}"
- onclick='switchCollection(${JSON.stringify(collection).replace(/'/g, "&#39;")})'>
- <span class="text-2xl mr-3">${collection.icon}</span>
- <div class="flex-1 min-w-0">
- <p class="font-medium text-gray-800 truncate">${collection.title}</p>
- <p class="text-xs text-gray-500">${collection.slides.length} slides</p>
- </div>
- ${currentCollection?.id === collection.id ? '<i class="fas fa-check text-brand-500"></i>' : ''}
- </div>
- `).join('');
- }
-
- // Toggle dropdown
- function toggleDropdown() {
- dropdownOpen = !dropdownOpen;
- document.getElementById('dropdownMenu').classList.toggle('hidden', !dropdownOpen);
- }
-
- // Close dropdown when clicking outside
- document.addEventListener('click', (e) => {
- if (!e.target.closest('#collectionSelector')) {
- dropdownOpen = false;
- document.getElementById('dropdownMenu').classList.add('hidden');
- }
- });
-
- // Open a collection
- function openCollection(collection) {
- currentCollection = collection;
- currentSlide = 0;
-
- // Update URL
- const url = new URL(window.location);
- url.searchParams.set('project', collection.id);
- window.history.pushState({}, '', url);
-
- // Update UI
- document.getElementById('libraryView').classList.add('hidden');
- document.getElementById('viewerView').classList.remove('hidden');
- document.getElementById('collectionSelector').classList.remove('hidden');
- document.getElementById('keyboardHints').classList.remove('hidden');
- document.getElementById('keyboardHints').classList.add('flex');
- document.getElementById('mainContent').classList.add('viewer-expanded');
-
- setViewMode('normal');
-
- // Update header
- document.getElementById('currentCollectionIcon').textContent = collection.icon;
- document.getElementById('currentCollectionName').textContent = collection.title;
-
- // Update viewer
- document.getElementById('viewerTitle').innerHTML = `${collection.icon} ${collection.title}`;
- document.getElementById('viewerDescription').textContent = collection.description;
- document.getElementById('totalPages').textContent = collection.slides.length;
- document.getElementById('fullscreenTotal').textContent = collection.slides.length;
-
- // Set theme color
- document.getElementById('progressBar').style.background = `linear-gradient(90deg, ${collection.color} 0%, ${collection.color}cc 100%)`;
-
- generateThumbnails();
- generateOverview();
- updateSlide();
- renderDropdown();
-
- window.scrollTo({ top: 0, behavior: 'smooth' });
- }
-
- // Switch collection from dropdown
- function switchCollection(collection) {
- toggleDropdown();
- openCollection(collection);
- }
-
- // Back to library
- function backToLibrary() {
- currentCollection = null;
-
- const url = new URL(window.location);
- url.searchParams.delete('project');
- window.history.pushState({}, '', url);
-
- document.getElementById('libraryView').classList.remove('hidden');
- document.getElementById('viewerView').classList.add('hidden');
- document.getElementById('collectionSelector').classList.add('hidden');
- document.getElementById('keyboardHints').classList.add('hidden');
- document.getElementById('keyboardHints').classList.remove('flex');
- document.getElementById('progressBar').style.width = '0%';
- document.getElementById('mainContent').classList.remove('viewer-expanded');
- document.getElementById('slideViewerContainer').classList.remove('theater-mode');
-
- window.scrollTo({ top: 0, behavior: 'smooth' });
- }
-
- // Set view mode
- function setViewMode(mode) {
- viewMode = mode;
- const container = document.getElementById('slideViewerContainer');
- const normalBtn = document.getElementById('normalModeBtn');
- const theaterBtn = document.getElementById('theaterModeBtn');
-
- if (mode === 'theater') {
- container.classList.add('theater-mode');
- normalBtn.classList.remove('active');
- theaterBtn.classList.add('active');
- } else {
- container.classList.remove('theater-mode');
- normalBtn.classList.add('active');
- theaterBtn.classList.remove('active');
- }
- }
-
- function toggleViewMode() {
- setViewMode(viewMode === 'normal' ? 'theater' : 'normal');
- }
-
- // Generate thumbnail sidebar
- function generateThumbnails() {
- if (!currentCollection) return;
-
- const container = document.getElementById('thumbnailContainer');
- const basePath = `examples/${currentCollection.folder}/`;
-
- container.innerHTML = currentCollection.slides.map((slide, index) => {
- const slidePath = encodeURI(basePath + slide.file);
- return `
- <div class="thumbnail rounded-lg overflow-hidden border-2 ${index === 0 ? 'border-brand-500' : 'border-transparent'}"
- onclick="goToSlide(${index})"
- id="thumb-${index}">
- <object data="${slidePath}" type="image/svg+xml" class="w-full" style="pointer-events:none">
- <div class="w-full h-16 flex items-center justify-center bg-gray-100">📄</div>
- </object>
- <div class="px-2 py-1 bg-gray-50 text-xs text-gray-600 truncate">
- ${index + 1}. ${slide.title}
- </div>
- </div>
- `}).join('');
- }
-
- // Generate overview grid
- function generateOverview() {
- if (!currentCollection) return;
-
- const container = document.getElementById('overviewGrid');
- const basePath = `examples/${currentCollection.folder}/`;
-
- container.innerHTML = currentCollection.slides.map((slide, index) => {
- const slidePath = encodeURI(basePath + slide.file);
- return `
- <div class="glass rounded-xl p-2 shadow-md hover:shadow-lg transition-shadow cursor-pointer"
- onclick="goToSlide(${index}); window.scrollTo({top: 0, behavior: 'smooth'})">
- <object data="${slidePath}" type="image/svg+xml" class="w-full rounded-lg" style="pointer-events:none">
- <div class="w-full h-24 flex items-center justify-center bg-gray-100">📄</div>
- </object>
- <div class="mt-2 px-1">
- <p class="text-sm font-medium text-gray-800 truncate">${index + 1}. ${slide.title}</p>
- <p class="text-xs text-gray-500 truncate">${slide.desc}</p>
- </div>
- </div>
- `}).join('');
- }
-
- // Update slide display
- function updateSlide() {
- if (!currentCollection) return;
-
- const slide = currentCollection.slides[currentSlide];
- const basePath = `examples/${currentCollection.folder}/`;
- const slidePath = encodeURI(basePath + slide.file);
-
- const mainSlide = document.getElementById('mainSlide');
- const fullscreenImage = document.getElementById('fullscreenImage');
-
- // Update main slide
- mainSlide.classList.remove('fade-in');
- void mainSlide.offsetWidth;
- mainSlide.classList.add('fade-in');
- mainSlide.data = slidePath;
-
- // Update fullscreen
- fullscreenImage.data = slidePath;
-
- // Update page numbers
- document.getElementById('currentPage').textContent = currentSlide + 1;
- document.getElementById('fullscreenPage').textContent = currentSlide + 1;
-
- // Update slide info
- document.getElementById('slideTitle').textContent = slide.title;
- document.getElementById('slideDesc').textContent = slide.desc;
-
- // Update progress bar
- const progress = ((currentSlide + 1) / currentCollection.slides.length) * 100;
- document.getElementById('progressBar').style.width = progress + '%';
-
- // Update navigation buttons
- document.getElementById('prevBtn').disabled = currentSlide === 0;
- document.getElementById('nextBtn').disabled = currentSlide === currentCollection.slides.length - 1;
-
- // Update thumbnail highlights
- currentCollection.slides.forEach((_, i) => {
- const thumb = document.getElementById(`thumb-${i}`);
- if (thumb) {
- if (i === currentSlide) {
- thumb.classList.add('border-brand-500');
- thumb.classList.remove('border-transparent');
- thumb.scrollIntoView({ behavior: 'smooth', block: 'nearest' });
- } else {
- thumb.classList.remove('border-brand-500');
- thumb.classList.add('border-transparent');
- }
- }
- });
- }
-
- // Navigation
- function nextSlide() {
- if (currentCollection && currentSlide < currentCollection.slides.length - 1) {
- currentSlide++;
- updateSlide();
- }
- }
-
- function prevSlide() {
- if (currentSlide > 0) {
- currentSlide--;
- updateSlide();
- }
- }
-
- function goToSlide(index) {
- currentSlide = index;
- updateSlide();
- }
-
- // Fullscreen toggle
- function toggleFullscreen() {
- const overlay = document.getElementById('fullscreenOverlay');
- isFullscreen = !isFullscreen;
-
- if (isFullscreen) {
- overlay.classList.remove('hidden');
- document.body.style.overflow = 'hidden';
- } else {
- overlay.classList.add('hidden');
- document.body.style.overflow = '';
- }
- }
-
- // Keyboard navigation
- document.addEventListener('keydown', (e) => {
- if (!currentCollection && e.key !== 'Escape') return;
-
- switch (e.key) {
- case 'ArrowLeft':
- prevSlide();
- break;
- case 'ArrowRight':
- nextSlide();
- break;
- case 'Escape':
- if (isFullscreen) {
- toggleFullscreen();
- } else if (currentCollection) {
- backToLibrary();
- }
- break;
- case 'f':
- case 'F':
- if (currentCollection) toggleFullscreen();
- break;
- case 't':
- case 'T':
- if (currentCollection && !isFullscreen) toggleViewMode();
- break;
- }
- });
-
- // Handle browser back/forward
- window.addEventListener('popstate', () => {
- const urlParams = new URLSearchParams(window.location.search);
- const collectionId = urlParams.get('project');
-
- if (collectionId) {
- const collection = collections.find(c => c.id === collectionId);
- if (collection) {
- openCollection(collection);
- }
- } else {
- backToLibrary();
- }
- });
-
- // Touch/swipe support
- let touchStartX = 0;
- let touchEndX = 0;
-
- document.addEventListener('touchstart', (e) => {
- touchStartX = e.changedTouches[0].screenX;
- });
-
- document.addEventListener('touchend', (e) => {
- touchEndX = e.changedTouches[0].screenX;
- const diff = touchStartX - touchEndX;
-
- if (Math.abs(diff) > 50 && currentCollection) {
- if (diff > 0) nextSlide();
- else prevSlide();
- }
- });
- </script>
-</body>
-
-</html>