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.ymldeleted file mode 100644index 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@v4diff --git a/.gitignore b/.gitignoreindex 1095b0b2..20295c71 100644--- a/.gitignore+++ b/.gitignore@@ -180,7 +180,7 @@ TODO.mdPERSONAL_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 accessprojects/*!projects/README.mddiff --git a/AGENTS.md b/AGENTS.mdindex 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.mdindex 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.mdindex 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.mdindex 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 chartA 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 Inputdiff --git a/docs/zh/why-ppt-master.md b/docs/zh/why-ppt-master.mdindex 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.htmlindex 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.mdindex 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.pyindex 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 ToolChecks the structural integrity and compliance of multiple projects at once.Usage:- python3 scripts/batch_validate.py examplespython3 scripts/batch_validate.py projectspython3 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 examplespython3 scripts/batch_validate.py projects- python3 scripts/batch_validate.py examples projectspython3 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.directoriesdiff --git a/skills/ppt-master/scripts/config.py b/skills/ppt-master/scripts/config.pyindex 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 directoryREPO_ROOT = PROJECT_ROOT.parent.parent-EXAMPLES_DIR = REPO_ROOT / 'examples'PROJECTS_DIR = REPO_ROOT / 'projects'# Template subdirectoriesdiff --git a/skills/ppt-master/scripts/docs/project.md b/skills/ppt-master/scripts/docs/project.mdindex 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 projectspython3 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.mdindex 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 --exportpython3 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_outputpython3 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.pyindex 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-iconsProcessing 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.pyindex 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 GeneratorAutomatically 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 parserdiff --git a/skills/ppt-master/scripts/svg_finalize/embed_images.py b/skills/ppt-master/scripts/svg_finalize/embed_images.pyindex 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 *.svgExamples:- 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 osdiff --git a/skills/ppt-master/scripts/svg_finalize/svg_rect_to_path.py b/skills/ppt-master/scripts/svg_finalize/svg_rect_to_path.pyindex 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_roundedExamples:- 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.svgOutput:- 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.svgWhat 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.pyindex 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_projectsprojects = find_all_projects(base_dir)diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.pyindex 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 projectsExamples:python3 scripts/svg_quality_checker.py projects/demo --stage final --jsondiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.pyindex 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.0SVG 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 enableRecorded 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.htmldeleted file mode 100644index 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, "'")})'>- <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>