chore: 添加 MIT LICENSE、完善 README 并忽略 .vscode 文件夹

This commit is contained in:
2026-03-26 14:06:08 +08:00
parent 121c165d62
commit a154c98c0e
8 changed files with 216 additions and 96 deletions

View File

@@ -0,0 +1,89 @@
# pptopic
将 PowerPoint 演示文稿导出为长图的工具。
## 功能
- 📊 **PPT 转长图**:将 PPTX 文件导出为一张连续的长图
- 🖼️ **图片优化**:支持使用 `pngquant` 进行无损压缩
- ⚙️ **灵活配置**:可自定义输出尺寸、格式、保存路径等
## 环境要求
- **Windows 系统**(依赖 PowerPoint COM 接口)
- Python ≥ 3.13
- 已安装 Microsoft PowerPoint
## 安装
```bash
pip install pptopic
```
如需图片优化功能,请安装 `pngquant`
```bash
scoop install pngquant
```
也可以使用你熟悉的图片优化引擎替代 `pngquant` ,但一般情况下,我更推荐 `pngquant`
## 使用
### 导出长图
```bash
# 基本用法
pptopic export presentation.pptx
# 指定输出文件名和目录
pptopic export presentation.pptx -o result.png -d ./output
# 自定义宽度并启用优化
pptopic export presentation.pptx --width 1200 --optimize
```
### 优化图片
```bash
# 优化现有图片
pptopic optimize image.png
# 指定输出路径和最大高度
pptopic optimize image.png -o optimized.png --max-height 20000
```
## 命令选项
### export 命令
| 选项 | 简写 | 说明 |
|------|------|------|
| `--output` | `-o` | 输出文件名 |
| `--dir` | `-d` | 输出目录(默认当前目录) |
| `--width` | `-w` | 导出图片宽度(像素) |
| `--format` | `-f` | 输出格式JPG 或 PNG默认 PNG |
| `--optimize` | - | 启用图片优化 |
| `--max-height` | - | 优化时最大高度(默认 29999 |
### optimize 命令
| 选项 | 简写 | 说明 |
|------|------|------|
| `--output` | `-o` | 输出文件路径 |
| `--max-height` | - | 最大高度限制 |
| `--engine` | - | 优化引擎(默认 pngquant |
## 示例
```bash
# 导出并优化
pptopic export presentation.pptx --optimize
# 导出为 JPG 格式
pptopic export presentation.pptx -f JPG -o result
```
## 许可证
MIT License