# pptor

**Repository Path**: QiangGeGit/pptor

## Basic Information

- **Project Name**: pptor
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-25
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pptor

> 基于 **Marp** 的 PPT 生成工具 —— 让你用 **VSCode + Cline + Marp** 高效产出专业演示文稿。

## ✨ 项目简介

**pptor** 是一个面向 AI 协作的 PPT 创作项目。  
通过 Markdown 编写、Cline 辅助生成、Marp 渲染导出，把传统的图形化幻灯片制作转换为**纯文本工作流**：

- 📝 用 Markdown 写 PPT，告别拖拽排版
- 🤖 用 Cline 对话生成与迭代内容
- 🎨 用 Marp 渲染并导出为 PDF / PPTX / HTML / PNG
- 🗂 用 Git 进行版本管理

## 🚀 快速开始

### 1. 安装必备工具

| 工具 | 安装方式 |
|------|----------|
| **VSCode** | <https://code.visualstudio.com> |
| **Marp for VS Code** | VSCode 扩展市场搜索 `Marp for VS Code` |
| **Cline** | VSCode 扩展市场搜索 `Cline` |
| **Marp CLI**（可选） | `npm install -g @marp-team/marp-cli` |

### 2. 用 Cline 生成 PPT

在 VSCode 中打开 Cline，输入自然语言需求，例如：

> 帮我生成一份介绍 Python 装饰器的 marp ppt，
> 包含定义、原理、示例代码、应用场景，共 10 页

Cline 会自动创建带 `marp: true` 头的 `.md` 文件。

### 3. 实时预览

在 `.md` 文件中按 `Ctrl + K V` 打开 VSCode 侧边预览。

### 4. 导出最终文件

```bash
# 导出为 HTML
npx @marp-team/marp-cli intro-marp.md --html -o build/intro-marp.html

# 导出为 PDF
npx @marp-team/marp-cli intro-marp.md --pdf -o build/intro-marp.pdf

# 导出为 PPTX
npx @marp-team/marp-cli intro-marp.md --pptx -o build/intro-marp.pptx

# 导出为 PNG 图片
npx @marp-team/marp-cli intro-marp.md --images png -o build/slide.png
```

> ⚠️ 导出 PDF / PPTX 需本地已安装 **Chrome / Edge** 浏览器

## 📂 项目结构

```
pptor/
├── .clinerules/             # Cline 项目规则
│   └── rule.md
├── memory-bank/             # 项目知识库（Cline 记忆）
│   ├── projectbrief.md
│   ├── productContext.md
│   ├── systemPatterns.md
│   ├── techContext.md
│   ├── activeContext.md
│   └── progress.md
├── build/                   # 导出产物
│   ├── intro-marp.html
│   └── slide.001.png ~ slide.021.png
├── intro-marp.md            # Marp 入门教程 PPT（21 页）
└── readme.md
```

## 📖 教程文档

项目内置了一份 **Marp 入门教程 PPT**：[`intro-marp.md`](./intro-marp.md)

教程涵盖：

1. 什么是 Marp
2. 为什么选择 Marp
3. 环境准备
4. Marp 基础语法（Front Matter、分页、列表、代码块、指令）
5. VSCode + Cline + Marp 工作流
6. PPT 导出（VSCode 扩展 + 命令行）
7. 进阶技巧（分栏布局、背景图、数学公式、自定义主题）
8. 总结与最佳实践

直接打开 `intro-marp.md` 即可预览，或运行下方命令导出查看：

```bash
npx @marp-team/marp-cli intro-marp.md --html -o build/intro-marp.html
start build\intro-marp.html
```

## 🎨 样式规范

为确保内容**不溢出**、**视觉友好**，项目约定的 Marp 样式规范：

- **页面比例**：16:9
- **基础字号**：26px
- **页面留白**：padding 50px 60px
- **代码块字号**：18px（紧凑展示）
- **主色调**：蓝色系 `#2563eb`
- **单页内容**：建议 ≤ 8 行
- **复杂内容**：拆分为「（1/2）」「（2/2）」多页

详见 [`memory-bank/systemPatterns.md`](./memory-bank/systemPatterns.md)。

## 🤖 与 Cline 协作的最佳实践

- ✅ **明确需求**：主题、页数、风格一次说清
- ✅ **先列大纲**：让 Cline 生成目录，再逐页填充
- ✅ **指定主题**：要求某种配色或字体风格
- ✅ **迭代优化**：通过对话修改单页或全局样式
- ✅ **实时预览**：边写边看，所见即所得

## 🔗 相关链接

- Marp 官网：<https://marp.app>
- Marpit 语法：<https://marpit.marp.app>
- Marp CLI：<https://github.com/marp-team/marp-cli>
- Cline：<https://github.com/cline/cline>

## 📜 License

MIT