|
|
|
|
|
简体中文 | [English](README.md)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 🎨 PPTist
|
|
|
|
|
|
> PowerPoint-ist（/'pauəpɔintist/），一个基于 Web 的在线演示文稿（幻灯片）应用，还原了大部分 Office PowerPoint 常用功能，支持 文字、图片、形状、线条、图表、表格、视频、音频、公式 几种最常用的元素类型，可以在 Web 浏览器中编辑/演示幻灯片。
|
|
|
|
|
|
|
|
|
|
|
|
<b>在线体验地址👉：[https://pipipi-pikachu.github.io/PPTist/](https://pipipi-pikachu.github.io/PPTist/)</b>
|
|
|
|
|
|
|
|
|
|
|
|
# ✨ 项目特色
|
|
|
|
|
|
1. 易开发：基于 Vue3.x + TypeScript 构建，不依赖UI组件库，尽量避免第三方组件，样式定制更轻松、功能扩展更方便。
|
|
|
|
|
|
2. 易使用：随处可用的右键菜单、几十种快捷键、无数次编辑细节打磨，力求还原桌面应用级体验。
|
|
|
|
|
|
3. 功能丰富：支持 PPT 中的大部分常用元素和功能，支持AI生成PPT、支持多种格式导出、支持移动端基础编辑和预览...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 👀 前排提示
|
|
|
|
|
|
1. 本项目是一个 “Web 幻灯片应用” ，而不是 “低代码平台”、“H5 编辑器”、“图片编辑器” 、“白板应用”等。
|
|
|
|
|
|
2. 本项目的目标受众是<b>有【Web 幻灯片】开发需求的开发者</b>，提供的链接只是一个演示地址，不提供任何在线服务。你不应该直接将本项目作为工具使用，也不支持开箱即用。
|
|
|
|
|
|
如果你只是需要一个服务或工具，可以选择更优秀和成熟的产品，例如：[Slidev](https://sli.dev/)、[revealjs](https://revealjs.com/) 等。
|
|
|
|
|
|
3. 本项目是基于 DOM 的渲染方案，优点是上手简单易扩展。但是相比 Canvas 渲染的方案，在复杂场景下性能会存在一定的差距，所以如果你对性能有较高的要求，本项目可能不是一个好的选择/参考方向。
|
|
|
|
|
|
4. 这里总结了一些[常见问题](/doc/Q&A.md)，第一次提 Issues 和 PR 时，务必提前阅读此文档。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 🚀 项目运行
|
|
|
|
|
|
```
|
|
|
|
|
|
npm install
|
|
|
|
|
|
|
|
|
|
|
|
npm run dev
|
|
|
|
|
|
```
|
|
|
|
|
|
浏览器访问：http://127.0.0.1:5173/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 📚 功能列表
|
|
|
|
|
|
### 基础功能
|
|
|
|
|
|
- 历史记录（撤销、重做）
|
|
|
|
|
|
- 快捷键
|
|
|
|
|
|
- 右键菜单
|
|
|
|
|
|
- 导出本地文件（PPTX、JSON、图片、PDF）
|
|
|
|
|
|
- 导入导出特有 .pptist 文件
|
|
|
|
|
|
- 打印
|
|
|
|
|
|
- AI生成PPT
|
|
|
|
|
|
### 幻灯片页面编辑
|
|
|
|
|
|
- 页面添加、删除
|
|
|
|
|
|
- 页面顺序调整
|
|
|
|
|
|
- 页面复制粘贴
|
|
|
|
|
|
- 幻灯片分节
|
|
|
|
|
|
- 背景设置（纯色、渐变、图片）
|
|
|
|
|
|
- 设置画布尺寸
|
|
|
|
|
|
- 网格线
|
|
|
|
|
|
- 标尺
|
|
|
|
|
|
- 画布缩放、移动
|
|
|
|
|
|
- 主题设置
|
|
|
|
|
|
- 提取已有幻灯片风格
|
|
|
|
|
|
- 演讲者备注（富文本）
|
|
|
|
|
|
- 幻灯片模板
|
|
|
|
|
|
- 翻页动画
|
|
|
|
|
|
- 元素动画（入场、退场、强调）
|
|
|
|
|
|
- 选择面板（隐藏元素、层级排序、元素命名）
|
|
|
|
|
|
- 页面和节点类型标注（可用于模板相关功能）
|
|
|
|
|
|
- 查找/替换
|
|
|
|
|
|
- 批注
|
|
|
|
|
|
### 幻灯片元素编辑
|
|
|
|
|
|
- 元素添加、删除
|
|
|
|
|
|
- 元素复制粘贴
|
|
|
|
|
|
- 元素拖拽移动
|
|
|
|
|
|
- 元素旋转
|
|
|
|
|
|
- 元素缩放
|
|
|
|
|
|
- 元素多选（框选、点选）
|
|
|
|
|
|
- 多元素组合
|
|
|
|
|
|
- 多元素批量编辑
|
|
|
|
|
|
- 元素锁定
|
|
|
|
|
|
- 元素吸附对齐（移动和缩放）
|
|
|
|
|
|
- 元素层级调整
|
|
|
|
|
|
- 元素对齐到画布
|
|
|
|
|
|
- 元素对齐到其他元素
|
|
|
|
|
|
- 多元素均匀分布
|
|
|
|
|
|
- 拖拽添加图文
|
|
|
|
|
|
- 粘贴外部图片
|
|
|
|
|
|
- 元素坐标、尺寸和旋转角度设置
|
|
|
|
|
|
- 元素超链接（链接到网页、链接到其他幻灯片页面）
|
|
|
|
|
|
#### 文字
|
|
|
|
|
|
- 富文本编辑（颜色、高亮、字体、字号、加粗、斜体、下划线、删除线、角标、行内代码、引用、超链接、对齐方式、序号、项目符号、段落缩进、清除格式）
|
|
|
|
|
|
- 行高
|
|
|
|
|
|
- 字间距
|
|
|
|
|
|
- 段间距
|
|
|
|
|
|
- 首行缩进
|
|
|
|
|
|
- 填充色
|
|
|
|
|
|
- 边框
|
|
|
|
|
|
- 阴影
|
|
|
|
|
|
- 透明度
|
|
|
|
|
|
- 竖向文本
|
|
|
|
|
|
#### 图片
|
|
|
|
|
|
- 裁剪（自定义、按形状、按纵横比）
|
|
|
|
|
|
- 圆角
|
|
|
|
|
|
- 滤镜
|
|
|
|
|
|
- 着色（蒙版）
|
|
|
|
|
|
- 翻转
|
|
|
|
|
|
- 边框
|
|
|
|
|
|
- 阴影
|
|
|
|
|
|
- 替换图片
|
|
|
|
|
|
- 重置图片
|
|
|
|
|
|
- 设置为背景图
|
|
|
|
|
|
#### 形状
|
|
|
|
|
|
- 绘制任意多边形
|
|
|
|
|
|
- 绘制任意线条（未封闭形状模拟）
|
|
|
|
|
|
- 替换形状
|
|
|
|
|
|
- 填充色
|
|
|
|
|
|
- 边框
|
|
|
|
|
|
- 阴影
|
|
|
|
|
|
- 透明度
|
|
|
|
|
|
- 翻转
|
|
|
|
|
|
- 形状格式刷
|
|
|
|
|
|
- 编辑文字（支持富文本，与文字元素的富文本编辑功能近似）
|
|
|
|
|
|
#### 线条
|
|
|
|
|
|
- 直线、基础折线/曲线
|
|
|
|
|
|
- 颜色
|
|
|
|
|
|
- 宽度
|
|
|
|
|
|
- 样式（实线、虚线、点线）
|
|
|
|
|
|
- 端点样式
|
|
|
|
|
|
#### 图表（柱状图、条形图、折线图、面积图、散点图、饼图、环形图、雷达图）
|
|
|
|
|
|
- 图表类型转换
|
|
|
|
|
|
- 数据编辑
|
|
|
|
|
|
- 背景填充
|
|
|
|
|
|
- 主题色
|
|
|
|
|
|
- 坐标文字颜色
|
|
|
|
|
|
- 堆积模式、平滑曲线等
|
|
|
|
|
|
#### 表格
|
|
|
|
|
|
- 行、列添加删除
|
|
|
|
|
|
- 主题设置（主题色、表头、汇总行、第一列、最后一列）
|
|
|
|
|
|
- 合并单元格
|
|
|
|
|
|
- 单元格样式（填充色、文字颜色、加粗、斜体、下划线、删除线、对齐方式）
|
|
|
|
|
|
- 边框
|
|
|
|
|
|
#### 视频
|
|
|
|
|
|
- 预览封面设置
|
|
|
|
|
|
- 自动播放
|
|
|
|
|
|
#### 音频
|
|
|
|
|
|
- 图标颜色
|
|
|
|
|
|
- 自动播放
|
|
|
|
|
|
- 循环播放
|
|
|
|
|
|
#### 公式
|
|
|
|
|
|
- LaTeX编辑
|
|
|
|
|
|
- 颜色设置
|
|
|
|
|
|
- 公式线条粗细设置
|
|
|
|
|
|
### 幻灯片放映
|
|
|
|
|
|
- 全部幻灯片预览
|
|
|
|
|
|
- 画笔、黑板工具
|
|
|
|
|
|
- 计时器工具
|
|
|
|
|
|
- 激光笔
|
|
|
|
|
|
- 自动放映
|
|
|
|
|
|
- 演讲者视图
|
|
|
|
|
|
### 移动端
|
|
|
|
|
|
- 基础编辑
|
|
|
|
|
|
- 页面添加、删除、复制、备注、撤销重做
|
|
|
|
|
|
- 插入文字、图片、矩形、圆形
|
|
|
|
|
|
- 元素通用操作：移动、缩放、旋转、复制、删除、层级调整、对齐
|
|
|
|
|
|
- 元素样式：文字（加粗、斜体、下划线、删除线、字号、颜色、对齐方向）、填充色
|
|
|
|
|
|
- 基础预览
|
|
|
|
|
|
- 播放预览
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 🎯 开发
|
|
|
|
|
|
目前没有完整的开发文档，但下面这些文档可能会对你有一些帮助：
|
|
|
|
|
|
- [项目目录与数据结构](/doc/DirectoryAndData.md)
|
|
|
|
|
|
- [画布与元素的基本原理](/doc/Canvas.md)
|
|
|
|
|
|
- [如何自定义一个元素](/doc/CustomElement.md)
|
|
|
|
|
|
- [关于AIPPT](/doc/AIPPT.md)
|
|
|
|
|
|
|
|
|
|
|
|
下面是一些辅助开发的工具/仓库：
|
|
|
|
|
|
- 导入PPTX文件参考：[pptxtojson](https://github.com/pipipi-pikachu/pptxtojson)
|
|
|
|
|
|
- 绘制形状：[svgPathCreator](https://github.com/pipipi-pikachu/svgPathCreator)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 📄 版权声明/开源协议
|
|
|
|
|
|
[AGPL-3.0 License](/LICENSE) | Copyright © 2020-PRESENT [pipipi-pikachu](https://github.com/pipipi-pikachu)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 🧮 商业用途
|
|
|
|
|
|
- 本项目禁止闭源商用，如果你希望将PPTist用于商业项目盈利，请尊重开源，**严格遵循 [AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)**，回馈开源社区；
|
|
|
|
|
|
- 如果你因为任何原因，必须要闭源商用，无法执行 AGPL-3.0 协议，可以选择：
|
|
|
|
|
|
1. 使用早期的 Apache 2.0 协议版本 [点击此处下载](https://github.com/pipipi-pikachu/PPTist/archive/f1a35bb8e045124e37dcafd6acbf40b4531b69aa.zip)；
|
|
|
|
|
|
2. 成为项目的重要贡献者（先违反协议后再成为贡献者不在此项范围），包括：
|
|
|
|
|
|
- 你的代码被本项目作为依赖引用，包括：npm安装、script/style等文件引用、代码片段引用（引用处会注明）；
|
|
|
|
|
|
- 你给本项目提交过重要的 PR 并且被合并（由作者主观判断）；
|
|
|
|
|
|
- 你长期参与到本项目的维护/推进工作中，如为本项目：提供了有效的周边工具、制作了大量模板等（由作者主观判断）；
|
|
|
|
|
|
3. [邮件联系作者](mailto:pipipi_pikachu@163.com)付费获取独立的商业授权（注：仅授权，无额外商业化版本和技术支持）。独立授权价格：
|
|
|
|
|
|
- 一年1999
|
|
|
|
|
|
- 三年2999
|
|
|
|
|
|
- 永久5499（无发票）
|
|
|
|
|
|
- 永久6999（可开电子发票）
|
|
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
#### 什么是 AGPL-3.0 协议 ？
|
|
|
|
|
|
协议的核心要求用通俗的语言解释如下：
|
|
|
|
|
|
- **开源义务**：如果你用了 AGPL 的代码，无论你或你的下游怎么使用/修改，都必须把你最终的代码全部完整公开出来（不只是给出修改的部分），并继续以 AGPL 协议开源，保持传染性。
|
|
|
|
|
|
- **网络服务也要开源**：即使你只是用 AGPL 的代码做了一个网站或网络服务，别人通过网络用你的服务时，你也需要遵守上一条**开源义务**。
|
|
|
|
|
|
- **保留版权声明**：你不能删掉代码里原来的作者信息和许可证声明，得告诉大家这代码是从哪儿来的。
|
|
|
|
|
|
- **不能加额外限制**：你不能在 AGPL 代码上加一些限制，比如不让别人再分发，或者要求别人付费才能用。
|
|
|
|
|
|
- **免责声明**：作者不保证代码没有 bug，也不对使用后果负责。
|
|
|
|
|
|
|
|
|
|
|
|
详细协议内容见官方文档：[AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)
|
