refactor(res): polish appHelp.md

app/src/main/assets/help/appHelp.md

@@ -1,190 +1,215 @@
 # 帮助文档
 
-## **新人必读** 
+【温馨提醒】 *本帮助可以在“**我的**”——右上角帮助按钮再次打开，更新前一定要做好备份，以免数据丢失！*
 
-【温馨提醒】 *本帮助可以在我的-右上角帮助按钮再次打开，更新前一定要做好备份，以免数据丢失！*
+## 新人必读 
 
-1. 为什么第一次安装好之后什么东西都没有？
+### 1. 为什么第一次安装好之后什么东西都没有？
-* 阅读只是一个转码工具，不提供内容，第一次安装app，需要自己手动导入书源，可以从公众号 **[开源阅读]**、QQ群、酷安评论里获取由书友制作分享的书源。
+阅读只是一个转码工具，不提供内容，第一次安装 APP，需要自己手动导入书源，可以从公众号 **【开源阅读】**、QQ 群或酷安评论里获取由书友制作分享的书源。
 
-2. 正文出现缺字漏字、内容缺失、排版错乱等情况，如何处理？
+### 2. 正文出现缺字漏字、内容缺失或排版错乱等情况，如何处理？
-* 有可能是净化规则出现问题，先关闭替换净化并刷新，再观察是否正常。如果正常说明净化规则存在误杀，如果关闭后仍然出现相关问题，请点击源链接查看原文与正文是否相同，如果不同，再进行反馈。
+有可能是净化规则出现问题，先关闭替换净化并刷新，再观察是否正常。如果正常说明净化规则存在误杀，如果关闭后仍然出现相关问题，请点击源链接查看原文与正文是否相同，如果不同，再进行反馈。
 
-3. 漫画源看书显示乱码，如何解决？
+### 3. 漫画源看书显示乱码，如何解决？
-* 异次元和阅读是两个不同的软件，**两个软件的源并不通用**，请导入阅读的支持的漫画源！
+【异次元】和【阅读】是两个不同的软件，**两个软件的源并不通用**，请导入【阅读】的支持的漫画源！
 
 ## 书源相关
 
-1. 如何导入本地书源文件？
+### 1. 如何导入本地书源文件？
-* 下载群文件里的书源文件（书源格式后缀有txt、json，其中json文件某些情况下无法导入，需要修改后缀为txt格式才可导入）；
+以导入 QQ 接收到的书源文件为例：
-* 打开阅读软件；
+* 下载群文件里的书源文件；
-* 我的 - 点击“书源管理”；
+* 打开【阅读】软件；
-* 点击右上角选择“本地导入”；
+* 点击“**我的**”——“**书源管理**”；
+* 点击右上角选择“**本地导入**”；
 * 左下角选择书源文件所在的路径；
 * 点击书源文件导入；
 * 导入后返回书源管理界面；
-* 新版qq下载路径:Android/data/com.tencent.mobileqq/Tencent/QQfile_recv/
 
-![QQ导入书源](https://cdn.jsdelivr.net/gh/gedoor/gedoor.github.io@master/images/importSource.jpg)
+**【注】** 
+1. *新版 QQ 文件下载路径：`Android/data/com.tencent.mobileqq/Tencent/QQfile_recv/`。*
+2. *书源格式后缀有 .txt 和 .json，其中 .json 文件在某些情况下可能无法导入，需要修改后缀为 .txt 才可导入。*
+
+![QQ 导入书源](https://cdn.jsdelivr.net/gh/gedoor/gedoor.github.io@master/images/importSource.jpg)
 
-2. 如何新建大佬发的单独书源？
+### 2. 如何新建大佬发的单独书源？
 * 复制书源代码；
 * 打开阅读软件；
-* 我的 - 点击“书源管理”；
+* 点击“**我的**”——“**书源管理**”；
-* 右上角选择“新建书源”；
+* 右上角“**⁝**”——“**+ 新建书源**”；
-* 进入新建书源后点击右上角“粘贴源”；
+* 进入后点击右上角“**⁝**”——“**粘贴源**”；
-* 粘贴书源完成后点击上方保存；
+* 粘贴完成后点击上方保存“**🖫**”按钮；
 * 本次新建单独书源操作完成。
-* 注：如果书源有错误或者复制不全会显示格式错误，请重新复制。
 
-3. 为什么导入2.0书源后无法阅读？
+**【注】** *如果书源有错误或者复制不全会显示格式错误，请重新复制。*
-* 部分2.0书源并不适用于3.0版本的阅读，建议导入后进行筛选。
 
-4. 阅读2.0数据如何导入阅读3.0？
+### 3. 为什么导入 2.0 书源后无法阅读？
-* 先对阅读2.0的数据进行备份，然后进入阅读3.0，点击“我的”，选择“备份与恢复”，再点击“导入旧版本数据”。
+部分 2.0 书源并不适用于 3.0 版本的阅读，建议导入后进行筛选。
 
-5. 如何给朋友分享我的书源？
+### 4. 【阅读】2.0 数据如何导入【阅读】3.0？
-* 打开阅读软件；
+先对【阅读】2.0 的数据进行备份，然后进入【阅读】3.0，点击“**我的**”，选择“**备份与恢复**”，再点击“**导入旧版本数据**”。
+
+### 5. 如何给朋友分享我的书源？
+* 打开【阅读】软件；
 * 点击备份；
-* 打开手机自带的文件管理；
+* 打开手机系统自带的文件管理；
-* 手机自带内存根目录找到YueDu3.0文件夹；
+* 在手机内置存储根目录找到 `YueDu3.0` 文件夹；
-* 找到myBookSource.json长按选择分享；
+* 找到 `myBookSource.json`，长按选择分享；
-* 选择微信分享或者QQ分享；
+* 选择微信分享或者 QQ 分享；
 * 选择你要分享的好友点击发送；
-* 好友接收后在手机自带内存根目录找到myBookSource.json文件（最新版QQ 安卓10及以下版本在Android/data/com.tencent.mobileqq/Tencent/QQfile_recv/,安卓11版本用户由于系统限制无法访问data目录,微信在Tencent/MicroMsg/Download）；
+* 好友接收后在手机内置存储根目录找到 `myBookSource.json` 文件；
-* 复制该文件到手机自带内存根目录找到YueDu3.0文件夹（如已有该文件请先删除该文件或者备份到其他地方再复制到文件夹）；
+* 复制该文件到手机内置存储根目录找到 `YueDu3.0` 文件夹（如已有该文件请先删除该文件或者备份到其他地方再复制到文件夹）；
-* 打开阅读软件点击恢复。
+* 打开【阅读】软件点击恢复。
-* 注：备份路径如已修改过请在修改后的路径下查找书源文件。
 
-6. 效验书源显示失效就说明书源不能用了吗？
+**【注】**
-* 效验书源只是测试书源，可以做个参考，失效了不代表书源不能用了。
+1. *备份路径如已修改过请在修改后的路径下查找书源文件。*
+2. *Android 10 及以下版本系统，新版 QQ 文件接收路径在 `Android/data/com.tencent.mobileqq/Tencent/QQfile_recv/`，旧版 QQ 文件接收路径则在 `Tencent/QQfile_recv/`；新版微信文件接收路径在 `Android/data/com.tencent.mobileqq/Tencent/MicroMsg/Download`，旧版微信文件接收路径则在 `Tencent/MicroMsg/Download`。*
+3. *Android 11 及以上系统版本用户，由于系统限制，无法访问 `Android/data` 目录。*
 
-7. 发现和正版书源能不能使用？
+### 6. 效验书源显示失效就说明书源不能用了吗？
-* 发现和正版书源只能用来找书，看排行榜，不能用来看书，如需看书请切换书源。
+效验书源只是测试书源，可以做为参考，但失效了不代表书源不能用了。
 
-8. 为什么书源这么多，发现里却只有一点点？
+### 7. “发现”和正版书源能不能使用？
-* 书源想要在发现界面里显示需要在书源里添加发现规则，并不是所有书源都有发现规则。
+发现和正版书源只能用来找书或看排行榜，不能用来看书，如需看书请切换书源。
+
+### 8. 为什么书源这么多，“发现”里却只有一点点？
+书源想要在发现界面里显示需要在书源里添加发现规则，并不是所有书源都有发现规则。
 
 ## 本地书籍相关
-1. 目前阅读支持哪些格式的本地书籍？
-* 目前支持TXT、EPUB格式
 
-2. 如何导入本地书籍？
+### 1. 目前阅读支持哪些格式的本地书籍？
-* 在书架页面点击右上角，选择“添加本地”，授予相关权限后即可导入本地书籍。也可在文件管理器中使用 **阅读** 打开相关书籍。
+目前支持 TXT 和 EPUB 格式。
+
+### 2. 如何导入本地书籍？
+在书架页面点击右上角“**⁝**”，选择“**添加本地**”，授予相关权限后即可导入本地书籍。也可在文件管理器中使用【阅读】打开相关书籍。
 
-3. 导入TXT文件提示“LoadTocError”或“List is empty”是怎么回事？
+### 3. 导入 TXT 文件提示“LoadTocError”或“List is empty”是怎么回事？
-* 请先去应用详情中确认是否授予了阅读“读写手机存储”的权限。
+* 请先去应用详情中确认是否授予了【阅读】“读写手机存储”的权限。
 * 自动识别目录失败，可能是相关目录规则未开启，请点击右上角的换源按钮手动更换目录规则。
-* 如果尝试所有规则均无法识别，请在github上提交issue并附件相关txt文件，也可以发送邮件至i@qnmlgb.trade（标题：legado本地文件章节无法识别，内容对其具体情况进行简要说明，附件上传相关txt文件）。
 
-4. 如何下载书籍到本地？
+如果尝试所有规则均无法识别，请在 GitHub 上提交 Issue 并附上相关 TXT 文件，也可以发送邮件至 i@qnmlgb.trade（标题：legado 本地文件章节无法识别；内容对其具体情况进行简要说明，附件上传相关 TXT 文件）。
-* 把在线书籍加入到书架后，在书架页面点击右上角，选择“离线缓存”即可。
+
+### 4. 如何下载书籍到本地？
+把在线书籍加入到书架后，在书架页面点击右上角，选择“**离线缓存**”即可。
 
-5. 如何自定义导出的txt/epub文件名称？
+### 5. 如何自定义导出的 TXT 或 EPUB 文件名称？
-* 点击 **离线缓存** - **导出文件名**.
+* 点击“**离线缓存**“——”**导出文件名**“
 * 使用方法:
-  - 导出文件名支持js语法
+  - 导出文件名支持 JSON 语法
-  - 可用变量: name - 书名  author-作者
+  - 可用变量: name（书名）和 author（作者）
   - 示例:  
   > {name+"作者:"+author}  
   - 导出文件名:
-  >  Legado是最好的在线阅读软件 作者: kunfei.
+  >  Legado 是最好的在线阅读软件 作者: kunfei
 
-**注意:** name、author等变量与字符串的拼接都需要在js环境中进行，即必须使用{  } 将变量与字符串包裹起来.
+**【注】** *name、author 等变量与字符串的拼接都需要在 JSON 上下文环境中进行，即必须使用 `{}` 将变量与字符串包裹起来。*
 
-6. 为什么我打开本地的TXT文件，显示内容却是乱码？
+### 6. 为什么我打开本地的 TXT 文件，显示内容却是乱码？
-* 部分编码在阅读上会识别错误，建议先用文本编辑器转换为常用的UTF-8格式。
+部分编码在阅读上会识别错误，建议先用文本编辑器转换为常用的 UTF-8 格式。
 
-7. 阅读对部分把正文（如所有含引号的句子）识别成标题，如何解决？
+### 7. 阅读对部分把正文（如所有含引号的句子）识别成标题，如何解决？
-* 点击右上角更换目录规则即可。
+点击右上角更换目录规则即可。
 
 ## 书籍界面相关
 
-1. 如何刷新书架？
+### 1. 如何刷新书架？
-* 在书架界面下拉即可刷新。
+在书架界面下拉即可刷新。
 
-2. 书架界面书籍右上角的红色或者灰色背景小数字代表什么？
+### 2. 书架界面书籍右上角的红色或者灰色背景小数字代表什么？
-* 红色代表书籍有更新，灰色代表无更新，数字代表未读章节。
+红色代表书籍有更新，灰色代表无更新，数字代表未读章节。
 
-3. 如何查看书籍详情？
+### 3. 如何查看书籍详情？
-* 长按书籍。
+长按书籍即可查看。
 
-4. 如何对书架上的书进行删除、切换书架的操作？
+### 4. 如何对书架上的书进行删除、切换书架的操作？
-* 书籍详情页操作即可。
+书籍详情页操作即可。
 
-5. 如何禁止或允许某本书更新？
+### 5. 如何禁止或允许某本书更新？
-* 书籍详情页，点击右上角 - “允许更新”。
+书籍详情页，点击右上角——“**允许更新**”。
 
-6. 如何更换小说封面、名字、作者或简介？
+### 6. 如何更换小说封面、名字、作者或简介？
-* 书籍详情页，点击右上角修改按钮。
+书籍详情页，点击右上角修改按钮。
 
-7. 怎么使用自定义字体？
+### 7. 怎么使用自定义字体？
-* 阅读界面 - 字体-点击右上角选择字体文件路径。
+阅读界面——“**字体**”——点击右上角选择字体文件路径。
 
-8. 目前支持哪些格式的字体文件？
+### 8. 目前支持哪些格式的字体文件？
-* 目前支持ttf、otf格式。
+目前支持 TTF 和 OTF 格式。
 
-9. 书籍经常“正在加载中”怎么办？
+### 9. 书籍经常“正在加载中”怎么办？
-* 在线书籍出现这个问题通常是由于源质量不好或不兼容引起的，可以换其它源多试试；本地书籍出现这个问题大概率是目录规则问题，手动切换规则可以解决。
+在线书籍出现这个问题通常是由于源质量不好或不兼容引起的，可以换其它源多试试；本地书籍出现这个问题大概率是目录规则问题，手动切换规则可以解决。
 
-10. 书籍内容只有标题，正文内容是路径怎么办？
+### 10. 书籍内容只有标题，正文内容是路径怎么办？
-* 通常是缓存路径引起的，更换缓存路径即可。
+通常是缓存路径引起的，更换缓存路径即可。
 
-11. 看书时如遇到“目录为空”、“加载失败”和长串英文等情况怎么办？
+### 11. 看书时如遇到“目录为空”、“加载失败”或长串英文等情况怎么办？
-* 在线书籍一般是书源问题，切换或更新书源即可。本地书籍请尝试手动更换目录规则。
+在线书籍一般是书源问题，切换或更新书源即可。本地书籍请尝试手动更换目录规则。
 
-12. 为什么每一章的最后一页，阅读的文字和横线背景总是对不齐？
+### 12. 为什么每一章的最后一页，阅读的文字和横线背景总是对不齐？
-* 请在 设置-文字底部对齐 选项中关闭底部对齐，再调整排版。
+请在“**设置**”——“**文字底部对齐**”选项中关闭底部对齐，再调整排版。
 
-13. 漫画源或图片章节只能看到第一页，如何解决？
+### 13. 漫画源或图片章节只能看到第一页，如何解决？
-* 请先查看原网页是否正常，若正常，请在书籍阅读界面点击右上角的 **⁝** 按钮，在弹出的菜单中，选择 **翻页动画(本书)**，将翻页动画更改为 **滚动**。
+请先查看原网页是否正常，若正常，请在书籍阅读界面点击右上角的“**⁝**”按钮，在弹出的菜单中，选择“**翻页动画(本书)**”，将翻页动画更改为“**滚动**”。
 
-14. 阅读图片章节、漫画或epub插图时，图片被缩放到一页中，以至无法看清，如何处理？
+### 14. 阅读图片章节、漫画或 EPUB 插图时，图片被缩放到一页中，以至无法看清，如何处理？
-* 临时处理方案：长按图片可以进行双指缩放。图片章节请先参考Q13中的方案将翻页动画更改为**滚动**
+* 临时处理方案：长按图片可以进行双指缩放。图片章节请先参考 Q13 中的方案将翻页动画更改为“**滚动**”。
-* 3.0旧版可以点击书籍界面的章节标题进入 **编辑书源** 界面，在 正文-图片样式 中填入 *full*，保存更改，刷新当前章节即可。
+* 3.0 旧版可以点击书籍界面的章节标题进入“**编辑书源**”界面，在“**正文**”——“**图片样式**”中填入 *`full`*，保存更改，刷新当前章节即可。
-* 3.0新版可以直接在书籍阅读界面点击右上角的 **⁝** 按钮，选择 图片样式- *full*.
+* 3.0 新版可以直接在书籍阅读界面点击右上角的“**⁝**”按钮，选择“**图片样式**”——***`full`***。
 
 
 ## 替换净化相关
-1. 替换净化是什么？
-* 替换净化可以去除书籍内容里的广告、错别字、屏蔽词等。
 
-2. 如何自己填写净化替换规则？
+### 1. 替换净化是什么？
-* 第一行：替换规则名称 - 根据自己需求对替换净化规则进行命名；
+替换净化可以去除书籍内容里的广告、错别字、屏蔽词等。
-* 第二行：分组 - 净化规则的分组组别；
+
-* 第三行：替换规则 - 填写需要被替换的内容；
+### 2. 如何自己填写净化替换规则？
-* 第四行：替换为 - 填写想替换成的内容（如不填则默认表示删除第三行里填写的内容）；
+* 第一行：替换规则名称。请根据自己需求对替换净化规则进行命名；
-* 第五行：替换范围，选填书名或者源名 - 填写此替换净化规则需要对哪本书籍或者哪个书源生效（如不填则对所有书籍和书源生效）。
+* 第二行：分组。净化规则的分组组别；
-* 注：如常规去除方法去除不掉，则需要勾选“使用正则表达式”，同时第三行里的替换规则也需要按照正则表达式来填写（正则表达式填写方法可自行百度学习）。
+* 第三行：替换规则。填写需要被替换的内容；
+* 第四行：替换为。填写想替换成的内容（如不填则默认表示删除第三行里填写的内容）；
+* 第五行：替换范围，选填书名或者源名。填写此替换净化规则需要对哪本书籍或者哪个书源生效（如不填则对所有书籍和书源生效）。
+
+**【注】** *如常规去除方法去除不掉，则需要勾选“使用正则表达式”，同时第三行里的替换规则也需要按照正则表达式来填写（正则表达式填写方法可自行网上搜索学习）。*
 
 
 ## 备份相关
 
-1. 云备份在哪？
+### 1. 云备份在哪？
-* 我的 - 备份与恢复 - WebDav设置。
+“**我的**”——“**备份与恢复**”——“**WebDav 设置**”。
+
+### 2. 如何操作进行云备份？
+* 侧栏设置，WebDav 设置；
+* 正确填写 WebDAV 服务器地址、账号和密码；
+* 无需操作，APP 默认每天自动云备份一次。
+
+作者在此诚挚推荐使用【坚果云】进行 WebDav 备份。
 
-2. 如何操作进行云备份？
+如果直接在手机上注册，须下载【坚果云】APP，步骤较为繁琐。推荐在电脑上进行操作：
-* 侧栏设置，WebDav设置；
+1. 打开注册链接：https://www.jianguoyun.com/d/signup ；
-* 正确填写WebDAV 服务器地址、WebDAV 账号、WebDAV 密码；（要获得这三项的信息，需要注册一个坚果云账号，如果直接在手机上注册，坚果云会让你下载app，过程比较麻烦，为了一步到位，最好是在电脑上打开这个注册链接：https://www.jianguoyun.com/d/signup ；注册后，进入坚果云；点击右上角账户名处选择 “账户信息”，然后选择“安全选项”；在“安全选项” 中找到“第三方应用管理”，并选择“添加应用”，输入名称如“阅读”后，会生成密码，选择完成；其中 https://dav.jianguoyun.com/dav/ 就是填入“WebDAV 服务器地址”的内容，“使用情况”后面的邮箱地址就是你的“WebDAV 账号”，点击显示密码后得到的密码就是你的“WebDAV 密码”。）
+2. 注册后，进入坚果云；
-* 无需操作，APP默认每天自动云备份一次。
+3. 点击右上角账户名处选择“**账户信息**”，然后选择“**安全选项**”；
+4. 在“**安全选项**”中找到“**第三方应用管理**”，并选择“**添加应用**”，输入名称（如“阅读”）后，会生成密码，选择完成；
+5. 其中 `https://dav.jianguoyun.com/dav/` 就是填入“**WebDAV 服务器地址**”的内容，“**使用情况**”后面的邮箱地址就是你的“**WebDAV 账号**”，点击“**显示密码**“后得到的密码就是你的“**WebDAV 密码**”。
 
-3. 关于云备份的相关说明
+### 3. 关于云备份的相关说明
-* 在正确设置好云备份的情况下，APP默认每天自动云备份一次，当日多次手动云备份会对当日的旧云备份文件进行覆盖，并不会覆盖之前及之后不同日期的备份文件，每天所自动云备份的文件会按照日期进行命名。
 
-4. 本地备份和云备份都能备份哪些东西？
+在正确设置好云备份的情况下，APP 默认每天自动云备份一次，当日多次手动云备份会对当日的旧云备份文件进行覆盖，并不会覆盖之前及之后不同日期的备份文件，每天所自动云备份的文件会按照日期进行命名。
-* 书架、看书进度、搜索记录、书源、替换、APP设置等都会备份，基本涵盖所有内容。
 
-5. 出现某些未知bug怎么办？
+### 4. 本地备份和云备份都能备份哪些东西？
-* 清除软件数据试试看，不行再进行反馈。
+书架、看书进度、搜索记录、书源、替换和 APP 设置等都会备份，基本涵盖所有内容。
+
+### 5. 出现某些未知 Bug 怎么办？
+清除软件数据试试看，不行再进行反馈。
 
 
 ## 其他
-1. 如何听书？
-* 可以使用手机自带的朗读引擎，也可使用第三方如谷歌、小米等朗读引擎。
-* 【具体操作：安装-系统设置-其他高级设置-辅助功能-TTS输出-选择安装的朗读引擎（不同品牌手机的操作方法及步骤也不同，视情况而定）。】
 
-2. 如何设置屏幕方向、屏幕显示时长、显示/隐藏状态栏、显示/隐藏导航栏、音量键翻页、长按选择文本、点击总是翻下一页、自定义翻页案件？
+### 1. 如何听书？
-* 阅读界面，设置（可上划，下面还有其他设置）。
+可以使用手机自带的朗读引擎，也可使用第三方如 Google（谷歌）或小米等朗读引擎。
+
+【具体操作】*安装——系统设置——其他高级设置——辅助功能——TTS 输出——选择安装的朗读引擎（不同品牌手机的操作方法及步骤也不同，视情况而定）。*
+
+### 2. 如何设置屏幕方向、屏幕显示时长、显示/隐藏状态栏、显示/隐藏导航栏、音量键翻页、长按选择文本、点击总是翻下一页或自定义翻页按键？
+阅读界面——“**设置**”（可上划，下面还有其他设置）。
 
-3. 搜索的时候感觉手机卡顿，如何解决？
+### 3. 搜索的时候感觉手机卡顿，如何解决？
-* 我的 - 其他设置 - “更新和搜索线程数”调低。
+“**我的**”——“**其他设置**”——调低“**更新和搜索线程数**”。