新增项目详情与开发文档网页

This commit is contained in:
HapeLee
2026-05-27 01:00:58 +08:00
parent 65d5c84b56
commit b7826b54a7
35 changed files with 3499 additions and 15 deletions
+46
View File
@@ -0,0 +1,46 @@
# 导入源管理界面帮助
[[toc]]
## 源标志
- 🟢 绿点:源有发现,且启用了发现
- 🔴 红点:源有发现,但是未启用
- 无标志:此源没有发现
## 功能菜单
右上角有分组菜单,可以按分组筛选源。
右上角更多菜单里包含:
- 新建源
- 本地导入
- 网络导入
- 二维码导入
- 分享选中源
## 批量操作
选择源的更多操作在右下角的菜单里面,操作都是针对选择的源:
- 启用所选
- 禁用所选
- 添加分组
- 移除分组
- 启用发现
- 禁用发现
- 置顶所选
- 置底所选
- 导出所选
- 校验所选
## 校验源
校验源可批量校验源,由于网络等原因结果仅限参考。
- "校验成功"是指所选的校验项目全部通过
- 可正常识别搜索为空、发现为空、搜索(发现)目录为空、搜索(发现)正文为空、校验超时、js
执行错误导致的失效,其余的原因视为网站失效
- 校验搜索优先使用源填写的校验关键词,不存在时使用用户输入的关键词
- 校验结束后会自动筛选"失效"源
+212
View File
@@ -0,0 +1,212 @@
# 帮助文档
[[toc]]
## 新人必读
### 1. 为什么第一次安装后没有内容?
本应用是一款内容聚合阅读工具,不直接提供内容。需导入本地书籍文件或配置内容源后方可使用。
### 2. 正文出现缺字漏字、内容缺失或排版错乱怎么办?
可能是替换净化规则导致。请先关闭替换净化并刷新,若恢复正常则说明净化规则存在误配。关闭后仍有问题,请点击源链接查看原文是否一致,若不一致再进行反馈。
## 导入源相关
### 1. 如何导入本地导入源文件?
1. 打开本应用
2. 点击"**我的**"——"**导入源管理**"
3. 点击右上角选择"**本地导入**"
4. 选择导入源文件所在的路径
5. 点击导入源文件导入
::: tip 注意
导入源格式后缀有 `.txt``.json`,其中 `.json` 文件在某些情况下可能无法导入,需要修改后缀为 `.txt`
才可导入。
:::
### 2. 如何新建导入源?
1. 复制导入源代码
2. 点击"**我的**"——"**导入源管理**"
3. 右上角"**⁝**"——"**+ 新建导入源**"
4. 进入后点击右上角"**⁝**"——"**粘贴源**"
5. 粘贴完成后点击上方保存按钮
::: tip 注意
如果导入源有错误或者复制不全会显示格式错误,请重新复制。
:::
### 3. 校验导入源显示失效就说明导入源不能用了吗?
校验仅作为参考,显示失效不代表导入源不可用。
## 本地/WebDav 远程书籍相关
### 1. 目前支持哪些格式的本地书籍?
目前支持 TXT 和 EPUB 格式。
### 2. 如何导入本地/WebDav 远程书籍?
- **本地**:在书架页面点击右上角"**⁝**",选择"**添加本地**",授予相关权限后即可导入本地书籍。也可在文件管理器中使用本应用打开相关书籍。
- **远程**:在主页面点击右上角"**⁝**",选择 **WebDav 书籍**,正确配置好后即可看到上传的远程书籍,点击 *
*加入书架** 按钮导入即可。
### 3. 如何上传本地书籍到 WebDav 远程?
长按本地书籍,进入书籍详情页,点击右上角"**⁝**",选择 **上传 WebDav**,等待几秒后即可上传到远程。
或进入书籍缓存页面,点击右上角"**⁝**",选择 **导出到 WebDav**,在书籍导出时便可同时上传到远程。
### 4. 导入 TXT 文件提示 "LoadTocError" 或 "List of empty" 是怎么回事?
- 请先去应用详情中确认是否授予了本应用"读写手机存储"的权限。
- 自动识别目录失败,可能是相关目录规则未开启,请点击右上角的换源按钮手动更换目录规则。
如果尝试所有规则均无法识别,请在 GitHub 上提交 Issue 并附上相关 TXT 文件。
### 5. 如何下载书籍到本地?
把在线书籍加入到书架后,在书架页面点击右上角,选择"**离线缓存**"即可。
### 6. 如何自定义导出的 TXT 或 EPUB 文件名称?
- 点击"**离线缓存**"——"**导出文件名**"
- 使用方法:
- 导出文件名支持 js 语法
- 可用变量:`name`(书名)和 `author`(作者)
- 示例:`name + " - " + author`
::: tip 注意
`name``author` 等变量与字符串的拼接都需要在 JSON 上下文环境中进行,即必须使用 `{}` 将变量与字符串包裹起来。
:::
### 7. 打开本地 TXT 文件显示乱码怎么办?
部分编码可能识别错误,建议先用文本编辑器转换为 UTF-8 格式。
### 8. 正文被识别为标题怎么办?
点击右上角更换目录规则即可。
## 书籍界面相关
### 1. 如何刷新书架?
在书架界面下拉即可刷新。
### 2. 书架界面书籍右上角的数字代表什么?
红色代表书籍有更新,灰色代表无更新,数字代表未读章节。
### 3. 如何查看书籍详情?
长按书籍即可查看。
### 4. 如何对书架上的书进行删除、切换书架的操作?
书籍详情页操作即可。
### 5. 如何禁止或允许某本书更新?
书籍详情页,点击右上角——"**允许更新**"。
### 6. 如何更换书籍封面、名字、作者或简介?
书籍详情页,点击右上角修改按钮。
### 7. 怎么使用自定义字体?
阅读界面——"**字体**"——点击右上角选择字体文件路径。
### 8. 目前支持哪些格式的字体文件?
目前支持 TTF 和 OTF 格式。
### 9. 书籍经常"正在加载中"怎么办?
在线书籍通常是由于源质量不好或不兼容引起的,可以换其它源多试试;本地书籍通常是目录规则问题,手动切换规则可以解决。
### 10. 书籍内容只有标题,正文内容是路径怎么办?
通常是缓存路径引起的,更换缓存路径即可。
### 11. 阅读时遇到"目录为空"、"加载失败"等情况怎么办?
在线书籍一般是源问题,切换或更新源即可。本地书籍请尝试手动更换目录规则。
### 12. 每章最后一页文字和横线背景对不齐怎么办?
请在"**设置**"——"**文字底部对齐**"选项中关闭底部对齐,再调整排版。
### 13. 图片章节只能看到第一页怎么办?
请先查看原网页是否正常,若正常,请在阅读界面点击右上角"**⁝**",选择"**翻页动画(本书)**"
,将翻页动画更改为"**滚动**"。
### 14. 图片被缩放到一页中怎么办?
- **临时方案**:长按图片可以进行双指缩放。图片章节请先将翻页动画更改为"**滚动**"。
- **图片样式**:在阅读界面点击右上角"**⁝**",选择"**图片样式**"——`full`
## 替换净化相关
### 1. 替换净化是什么?
替换净化可以去除书籍内容里的广告、错别字、屏蔽词等。
### 2. 如何填写净化替换规则?
1. **第一行**:替换规则名称
2. **第二行**:分组
3. **第三行**:替换规则,填写需要被替换的内容
4. **第四行**:替换为,填写想替换成的内容(留空表示删除)
5. **第五行**:替换范围,选填书名或源名(留空则对所有书籍和源生效)
::: tip 注意
如常规去除方法去除不掉,则需要勾选"使用正则表达式",同时第三行里的替换规则也需要按照正则表达式来填写。
:::
## 备份相关
### 1. 云备份在哪?
"**我的**"——"**备份与恢复**"——"**WebDav 设置**"。
### 2. 如何操作进行云备份?
1. 侧栏设置,WebDav 设置
2. 正确填写 WebDAV 服务器地址、账号和密码
3. 无需操作,APP 默认每天自动云备份一次
### 3. 关于云备份的相关说明
在正确设置好云备份的情况下,APP
默认每天自动云备份一次,当日多次手动云备份会对当日的旧云备份文件进行覆盖,并不会覆盖之前及之后不同日期的备份文件,每天所自动云备份的文件会按照日期进行命名。
### 4. 本地备份和云备份都能备份哪些内容?
书架、阅读进度、搜索记录、导入源、替换规则和 APP 设置等都会备份,基本涵盖所有内容。
### 5. 出现未知问题怎么办?
清除软件数据试试看,不行再进行反馈。
## 其他
### 1. 如何听书?
可以使用手机自带的朗读引擎,也可使用第三方如 Google 或小米等朗读引擎。
具体操作:安装 → 系统设置 → 其他高级设置 → 辅助功能 → TTS 输出 → 选择安装的朗读引擎。
### 2. 如何设置屏幕方向、屏幕显示时长等?
阅读界面——"**设置**"(可上划,下面还有其他设置)。
### 3. 搜索时感觉手机卡顿怎么办?
"**我的**"——"**其他设置**"——调低"**更新和搜索线程数**"。
+59
View File
@@ -0,0 +1,59 @@
# 阅读界面帮助文档
[[toc]]
## 阅读界面主菜单
### 顶部操作
- **章节名称**:点击可编辑源配置
- **章节 url**:点击可打开浏览器浏览
- **菜单**:不同类型的书籍显示的菜单不同。详情请查看菜单文字,长按菜单图标可显示文字
### 中间左侧 - 亮度调节
亮度调节的顶端有跟随系统亮度的开关,打开后亮度跟随系统,关闭后才可以调节亮度条
### 底部操作
- 4 个圆形按钮依次为:全文搜索 · 自动翻页 · 替换净化 · 切换夜间模式
- 上一章 / 下一章中间的进度条为页数进度,要快速跳转章节点击目录按钮进入目录快速跳转
- **目录** → 目录和书签界面
- **朗读** → 单击开始朗读,长按进入朗读设置界面
- **界面** → 所有排版设置都在里面
- **设置** → 其它一些设置,找不到的设置去这里看看,可滚动
## 全文搜索
搜索本地缓存或者本地文件,不能搜索在线内容。
书籍字数、净化规则数量、简繁转化、文章分段都会影响到搜索速度,请酌情启用。
## 朗读设置界面
- **后台** → 进入后台朗读,可以做一些其它事
- **设置** → 朗读引擎设置,可以切换本地 TTS 和在线朗读,在线朗读可自定义
## 排版设置界面
- 白天模式和夜间模式背景不同布局相同
- **共用布局**:启用共用布局时所有背景使用同一布局,关闭共用布局则每个背景单独布局
- 长按背景可进入文字颜色和背景设置界面
## 其它设置界面
- 屏幕方向
- 屏幕超时
- 隐藏状态栏
- 扩展到刘海
- 隐藏导航栏
- 文字两端对齐
- 文字底部对齐
- 音量键翻页
- 点击翻页
- 朗读时音量键翻页
- 自动换源(源被删除时自动切换到其它源)
- 长按选择文本
- 显示亮度调节控件
- 点击区域设置
- 自定义翻页按键
+9
View File
@@ -0,0 +1,9 @@
# 替换管理界面帮助
替换规则是用来替换正文内容的一种规则。
## 功能说明
- 菜单可以新建和导入规则
- 可以拖动排序
- 可以选择操作
+33
View File
@@ -0,0 +1,33 @@
# 订阅源管理界面帮助
[[toc]]
订阅源可以通过规则订阅一些网络内容。
## 订阅源标志
- 🟢 绿点:源有发现,且启用了发现
- 🔴 红点:源有发现,但是未启用
- 无标志:此源没有发现
## 功能菜单
右上角有分组菜单,可以按分组筛选源。
右上角更多菜单里包含:
- 新建订阅源
- 本地导入
- 网络导入
- 二维码导入
- 分享选中源
## 批量操作
选择源的更多操作在右下角的菜单里面,操作都是针对选择的源:
- 启用所选
- 禁用所选
- 置顶所选
- 置底所选
- 导出所选