docs: 固化 Pandoc 分发与内部许可策略
This commit is contained in:
+27
-8
@@ -1,6 +1,6 @@
|
||||
# v0.6.0 DOCX 导出与 Markdown 工具栏设计
|
||||
|
||||
状态:阶段 1 设计冻结,尚未开始功能实现。
|
||||
状态:阶段 1 架构已冻结;阶段 2 Pandoc 运行时与许可证方案已冻结。
|
||||
|
||||
## 1. 版本目标
|
||||
|
||||
@@ -153,15 +153,19 @@ Desktop 只提供平台运行时、传输与保存能力。
|
||||
|
||||
### 4.3 Pandoc 分发
|
||||
|
||||
- 开发环境允许通过显式配置或 `PATH` 使用本地 Pandoc;
|
||||
- Docker 镜像安装项目固定版本;
|
||||
- Windows Desktop 通过发行包资源目录携带固定版本;
|
||||
- 固定使用 Pandoc `3.9.0.2`,不在构建时跟随 latest;
|
||||
- 开发环境允许通过 `DOCX_PANDOC_PATH` 或 `PATH` 使用相同版本;
|
||||
- Docker amd64 使用官方 Linux 静态发行包,安装到
|
||||
`/opt/pandoc/3.9.0.2/`;
|
||||
- Windows Desktop 将官方 ZIP 中的 `pandoc.exe`、许可证和版权文件放入
|
||||
`process.resourcesPath` 下的固定资源目录;
|
||||
- 用户输入不得成为可执行路径或任意命令行参数;
|
||||
- 启动时或导出前校验版本,并通过 capability 状态报告不可用原因;
|
||||
- 发布前记录 Pandoc 许可证、源码获取方式和第三方声明;
|
||||
- 下一阶段实测 Docker 镜像与 Desktop 安装包的体积增量。
|
||||
- 启动时或导出前校验精确版本,并通过 capability 状态报告不可用原因;
|
||||
- 发行时保留 GPL、版权声明和精确版本源码获取方式;
|
||||
- Pandoc 继续作为独立子进程,不链接或导入其程序代码。
|
||||
|
||||
最终版本号和分发方式在阶段 2 根据许可证与实际包体测试冻结。
|
||||
官方文件、SHA-256、路径优先级、包体实测和许可证义务见
|
||||
[Pandoc 运行时与分发规范](PANDOC_DISTRIBUTION.md)。
|
||||
|
||||
### 4.4 动态 reference.docx
|
||||
|
||||
@@ -286,6 +290,21 @@ Front Matter 表单工具和 ECharts YAML 工具不在 `v0.6.0` 实现,但必
|
||||
DOCX 沿用当前无历史数据库原则。Markdown、图片、中间 PNG、动态模板和
|
||||
最终 DOCX 只存在于当前请求或桌面保存流程中。
|
||||
|
||||
### 6.4 当前项目许可与内部发行
|
||||
|
||||
- 当前仓库采用公司内部专属许可证,包元数据标记为 `UNLICENSED`;
|
||||
- 公司内部可以共享源码,并分发 Web/Docker、Desktop、ZIP 和测试产物;
|
||||
- 未经书面许可,不向公司外部或公开网络分发项目源码与二进制;
|
||||
- 用户文档和导出结果不因使用本软件而自动受项目许可证约束;
|
||||
- 三套 Typora 复制主题只允许随公司内部发行物分发;
|
||||
- Apache License 2.0 是未来公开 GitHub 时的候选许可证,不在当前阶段
|
||||
自动授予;
|
||||
- 公开前必须重新审查第三方依赖、主题、字体、Pandoc 源码义务及 Git
|
||||
历史。
|
||||
|
||||
根许可证和第三方边界分别见仓库根目录 `LICENSE` 与
|
||||
`THIRD_PARTY_NOTICES.md`。
|
||||
|
||||
## 7. 验收矩阵
|
||||
|
||||
### 7.1 文档内容
|
||||
|
||||
Reference in New Issue
Block a user