README_zh.md 11 KB

stars forks license language issue gitee

简体中文 | 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幻灯片开发需求的开发者,需要有基础的web开发经验,提供的链接只是一个演示地址,不提供任何在线服务。你不应该直接将本项目作为工具使用,也不支持开箱即用。如果你只是需要一个服务或工具,可以选择更优秀和成熟的产品,例如:Slidevrevealjs 等。
  3. 这里总结了一些常见问题,第一次提 Issues 和 PR 时,务必提前阅读此文档。

🚀 项目运行

npm install

npm run dev

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

注意:如果你将本项目部署在自己的服务器上,发现无法初始化成功,那是因为初始化的数据是放在作者私人对象存储中的,不对外开放,你需要把数据转移到自己的服务器/对象存储服务/数据库/前端本地

📚 功能列表

基础功能

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

    幻灯片页面编辑

  • 页面添加、删除

  • 页面顺序调整

  • 页面复制粘贴

  • 幻灯片分节

  • 背景设置(纯色、渐变、图片)

  • 设置画布尺寸

  • 网格线

  • 标尺

  • 画布缩放、移动

  • 主题设置

  • 提取已有幻灯片风格

  • 演讲者备注(富文本)

  • 幻灯片模板

  • 翻页动画

  • 元素动画(入场、退场、强调)

  • 选择面板(隐藏元素、层级排序、元素命名)

  • 页面和节点类型标注(可用于模板相关功能)

  • 查找/替换

  • 批注

    幻灯片元素编辑

  • 元素添加、删除

  • 元素复制粘贴

  • 元素拖拽移动

  • 元素旋转

  • 元素缩放

  • 元素多选(框选、点选)

  • 多元素组合

  • 多元素批量编辑

  • 元素锁定

  • 元素吸附对齐(移动和缩放)

  • 元素层级调整

  • 元素对齐到画布

  • 元素对齐到其他元素

  • 多元素均匀分布

  • 拖拽添加图文

  • 粘贴外部图片

  • 元素坐标、尺寸和旋转角度设置

  • 元素超链接(链接到网页、链接到其他幻灯片页面)

    文字

  • 富文本编辑(颜色、高亮、字体、字号、加粗、斜体、下划线、删除线、角标、行内代码、引用、超链接、对齐方式、序号、项目符号、段落缩进、清除格式)

  • 行高

  • 字间距

  • 段间距

  • 首行缩进

  • 填充色

  • 边框

  • 阴影

  • 透明度

  • 竖向文本

  • AI改写/扩写/缩写

    图片

  • 裁剪(自定义、按形状、按纵横比)

  • 圆角

  • 滤镜

  • 着色(蒙版)

  • 翻转

  • 边框

  • 阴影

  • 替换图片

  • 重置图片

  • 设置为背景图

    形状

  • 绘制任意多边形

  • 绘制任意线条(未封闭形状模拟)

  • 替换形状

  • 填充(纯色、渐变、图片)

  • 边框

  • 阴影

  • 透明度

  • 翻转

  • 形状格式刷

  • 编辑文字(支持富文本,与文字元素的富文本编辑功能近似)

    线条

  • 直线、基础折线/曲线

  • 颜色

  • 宽度

  • 样式(实线、虚线、点线)

  • 端点样式

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

  • 图表类型转换

  • 数据编辑

  • 背景填充

  • 主题色

  • 坐标轴/坐标文字颜色

  • 网格颜色

  • 堆积模式、平滑曲线等

    表格

  • 行、列添加删除

  • 主题设置(主题色、表头、汇总行、第一列、最后一列)

  • 合并单元格

  • 单元格样式(填充色、文字颜色、加粗、斜体、下划线、删除线、对齐方式)

  • 边框

    视频

  • 预览封面设置

  • 自动播放

    音频

  • 图标颜色

  • 自动播放

  • 循环播放

    公式

  • 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 或 Issue(由作者主观判断,符合的 PR 或 Issue 会打上important contribution标签);
      • 你长期参与到本项目的维护/推进工作中,如为本项目:提供了有效的周边工具、制作了大量模板等(由作者主观判断);
      • 先违反协议后再成为贡献者不适用此项;
    3. 邮件联系作者付费获取独立的商业授权。独立授权价格:
      • 一年1999元
      • 三年2999元
      • 永久5499元(不含税)
      • 违反协议后被作者找到的,不适用于以上价格
  • 建议优先考虑执行AGPL-3.0协议,如需付费获取独立的商业授权,还请注意:
    • 独立商业授权表示:单独授权您将代码用于商业行为,且不必执行 AGPL-3.0 协议;
    • 仅授权(而非出售软件或服务),不存在其他“高级版本/付费版本/完整版本”、不提供任何在线服务/技术支持/技术咨询/定制开发、也不提供可直接交付的产品;
    • 该软件无法开箱即用,至少也需自行接入后端数据读取/存储相关能力。因此,使用本项目需要有最基本的web开发经验(能理解什么是前端&后端、数据从哪来&怎么存、什么是接口、什么是跨域等);
    • 授权后,仍禁止将源代码二次售卖、授权、开源或恶意传播;
    • 授权后,如有需要,作者可提供当前AIPPT相关后台逻辑和当前模板数据以供参考(但都非常简单,无任何核心逻辑,更建议自己实现);
    • 请务必提前做好基础调研,判断PPTist是否符合需求,包括:功能(是否能满足业务需求)和开发(是否接受当前技术栈/实现方案);
    • 作者没法提供法律文件来证明“我的Github帐号属于我”,如介意这一点,请考虑其他途径;
    • 不接受黑名单/耻辱柱对象通过付费获取独立的商业授权或贡献代码;
    • 作者倡导异步沟通,不加微信/QQ/手机号等,有任何授权相关疑问请邮件联系,谢谢理解;
    • 提需求/报bug/询问技术方案等非授权相关咨询,请在 Issues 中进行。

🔔 其他说明

什么是 AGPL-3.0 协议

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

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

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