@lofcz/pptist 2.0.0 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,260 +1,260 @@
1
- <p align="center">
2
- <img src='/public/logo.png' />
3
- </p>
4
-
5
- [![GitHub stars](https://img.shields.io/github/stars/pipipi-pikachu/PPTist)](https://www.github.com/pipipi-pikachu/PPTist/stargazers)
6
- [![GitHub forks](https://img.shields.io/github/forks/pipipi-pikachu/PPTist)](https://www.github.com/pipipi-pikachu/PPTist/network/members)
7
- [![GitHub issues](https://img.shields.io/github/issues-closed/pipipi-pikachu/PPTist)](https://github.com/pipipi-pikachu/PPTist/issues)
8
- [![license](https://img.shields.io/github/license/pipipi-pikachu/PPTist)](https://www.github.com/pipipi-pikachu/PPTist/blob/master/LICENSE)
9
- [![Gitee stars](https://gitee.com/pptist/PPTist/badge/star.svg?theme=gvp)](https://gitee.com/pptist/PPTist)
10
- [![Gitcode stars](https://gitcode.com/pipipi-pikachu/PPTist/star/badge.svg)](https://gitcode.com/pipipi-pikachu/PPTist)
11
-
12
- [简体中文](README_zh.md) | English
13
-
14
-
15
- # 🎨 PPTist
16
- **PowerPoint-ist(/'pauəpɔintist/)**, A web-based presentation (slideshow) application. This application replicates most of the commonly used features of Microsoft Office PowerPoint. It supports various essential element types such as text, images, shapes, lines, charts, tables, videos, audio, and formulas. You can edit and present slides directly in a web browser.
17
-
18
- **Try it online👉:[https://pipipi-pikachu.github.io/PPTist/](https://pipipi-pikachu.github.io/PPTist/)**
19
-
20
- > China Mirrors (Synchronized Regularly): [Gitee](https://gitee.com/pptist/PPTist)、[GitCode](https://gitcode.com/pipipi-pikachu/PPTist)
21
-
22
-
23
- # ✨ Highlights
24
- 1. **Easy Development**: Built with Vue 3.x and TypeScript, it does not rely on UI component libraries and avoids third-party components as much as possible. This makes styling customization easier and functionality extension more convenient.
25
- 2. **User Friendly**: It offers a context menu available everywhere, dozens of keyboard shortcuts, and countless editing detail optimizations, striving to replicate a desktop application-level experience.
26
- 3. **Feature Rich**: Supports most of the commonly used elements and functionalities found in PowerPoint, supports generate PPT by AI, supports exporting in various formats, and offers basic editing and previewing on mobile devices.
27
-
28
-
29
- # 👀 Front-Row Reminder
30
- 1. The target audience for this project is developers with web slide development needs and basic web development experience. The provided link is for demonstration purposes only and does not offer any online services. This project should not be used directly as a tool, nor does it support out-of-the-box use. If you simply need a ready-made service or tool, please consider other products.
31
- 2. Here are some summarized [Frequently Asked Questions](/doc/Q&A.md). When raising Issues or submitting PRs for the first time, be sure to read this document in advance.
32
- 3. For commercial use, please refer to [商业用途](#-商业用途)
33
-
34
-
35
- # 🧩 Project Positioning
36
- > This project is strictly positioned as a Web Slide Editing/Presentation Application. It is not intended to be an ~~AI PPT generator, low-code platform, or image editor~~. The following are the recommendation levels for common use cases:
37
-
38
- - **Low-code Platforms / H5 Editors / Image Editors / Whiteboards** (Recommendation: Not Recommended): We suggest choosing open-source projects specifically designed for those purposes.
39
- - **PPT File Preview Tool** (Recommendation: ⭐): The ability to import .pptx files is limited (roughly 70%~80% fidelity). Unless your requirements for preview accuracy are low and you only need basic content display, this is not recommended.
40
- - **AI PPT Generation Tool** (Recommendation: ⭐⭐): While the project provides basic template-based AI generation, it is not the core focus. As AI technology evolves (moving from templates to HTML-based or image-based generation), this project will not necessarily follow those trends. However, if you wish to build a template-based AI generator and are willing to implement your own generation logic, PPTist’s robust editing capabilities make it a strong foundation.
41
- - **Office PPT Authoring Tool** (Recommendation: ⭐⭐): PPTist supports many common Office features and basic .pptx export. However, exports are not 100% identical to the original, and as mentioned, import capabilities are limited. Choose this only if you can accept these limitations.
42
- - **Web Slide Editing/Presentation App** (Recommendation: ⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐): This is the primary use case. The core strengths of PPTist are its editing capabilities and user experience. You can build upon this project to customize or add unique nodes and features tailored to your specific needs, where Office compatibility is not the ultimate goal. **Summary: Our vision is for you to use PPTist to create a presentation product that is distinct from Microsoft Office, rather than just using it as a middleman for editing Office files.**
43
-
44
-
45
- # 🚀 Installation
46
- > node.js version >= 20
47
-
48
- ```
49
- npm install
50
-
51
- npm run dev
52
- ```
53
- Browser access: http://127.0.0.1:5173/
54
-
55
-
56
- # 📚 Features
57
- ### Basic Features
58
- - History (undo, redo)
59
- - Shortcuts
60
- - Right-click menu
61
- - Export local files (PPTX, JSON, images, PDF)
62
- - Import and export pptist files
63
- - Print
64
- - AI PPT
65
- ### Slide Page Editing
66
- - Add/delete pages
67
- - Copy/paste pages
68
- - Adjust page order
69
- - Create sections
70
- - Background settings (solid color, gradient, image)
71
- - Set canvas size
72
- - Gridlines
73
- - Rulers
74
- - Canvas zoom and move
75
- - Theme settings
76
- - Extract slides style
77
- - Speaker notes (rich text)
78
- - Slide templates
79
- - Transition animations
80
- - Element animations (entrance, exit, emphasis)
81
- - Selection panel (hide elements, layer sorting, element naming)
82
- - Labels for Page and Node Types (usable for template-related features)
83
- - Find/replace
84
- - Annotations
85
- ### Slide Element Editing
86
- - Add/delete elements
87
- - Copy/paste elements
88
- - Drag and move elements
89
- - Rotate elements
90
- - Scale elements
91
- - Multiple element selection (marquee, point selection)
92
- - Group multiple elements
93
- - Batch edit multiple elements
94
- - Lock elements
95
- - Magnetic alignment of elements (move and scale)
96
- - Adjust element layer
97
- - Align elements to canvas
98
- - Align elements to other elements
99
- - Evenly distribute multiple elements
100
- - Drag to add text and images
101
- - Paste external images
102
- - Set element coordinates, size, and rotation
103
- - Element hyperlinks (link to webpage, link to other slide pages)
104
- - Element bubble menu (Floating toolbar)
105
- #### Text
106
- - Rich text editing (color, highlight, font, font size, bold, italic, underline, strikethrough, subscript, inline code, quote, hyperlink, alignment, numbering, bullet points, paragraph indent, clear formatting)
107
- - Line height
108
- - Character spacing
109
- - Paragraph spacing
110
- - First line indent
111
- - Fill color
112
- - Border
113
- - Shadow
114
- - Transparency
115
- - Vertical text
116
- - AI Rewrite/Expand/Abbreviate
117
- #### Images
118
- - Crop (custom, shape, aspect ratio)
119
- - Rounding
120
- - Filters
121
- - Tint (mask)
122
- - Flip
123
- - Border
124
- - Shadow
125
- - Replace image
126
- - Reset image
127
- - Set as background
128
- #### Shapes
129
- - Draw any polygon
130
- - Draw any line (unclosed shape simulation)
131
- - Replace shape
132
- - Fill (solid color, gradient, image)
133
- - Border
134
- - Shadow
135
- - Transparency
136
- - Flip
137
- - Shape format painter
138
- - Edit text (supports rich text, similar to text element’s rich text editing)
139
- #### Lines
140
- - Straight lines, polylines, curves
141
- - Color
142
- - Width
143
- - Style (solid, dashed, dotted)
144
- - Endpoint style
145
- #### Charts (bar, column, line, area, scatter, pie, donut, radar)
146
- - Chart type conversion
147
- - Data editing
148
- - Background fill
149
- - Theme color
150
- - Coordinate system and axis text color
151
- - Grid color
152
- - Other chart settings
153
- - Border
154
- #### Tables
155
- - Add/delete rows and columns
156
- - Theme settings (theme color, header, total row, first column, last column)
157
- - Merge cells
158
- - Cell styles (fill color, text color, bold, italic, underline, strikethrough, alignment)
159
- - Border
160
- #### Video
161
- - Preview cover settings
162
- - Auto play
163
- #### Audio
164
- - Icon color
165
- - Auto play
166
- - Loop play
167
- #### Formulas
168
- - LaTeX editing
169
- - Color settings
170
- - Formula line thickness settings
171
- ### Slide Show
172
- - Brush tools (pen/shape/arrow/highlighter annotation, eraser, blackboard mode)
173
- - Preview all slides
174
- - Bottom thumbnails navigation
175
- - Timer tool
176
- - Laser pointer
177
- - Auto play
178
- - Speaker view
179
- - Audience view
180
- ### Mobile
181
- - Basic editing
182
- - Add/delete/copy/note/undo redo pages
183
- - Insert text, images, rectangles, circles
184
- - General element operations: move, scale, rotate, copy, delete, layer adjust, align
185
- - Element styles: text (bold, italic, underline, strikethrough, font size, color, alignment), fill color
186
- - Basic preview
187
- - Play preview
188
-
189
-
190
- # 👀 FAQ
191
- Some common problems: [FAQ](/doc/Q&A.md)
192
-
193
-
194
- # 🎯 Supplement
195
- There is currently no complete development documentation, but the following documents may be of some help to you:
196
- - [Project Directory and Data Structure](/doc/DirectoryAndData.md)
197
- - [Fundamentals of Canvas and Elements](/doc/Canvas.md)
198
- - [How to Customize an Element](/doc/CustomElement.md)
199
- - [About AIPPT](/doc/AIPPT.md)
200
-
201
- Here are some auxiliary development tools/repositories:
202
- - Import PPTX file reference: [pptxtojson](https://github.com/pipipi-pikachu/pptxtojson)
203
- - Draw shape: [svgPathCreator](https://github.com/pipipi-pikachu/svgPathCreator)
204
-
205
-
206
- # 📄 License
207
- [AGPL-3.0 License](https://github.com/pipipi-pikachu/PPTist/blob/master/LICENSE) | Copyright © 2020-PRESENT [pipipi-pikachu](https://github.com/pipipi-pikachu)
208
-
209
- # 🧮 Commercial
210
- If you wish to use this project for commercial gain, I hope you will respect open source and strictly adhere to the AGPL-3.0 license, giving back to the open source community. Or contact the author for an independent commercial license.
211
-
212
-
213
-
214
-
215
-
216
- # 🧮 商业用途
217
- - 本项目禁止闭源商用,如果你希望将其用于商业项目,请尊重开源,**严格遵循 [AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)**,回馈开源社区;
218
- - 如果你因为任何原因,无法执行 AGPL-3.0 协议,可以选择:
219
- 1. 使用 Apache 2.0 协议版本(最后更新时间为2022年5月,已停止维护,[点此下载](https://github.com/pipipi-pikachu/PPTist/archive/f1a35bb8e045124e37dcafd6acbf40b4531b69aa.zip));
220
- 2. 成为项目的重要贡献者(先违反协议后再成为贡献者不适用此项),包括:
221
- - 你的代码被本项目作为依赖引用,包括:npm安装、文件引用、代码片段引用(引用处会注明);
222
- - 你给本项目提交过重要的 PR 或 Issue(由作者主观判断,符合的 PR 或 Issue 会打上`important contribution`标签);
223
- 3. [邮件联系作者](mailto:pipipi_pikachu@163.com)付费获取独立的商业授权(违反协议后被作者找到的不适用此项)。独立授权价格:
224
- - 一年:2999元;
225
- - 永久:5699元(不含税);
226
- - 请优先考虑执行AGPL-3.0协议,如需付费获取独立的商业授权,请务必在联系作者前阅读以下内容:
227
- - **独立商业授权表示**:
228
- - 作者单独出具商业授权协议文件(邮件联系作者获取),双方按流程签署协议;
229
- - 允许将代码用于商业行为,且不必执行 AGPL-3.0 协议;
230
- - 授权对象可以是个人或组织(企业),允许授权对象名下的所有产品使用本项目代码;
231
- - **授权流程**:
232
- 1. 被授权方确认协议内容,若无异议,需提供协议中所需的个人/企业信息;
233
- 2. 由作者补充好协议双方信息后打印签字,并将电子扫描件发给被授权方;
234
- 3. 被授权方收到后,将协议打印盖章,再扫描电子档发回给作者,此时协议开始生效;
235
- 4. 被授权方在协议规定时间内支付费用,并保留好支付凭证,授权结束;
236
- - **授权不等于出售软件或服务**:
237
- - 不存在其他“商业版本”、不提供任何API/SDK/在线服务/技术支持/技术咨询/定制开发;
238
- - 不提供可直接交付的产品,你仍需从本仓库获取代码自行开发;
239
- - 该软件无法开箱即用,至少也得自行接入后端能力(需要有最基本的web开发经验);
240
- - 不保证未来版本的兼容性,不保证代码没有bug;
241
- - 作者不承担任何因使用本项目代码而导致的直接或间接损失;
242
- - 务必提前做好调研,判断该软件是否符合需求,包括但不限于功能(是否能满足业务需求)和开发(是否上手当前技术栈/实现方案);
243
- - 不接受[黑名单/耻辱柱](/doc/Blacklist.md)或存在违反协议行为的对象通过任何形式获取商业授权;
244
- - 作者倡导异步沟通(正式、信息整合度高),**不加私人微信/QQ/手机号等**,有任何授权相关疑问请邮件联系,谢谢理解;
245
- - 提需求/报bug/询问技术方案等非授权相关咨询,请在 [Issues](https://github.com/pipipi-pikachu/PPTist/issues) 中进行。
246
-
247
-
248
- # 🔔 其他说明
249
- ## 什么是 AGPL-3.0 协议
250
- 协议的核心要求用通俗的语言解释如下:
251
- - **开源义务**:如果你用了 AGPL 的代码,无论你或你的下游怎么使用/修改,都必须把你最终的代码全部完整公开出来(不只是给出修改的部分,也不是说换个框架重写一遍就能和原始代码脱离关系了),并继续以 AGPL 协议开源(强调:必须延续 AGPL 协议,保持开源的传染性,不能更换其他协议)。
252
- - **网络服务也要开源**:即使你只是用 AGPL 的代码做了一个网站或网络服务,别人通过网络用你的服务时,你也需要遵守上一条**开源义务**。
253
- - **保留版权声明**:你不能删掉代码里原来的作者信息和许可证声明,得告诉大家这代码是从哪儿来的。
254
- - **不能加额外限制**:你不能在衍生出来的 AGPL 代码上加一些限制,比如不让别人再分发代码,或者要求别人付费才能使用代码(包括但不限于:要求别人购买授权/服务/产品等)。
255
- - **免责声明**:作者不保证代码没有 bug,也不对使用后果负责。
256
-
257
- > 详细协议内容见官方文档:[AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)
258
-
259
- ## 声明
1
+ <p align="center">
2
+ <img src='/public/logo.png' />
3
+ </p>
4
+
5
+ [![GitHub stars](https://img.shields.io/github/stars/pipipi-pikachu/PPTist)](https://www.github.com/pipipi-pikachu/PPTist/stargazers)
6
+ [![GitHub forks](https://img.shields.io/github/forks/pipipi-pikachu/PPTist)](https://www.github.com/pipipi-pikachu/PPTist/network/members)
7
+ [![GitHub issues](https://img.shields.io/github/issues-closed/pipipi-pikachu/PPTist)](https://github.com/pipipi-pikachu/PPTist/issues)
8
+ [![license](https://img.shields.io/github/license/pipipi-pikachu/PPTist)](https://www.github.com/pipipi-pikachu/PPTist/blob/master/LICENSE)
9
+ [![Gitee stars](https://gitee.com/pptist/PPTist/badge/star.svg?theme=gvp)](https://gitee.com/pptist/PPTist)
10
+ [![Gitcode stars](https://gitcode.com/pipipi-pikachu/PPTist/star/badge.svg)](https://gitcode.com/pipipi-pikachu/PPTist)
11
+
12
+ [简体中文](README_zh.md) | English
13
+
14
+
15
+ # 🎨 PPTist
16
+ **PowerPoint-ist(/'pauəpɔintist/)**, A web-based presentation (slideshow) application. This application replicates most of the commonly used features of Microsoft Office PowerPoint. It supports various essential element types such as text, images, shapes, lines, charts, tables, videos, audio, and formulas. You can edit and present slides directly in a web browser.
17
+
18
+ **Try it online👉:[https://pipipi-pikachu.github.io/PPTist/](https://pipipi-pikachu.github.io/PPTist/)**
19
+
20
+ > China Mirrors (Synchronized Regularly): [Gitee](https://gitee.com/pptist/PPTist)、[GitCode](https://gitcode.com/pipipi-pikachu/PPTist)
21
+
22
+
23
+ # ✨ Highlights
24
+ 1. **Easy Development**: Built with Vue 3.x and TypeScript, it does not rely on UI component libraries and avoids third-party components as much as possible. This makes styling customization easier and functionality extension more convenient.
25
+ 2. **User Friendly**: It offers a context menu available everywhere, dozens of keyboard shortcuts, and countless editing detail optimizations, striving to replicate a desktop application-level experience.
26
+ 3. **Feature Rich**: Supports most of the commonly used elements and functionalities found in PowerPoint, supports generate PPT by AI, supports exporting in various formats, and offers basic editing and previewing on mobile devices.
27
+
28
+
29
+ # 👀 Front-Row Reminder
30
+ 1. The target audience for this project is developers with web slide development needs and basic web development experience. The provided link is for demonstration purposes only and does not offer any online services. This project should not be used directly as a tool, nor does it support out-of-the-box use. If you simply need a ready-made service or tool, please consider other products.
31
+ 2. Here are some summarized [Frequently Asked Questions](/doc/Q&A.md). When raising Issues or submitting PRs for the first time, be sure to read this document in advance.
32
+ 3. For commercial use, please refer to [商业用途](#-商业用途)
33
+
34
+
35
+ # 🧩 Project Positioning
36
+ > This project is strictly positioned as a Web Slide Editing/Presentation Application. It is not intended to be an ~~AI PPT generator, low-code platform, or image editor~~. The following are the recommendation levels for common use cases:
37
+
38
+ - **Low-code Platforms / H5 Editors / Image Editors / Whiteboards** (Recommendation: Not Recommended): We suggest choosing open-source projects specifically designed for those purposes.
39
+ - **PPT File Preview Tool** (Recommendation: ⭐): The ability to import .pptx files is limited (roughly 70%~80% fidelity). Unless your requirements for preview accuracy are low and you only need basic content display, this is not recommended.
40
+ - **AI PPT Generation Tool** (Recommendation: ⭐⭐): While the project provides basic template-based AI generation, it is not the core focus. As AI technology evolves (moving from templates to HTML-based or image-based generation), this project will not necessarily follow those trends. However, if you wish to build a template-based AI generator and are willing to implement your own generation logic, PPTist’s robust editing capabilities make it a strong foundation.
41
+ - **Office PPT Authoring Tool** (Recommendation: ⭐⭐): PPTist supports many common Office features and basic .pptx export. However, exports are not 100% identical to the original, and as mentioned, import capabilities are limited. Choose this only if you can accept these limitations.
42
+ - **Web Slide Editing/Presentation App** (Recommendation: ⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐): This is the primary use case. The core strengths of PPTist are its editing capabilities and user experience. You can build upon this project to customize or add unique nodes and features tailored to your specific needs, where Office compatibility is not the ultimate goal. **Summary: Our vision is for you to use PPTist to create a presentation product that is distinct from Microsoft Office, rather than just using it as a middleman for editing Office files.**
43
+
44
+
45
+ # 🚀 Installation
46
+ > node.js version >= 20
47
+
48
+ ```
49
+ npm install
50
+
51
+ npm run dev
52
+ ```
53
+ Browser access: http://127.0.0.1:5173/
54
+
55
+
56
+ # 📚 Features
57
+ ### Basic Features
58
+ - History (undo, redo)
59
+ - Shortcuts
60
+ - Right-click menu
61
+ - Export local files (PPTX, JSON, images, PDF)
62
+ - Import and export pptist files
63
+ - Print
64
+ - AI PPT
65
+ ### Slide Page Editing
66
+ - Add/delete pages
67
+ - Copy/paste pages
68
+ - Adjust page order
69
+ - Create sections
70
+ - Background settings (solid color, gradient, image)
71
+ - Set canvas size
72
+ - Gridlines
73
+ - Rulers
74
+ - Canvas zoom and move
75
+ - Theme settings
76
+ - Extract slides style
77
+ - Speaker notes (rich text)
78
+ - Slide templates
79
+ - Transition animations
80
+ - Element animations (entrance, exit, emphasis)
81
+ - Selection panel (hide elements, layer sorting, element naming)
82
+ - Labels for Page and Node Types (usable for template-related features)
83
+ - Find/replace
84
+ - Annotations
85
+ ### Slide Element Editing
86
+ - Add/delete elements
87
+ - Copy/paste elements
88
+ - Drag and move elements
89
+ - Rotate elements
90
+ - Scale elements
91
+ - Multiple element selection (marquee, point selection)
92
+ - Group multiple elements
93
+ - Batch edit multiple elements
94
+ - Lock elements
95
+ - Magnetic alignment of elements (move and scale)
96
+ - Adjust element layer
97
+ - Align elements to canvas
98
+ - Align elements to other elements
99
+ - Evenly distribute multiple elements
100
+ - Drag to add text and images
101
+ - Paste external images
102
+ - Set element coordinates, size, and rotation
103
+ - Element hyperlinks (link to webpage, link to other slide pages)
104
+ - Element bubble menu (Floating toolbar)
105
+ #### Text
106
+ - Rich text editing (color, highlight, font, font size, bold, italic, underline, strikethrough, subscript, inline code, quote, hyperlink, alignment, numbering, bullet points, paragraph indent, clear formatting)
107
+ - Line height
108
+ - Character spacing
109
+ - Paragraph spacing
110
+ - First line indent
111
+ - Fill color
112
+ - Border
113
+ - Shadow
114
+ - Transparency
115
+ - Vertical text
116
+ - AI Rewrite/Expand/Abbreviate
117
+ #### Images
118
+ - Crop (custom, shape, aspect ratio)
119
+ - Rounding
120
+ - Filters
121
+ - Tint (mask)
122
+ - Flip
123
+ - Border
124
+ - Shadow
125
+ - Replace image
126
+ - Reset image
127
+ - Set as background
128
+ #### Shapes
129
+ - Draw any polygon
130
+ - Draw any line (unclosed shape simulation)
131
+ - Replace shape
132
+ - Fill (solid color, gradient, image)
133
+ - Border
134
+ - Shadow
135
+ - Transparency
136
+ - Flip
137
+ - Shape format painter
138
+ - Edit text (supports rich text, similar to text element’s rich text editing)
139
+ #### Lines
140
+ - Straight lines, polylines, curves
141
+ - Color
142
+ - Width
143
+ - Style (solid, dashed, dotted)
144
+ - Endpoint style
145
+ #### Charts (bar, column, line, area, scatter, pie, donut, radar)
146
+ - Chart type conversion
147
+ - Data editing
148
+ - Background fill
149
+ - Theme color
150
+ - Coordinate system and axis text color
151
+ - Grid color
152
+ - Other chart settings
153
+ - Border
154
+ #### Tables
155
+ - Add/delete rows and columns
156
+ - Theme settings (theme color, header, total row, first column, last column)
157
+ - Merge cells
158
+ - Cell styles (fill color, text color, bold, italic, underline, strikethrough, alignment)
159
+ - Border
160
+ #### Video
161
+ - Preview cover settings
162
+ - Auto play
163
+ #### Audio
164
+ - Icon color
165
+ - Auto play
166
+ - Loop play
167
+ #### Formulas
168
+ - LaTeX editing
169
+ - Color settings
170
+ - Formula line thickness settings
171
+ ### Slide Show
172
+ - Brush tools (pen/shape/arrow/highlighter annotation, eraser, blackboard mode)
173
+ - Preview all slides
174
+ - Bottom thumbnails navigation
175
+ - Timer tool
176
+ - Laser pointer
177
+ - Auto play
178
+ - Speaker view
179
+ - Audience view
180
+ ### Mobile
181
+ - Basic editing
182
+ - Add/delete/copy/note/undo redo pages
183
+ - Insert text, images, rectangles, circles
184
+ - General element operations: move, scale, rotate, copy, delete, layer adjust, align
185
+ - Element styles: text (bold, italic, underline, strikethrough, font size, color, alignment), fill color
186
+ - Basic preview
187
+ - Play preview
188
+
189
+
190
+ # 👀 FAQ
191
+ Some common problems: [FAQ](/doc/Q&A.md)
192
+
193
+
194
+ # 🎯 Supplement
195
+ There is currently no complete development documentation, but the following documents may be of some help to you:
196
+ - [Project Directory and Data Structure](/doc/DirectoryAndData.md)
197
+ - [Fundamentals of Canvas and Elements](/doc/Canvas.md)
198
+ - [How to Customize an Element](/doc/CustomElement.md)
199
+ - [About AIPPT](/doc/AIPPT.md)
200
+
201
+ Here are some auxiliary development tools/repositories:
202
+ - Import PPTX file reference: [pptxtojson](https://github.com/pipipi-pikachu/pptxtojson)
203
+ - Draw shape: [svgPathCreator](https://github.com/pipipi-pikachu/svgPathCreator)
204
+
205
+
206
+ # 📄 License
207
+ [AGPL-3.0 License](https://github.com/pipipi-pikachu/PPTist/blob/master/LICENSE) | Copyright © 2020-PRESENT [pipipi-pikachu](https://github.com/pipipi-pikachu)
208
+
209
+ # 🧮 Commercial
210
+ If you wish to use this project for commercial gain, I hope you will respect open source and strictly adhere to the AGPL-3.0 license, giving back to the open source community. Or contact the author for an independent commercial license.
211
+
212
+
213
+
214
+
215
+
216
+ # 🧮 商业用途
217
+ - 本项目禁止闭源商用,如果你希望将其用于商业项目,请尊重开源,**严格遵循 [AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)**,回馈开源社区;
218
+ - 如果你因为任何原因,无法执行 AGPL-3.0 协议,可以选择:
219
+ 1. 使用 Apache 2.0 协议版本(最后更新时间为2022年5月,已停止维护,[点此下载](https://github.com/pipipi-pikachu/PPTist/archive/f1a35bb8e045124e37dcafd6acbf40b4531b69aa.zip));
220
+ 2. 成为项目的重要贡献者(先违反协议后再成为贡献者不适用此项),包括:
221
+ - 你的代码被本项目作为依赖引用,包括:npm安装、文件引用、代码片段引用(引用处会注明);
222
+ - 你给本项目提交过重要的 PR 或 Issue(由作者主观判断,符合的 PR 或 Issue 会打上`important contribution`标签);
223
+ 3. [邮件联系作者](mailto:pipipi_pikachu@163.com)付费获取独立的商业授权(违反协议后被作者找到的不适用此项)。独立授权价格:
224
+ - 一年:2999元;
225
+ - 永久:5699元(不含税);
226
+ - 请优先考虑执行AGPL-3.0协议,如需付费获取独立的商业授权,请务必在联系作者前阅读以下内容:
227
+ - **独立商业授权表示**:
228
+ - 作者单独出具商业授权协议文件(邮件联系作者获取),双方按流程签署协议;
229
+ - 允许将代码用于商业行为,且不必执行 AGPL-3.0 协议;
230
+ - 授权对象可以是个人或组织(企业),允许授权对象名下的所有产品使用本项目代码;
231
+ - **授权流程**:
232
+ 1. 被授权方确认协议内容,若无异议,需提供协议中所需的个人/企业信息;
233
+ 2. 由作者补充好协议双方信息后打印签字,并将电子扫描件发给被授权方;
234
+ 3. 被授权方收到后,将协议打印盖章,再扫描电子档发回给作者,此时协议开始生效;
235
+ 4. 被授权方在协议规定时间内支付费用,并保留好支付凭证,授权结束;
236
+ - **授权不等于出售软件或服务**:
237
+ - 不存在其他“商业版本”、不提供任何API/SDK/在线服务/技术支持/技术咨询/定制开发;
238
+ - 不提供可直接交付的产品,你仍需从本仓库获取代码自行开发;
239
+ - 该软件无法开箱即用,至少也得自行接入后端能力(需要有最基本的web开发经验);
240
+ - 不保证未来版本的兼容性,不保证代码没有bug;
241
+ - 作者不承担任何因使用本项目代码而导致的直接或间接损失;
242
+ - 务必提前做好调研,判断该软件是否符合需求,包括但不限于功能(是否能满足业务需求)和开发(是否上手当前技术栈/实现方案);
243
+ - 不接受[黑名单/耻辱柱](/doc/Blacklist.md)或存在违反协议行为的对象通过任何形式获取商业授权;
244
+ - 作者倡导异步沟通(正式、信息整合度高),**不加私人微信/QQ/手机号等**,有任何授权相关疑问请邮件联系,谢谢理解;
245
+ - 提需求/报bug/询问技术方案等非授权相关咨询,请在 [Issues](https://github.com/pipipi-pikachu/PPTist/issues) 中进行。
246
+
247
+
248
+ # 🔔 其他说明
249
+ ## 什么是 AGPL-3.0 协议
250
+ 协议的核心要求用通俗的语言解释如下:
251
+ - **开源义务**:如果你用了 AGPL 的代码,无论你或你的下游怎么使用/修改,都必须把你最终的代码全部完整公开出来(不只是给出修改的部分,也不是说换个框架重写一遍就能和原始代码脱离关系了),并继续以 AGPL 协议开源(强调:必须延续 AGPL 协议,保持开源的传染性,不能更换其他协议)。
252
+ - **网络服务也要开源**:即使你只是用 AGPL 的代码做了一个网站或网络服务,别人通过网络用你的服务时,你也需要遵守上一条**开源义务**。
253
+ - **保留版权声明**:你不能删掉代码里原来的作者信息和许可证声明,得告诉大家这代码是从哪儿来的。
254
+ - **不能加额外限制**:你不能在衍生出来的 AGPL 代码上加一些限制,比如不让别人再分发代码,或者要求别人付费才能使用代码(包括但不限于:要求别人购买授权/服务/产品等)。
255
+ - **免责声明**:作者不保证代码没有 bug,也不对使用后果负责。
256
+
257
+ > 详细协议内容见官方文档:[AGPL-3.0 协议](https://www.gnu.org/licenses/agpl-3.0.html)
258
+
259
+ ## 声明
260
260
  一些仓库基于本项目代码进行二次开发,但未遵守AGPL-3.0协议,擅自删除了AGPL-3.0协议许可证声明或改用其他协议,作者在此提醒:**这些仓库代码事实上仍受AGPL-3.0协议约束,切勿受其误导陷入侵权纠纷。**