8.1 KiB

Raw Permalink Blame History Unescape Escape

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

简体中文 | English

🎨 PPTist

PowerPoint-ist（/'pauəpɔintist/），一个基于 Web 的在线演示文稿（幻灯片）应用，还原了大部分 Office PowerPoint 常用功能，支持文字、图片、形状、线条、图表、表格、视频、音频、公式几种最常用的元素类型，可以在 Web 浏览器中编辑/演示幻灯片。

在线体验地址👉：https://pipipi-pikachu.github.io/PPTist/

✨ 项目特色

易开发：基于 Vue3.x + TypeScript 构建，不依赖UI组件库，尽量避免第三方组件，样式定制更轻松、功能扩展更方便。
易使用：随处可用的右键菜单、几十种快捷键、无数次编辑细节打磨，力求还原桌面应用级体验。
功能丰富：支持 PPT 中的大部分常用元素和功能，支持AI生成PPT、支持多种格式导出、支持移动端基础编辑和预览...

👀 前排提示

本项目是一个 “Web 幻灯片应用” ，而不是 “低代码平台”、“H5 编辑器”、“图片编辑器” 、“白板应用”等。
本项目的目标受众是有【Web 幻灯片】开发需求的开发者，提供的链接只是一个演示地址，不提供任何在线服务。你不应该直接将本项目作为工具使用，也不支持开箱即用。如果你只是需要一个服务或工具，可以选择更优秀和成熟的产品，例如：Slidev、revealjs 等。
本项目是基于 DOM 的渲染方案，优点是上手简单易扩展。但是相比 Canvas 渲染的方案，在复杂场景下性能会存在一定的差距，所以如果你对性能有较高的要求，本项目可能不是一个好的选择/参考方向。
这里总结了一些常见问题，第一次提 Issues 和 PR 时，务必提前阅读此文档。

🚀 项目运行

npm install

npm run dev

浏览器访问：http://127.0.0.1:5173/

📚 功能列表

基础功能

历史记录（撤销、重做）
快捷键
右键菜单
导出本地文件（PPTX、JSON、图片、PDF）
导入导出特有 .pptist 文件
打印
AI生成PPT

幻灯片页面编辑

页面添加、删除
页面顺序调整
页面复制粘贴
幻灯片分节
背景设置（纯色、渐变、图片）
设置画布尺寸
网格线
标尺
画布缩放、移动
主题设置
提取已有幻灯片风格
演讲者备注（富文本）
幻灯片模板
翻页动画
元素动画（入场、退场、强调）
选择面板（隐藏元素、层级排序、元素命名）
页面和节点类型标注（可用于模板相关功能）
查找/替换
批注

幻灯片元素编辑

元素添加、删除
元素复制粘贴
元素拖拽移动
元素旋转
元素缩放
元素多选（框选、点选）
多元素组合
多元素批量编辑
元素锁定
元素吸附对齐（移动和缩放）
元素层级调整
元素对齐到画布
元素对齐到其他元素
多元素均匀分布
拖拽添加图文
粘贴外部图片
元素坐标、尺寸和旋转角度设置
元素超链接（链接到网页、链接到其他幻灯片页面）

文字

富文本编辑（颜色、高亮、字体、字号、加粗、斜体、下划线、删除线、角标、行内代码、引用、超链接、对齐方式、序号、项目符号、段落缩进、清除格式）
行高
字间距
段间距
首行缩进
填充色
边框
阴影
透明度
竖向文本

图片

裁剪（自定义、按形状、按纵横比）
圆角
滤镜
着色（蒙版）
翻转
边框
阴影
替换图片
重置图片
设置为背景图

形状

绘制任意多边形
绘制任意线条（未封闭形状模拟）
替换形状
填充色
边框
阴影
透明度
翻转
形状格式刷
编辑文字（支持富文本，与文字元素的富文本编辑功能近似）

线条

直线、基础折线/曲线
颜色
宽度
样式（实线、虚线、点线）
端点样式

图表（柱状图、条形图、折线图、面积图、散点图、饼图、环形图、雷达图）

图表类型转换
数据编辑
背景填充
主题色
坐标文字颜色
堆积模式、平滑曲线等

表格

行、列添加删除
主题设置（主题色、表头、汇总行、第一列、最后一列）
合并单元格
单元格样式（填充色、文字颜色、加粗、斜体、下划线、删除线、对齐方式）
边框

视频

预览封面设置
自动播放

音频

图标颜色
自动播放
循环播放

公式

LaTeX编辑
颜色设置
公式线条粗细设置

幻灯片放映

全部幻灯片预览
画笔、黑板工具
计时器工具
激光笔
自动放映
演讲者视图

移动端

基础编辑
- 页面添加、删除、复制、备注、撤销重做
- 插入文字、图片、矩形、圆形
- 元素通用操作：移动、缩放、旋转、复制、删除、层级调整、对齐
- 元素样式：文字（加粗、斜体、下划线、删除线、字号、颜色、对齐方向）、填充色
基础预览
播放预览

🎯 开发

目前没有完整的开发文档，但下面这些文档可能会对你有一些帮助：

下面是一些辅助开发的工具/仓库：

导入PPTX文件参考：pptxtojson
绘制形状：svgPathCreator

📄 版权声明/开源协议

🧮 商业用途

本项目禁止闭源商用，如果你希望将PPTist用于商业项目盈利，请尊重开源，严格遵循 AGPL-3.0 协议，回馈开源社区；
如果你因为任何原因，必须要闭源商用，无法执行 AGPL-3.0 协议，可以选择：
1. 使用早期的 Apache 2.0 协议版本点击此处下载；
2. 成为项目的重要贡献者（先违反协议后再成为贡献者不在此项范围），包括：
  - 你的代码被本项目作为依赖引用，包括：npm安装、script/style等文件引用、代码片段引用（引用处会注明）；
  - 你给本项目提交过重要的 PR 并且被合并（由作者主观判断）；
  - 你长期参与到本项目的维护/推进工作中，如为本项目：提供了有效的周边工具、制作了大量模板等（由作者主观判断）；
3. 邮件联系作者付费获取独立的商业授权（注：仅授权，无额外商业化版本和技术支持）。独立授权价格：
  - 一年1999
  - 三年2999
  - 永久5499（无发票）
  - 永久6999（可开电子发票）

什么是 AGPL-3.0 协议？

协议的核心要求用通俗的语言解释如下：

开源义务：如果你用了 AGPL 的代码，无论你或你的下游怎么使用/修改，都必须把你最终的代码全部完整公开出来（不只是给出修改的部分），并继续以 AGPL 协议开源，保持传染性。
网络服务也要开源：即使你只是用 AGPL 的代码做了一个网站或网络服务，别人通过网络用你的服务时，你也需要遵守上一条开源义务。
保留版权声明：你不能删掉代码里原来的作者信息和许可证声明，得告诉大家这代码是从哪儿来的。
不能加额外限制：你不能在 AGPL 代码上加一些限制，比如不让别人再分发，或者要求别人付费才能用。
免责声明：作者不保证代码没有 bug，也不对使用后果负责。

详细协议内容见官方文档：AGPL-3.0 协议

8.1 KiB Raw Permalink Blame History Unescape Escape