feat(wxread): align pagination, rendering, and docs

2026-05-24 15:36:01 +08:00
parent a318c0e3d0
commit 2a94921e88
103 changed files with 6124 additions and 4623 deletions
@@ -1,6 +1,6 @@
 # Reflowable EPUB 使用 WXRead 风格原生渲染：详细设计

-> 文档目的：讨论并固化“将 ReadViewSDK 的 reflowable EPUB 渲染/排版/分页改为参考 Doc/WXRead 的微信读书（WXRead）原生渲染方式”的可落地设计，供后续开发与回归使用。  
+> 文档目的：讨论并固化“将 ReadViewSDK 的 reflowable EPUB 渲染/排版/分页改为参考 Doc/WXRead 的读书（WXRead）原生渲染方式”的可落地设计，供后续开发与回归使用。  
 > 版本：v0（设计草案）  
 > 日期：2026-05-21

@@ -79,7 +79,7 @@ ReadViewSDK 当前对 EPUB 有三类渲染路径：

 ## 4. 是否能直接使用 Doc/WXRead 中的 JS/CSS？

-结论：**不建议、也不应该直接把“来自微信读书 App bundle 的私有 JS/CSS”拷贝进 SDK 作为产品代码**；但可以按以下原则“选择性使用”：
+结论：**不建议、也不应该直接把“来自读书 App bundle 的私有 JS/CSS”拷贝进 SDK 作为产品代码**；但可以按以下原则“选择性使用”：

 ### 4.1 可以使用的情况（需满足其一）

@@ -91,7 +91,7 @@ ReadViewSDK 当前对 EPUB 有三类渲染路径：

 ### 4.2 不建议/不能直接使用的情况

- 无明确许可证头、看起来是微信读书私有逻辑/样式（例如 `weread-highlighter.js`、`MediaPlatform.js`、`replace.css` 等）：默认视为私有作品，不应直接拷贝使用。
+- 无明确许可证头、看起来是读书私有逻辑/样式（例如 `weread-highlighter.js`、`MediaPlatform.js`、`replace.css` 等）：默认视为私有作品，不应直接拷贝使用。
 - 即便是“Safari 默认样式”类文件（例如 `default.css` 的注释提到 Safari），也不建议直接照搬；我们可以根据需求写一份“SDK 自己的 default.css / replace.css”，只实现必要规则。

 ### 4.3 对本次需求的实际影响