github/PPTist
1
0
Fork 0
mirror of https://github.com/pipipi-pikachu/PPTist.git synced 2025-04-15 02:20:00 +08:00
Code Issues Packages Projects Releases Wiki Activity
PPTist/README_zh.md
zxc b6a96f73a2 docs: update README
2025-04-13 20:38:40 +08:00

9.1 KiB
Raw Blame History

简体中文 | English

🎨 PPTist

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

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

✨ 项目特色

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

👀 前排提示

  1. 本项目是一个 “Web 幻灯片应用” ，而不是 “低代码平台”、“H5 编辑器”、“图片编辑器” 、“白板应用”等。
  2. 本项目的目标受众是有【Web 幻灯片】开发需求的开发者，提供的链接只是一个演示地址，不提供任何在线服务。你不应该直接将本项目作为工具使用，也不支持开箱即用。 如果你只是需要一个服务或工具，可以选择更优秀和成熟的产品，例如：Slidev、revealjs 等。
  3. 这里总结了一些常见问题，第一次提 Issues 和 PR 时，务必提前阅读此文档。

🚀 项目运行

npm install

npm run dev

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

📚 功能列表

基础功能

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

幻灯片页面编辑

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

幻灯片元素编辑

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

文字

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

图片

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

形状

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

线条

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

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

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

表格

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

视频

  • 预览封面设置
  • 自动播放

音频

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

公式

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

幻灯片放映

  • 画笔工具（画笔/形状/箭头/荧光笔标注、橡皮擦除、黑板模式）
  • 全部幻灯片预览
  • 触底显示缩略图导航
  • 计时器工具
  • 激光笔
  • 自动放映
  • 演讲者视图

移动端

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

🎯 开发

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

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

📄 版权声明/开源协议

AGPL-3.0 License | Copyright © 2020-PRESENT pipipi-pikachu

🧮 商业用途

  • 本项目禁止闭源商用，如果你希望将PPTist用于商业项目盈利，请尊重开源，严格遵循 AGPL-3.0 协议，回馈开源社区；
  • 如果你因为任何原因，必须要闭源商用，无法执行 AGPL-3.0 协议，可以选择：
    1. 使用早期的 Apache 2.0 协议版本 （该版本最后更新时间为2022年5月，目前已停止维护，点击此处可下载代码）；
    2. 成为项目的重要贡献者（先违反协议后再成为贡献者不在此项范围），包括：
      • 你的代码被本项目作为依赖引用，包括：npm安装、script/style等文件引用、代码片段引用（引用处会注明）；
      • 你给本项目提交过重要的 PR 并且被合并（由作者主观判断）；
      • 你长期参与到本项目的维护/推进工作中，如为本项目：提供了有效的周边工具、制作了大量模板等（由作者主观判断）；
    3. 邮件联系作者付费获取独立的商业授权。独立授权价格：
      • 一年1999元（2599可开发票）
      • 三年2999元（3999可开发票）
      • 永久5499元（7499可开发票）
  • 如需付费获取独立的商业授权，请注意：
    • 独立商业授权的意思是：单独授权您将代码用于商业行为，且不必执行 AGPL-3.0 协议；
    • 仅授权，不存在其他“高级版本/付费版本”、不提供任何在线服务、不提供技术支持和定制开发、不提供更多模板、更无法提供可直接交付的产品；
    • 如有需要，授权后可提供AIPPT相关后台逻辑和当前模板数据（但都非常简单，无任何核心逻辑，建议自己实现）；
    • 请务必提前做好调研，判断PPTist是否符合需求（无论功能还是开发）；
    • 开票仅支持以个人身份开具的电子普票，如介意请考虑慎重考虑；
    • 作者是异步沟通爱好者，非必要不加微信，有疑问请邮件联系，谢谢理解。

🔔 其他说明

什么是 AGPL-3.0 协议

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

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

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

问题反馈

  • 提需求/报bug/询问技术方案等请在 Issues 中进行，而不是邮件；
  • 确保问题的内容不是 Issues（特别是置顶 Issues）和 常见问题 中已经存在的。