html-to-pptx

HTML 转 PowerPoint 转换器

首次使用？ 如果上方的 setup_complete: false，请先运行 ./SETUP.md，然后将 setup_complete 设为 true。

使用 PptxGenJS 将 HTML 转换为 PowerPoint（.pptx），并提供出色的希伯来语／RTL 支持。

设置（一次性）

cd ~/.claude/skills/html-to-pptx && npm install

快速使用

基本转换：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js input.html output.pptx

带 RTL 的希伯来语文档：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js hebrew.html presentation.pptx --rtl

将 URL 转换为 PowerPoint：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js https://example.com slides.pptx

将复杂 HTML 转换为图像（像素级还原）：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js complex.html slides.pptx --mode=image

转换模式

模式	说明	适用场景
text	解析 HTML，创建原生 PPTX 元素	简单 HTML、可编辑文本
image	对 HTML 截图，并将其嵌入为图像	复杂布局、精确还原
auto	自动检测最佳模式	默认

选项

选项	说明	默认值
--mode=<mode>	text、image、auto	auto
--rtl	强制为希伯来语／阿拉伯语启用 RTL	自动检测
--title=<title>	演示文稿标题	auto
--author=<author>	作者姓名	AVIZ
--layout=<layout>	LAYOUT_16x9、LAYOUT_4x3	LAYOUT_16x9
--font=<font>	默认字体	Heebo（希伯来语）／Arial
--font-size=<size>	字号（磅）	18
--background=<color>	背景颜色（十六进制）	-
--slide-per=<selector>	按 CSS 选择器拆分幻灯片	-
--wait=<ms>	等待渲染（图像模式）	2000

示例

希伯来语演示文稿：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js hebrew.html slides.pptx --rtl --font=Heebo

按章节拆分：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js doc.html slides.pptx --slide-per=section

自定义样式：

node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js doc.html slides.pptx --font=David --font-size=24 --background=F5F5F5

通过管道传入 HTML：

echo "<h1>שלום עולם</h1>" | node ~/.claude/skills/html-to-pptx/scripts/html-to-pptx.js - output.pptx --rtl

希伯来语最佳实践

1. 在 HTML 中使用 <html lang="he" dir="rtl">
2. 始终添加 --rtl 标志
3. 使用支持希伯来语的字体：Heebo、David、Noto Sans Hebrew
4. 对于复杂布局，使用 --mode=image 以实现像素级还原

幻灯片结构

转换器会自动检测幻灯片边界：

1. <section> 元素
2. <article> 元素
3. .slide 类
4. <hr> 元素

也可以使用 --slide-per=".my-slide" 指定自定义选择器。