新增项目详情与开发文档网页
This commit is contained in:
HapeLee
@@ -0,0 +1,201 @@
|
||||
# 源示例 (Source Examples)
|
||||
|
||||
[[toc]]
|
||||
|
||||
本文档提供三种典型源的完整 JSON 示例，分别演示 CSS+正则、XPath+正则、JSONPath 的用法。
|
||||
|
||||
## 1. CSS + 正则
|
||||
|
||||
使用 JSOUP CSS 选择器和正则表达式的源示例。
|
||||
|
||||
```json
|
||||
{
|
||||
"bookSourceComment": "",
|
||||
"bookSourceGroup": "CSS; 正则",
|
||||
"bookSourceName": "示例源",
|
||||
"bookSourceType": 0,
|
||||
"bookSourceUrl": "https://www.example.com",
|
||||
"bookUrlPattern": "",
|
||||
"customOrder": 0,
|
||||
"enabled": true,
|
||||
"enabledExplore": false,
|
||||
"exploreUrl": "",
|
||||
"lastUpdateTime": 0,
|
||||
"loginUrl": "",
|
||||
"ruleBookInfo": {
|
||||
"author": "##:author\"[^\"]+\"([^\"]*)##$1###",
|
||||
"coverUrl": "##og:image\"[^\"]+\"([^\"]*)##$1###",
|
||||
"intro": "##:description\"[^\"]+\"([\\w\\W]*?)\"/##$1###",
|
||||
"kind": "##:category\"[^\"]+\"([^\"]*)##$1###",
|
||||
"lastChapter": "##_chapter_name\"[^\"]+\"([^\"]*)##$1###",
|
||||
"name": "##:book_name\"[^\"]+\"([^\"]*)##$1###",
|
||||
"tocUrl": ""
|
||||
},
|
||||
"ruleContent": {
|
||||
"content": "@css:.chapter-content p@textNodes##广告文字|本站声明.*|<!\\[CDATA\\[|\\]\\]>",
|
||||
"nextContentUrl": ""
|
||||
},
|
||||
"ruleExplore": {},
|
||||
"ruleSearch": {
|
||||
"author": "@css:p:eq(2)>a@text",
|
||||
"bookList": "@css:li.clearfix",
|
||||
"bookUrl": "@css:.name>a@href",
|
||||
"coverUrl": "@css:img@src",
|
||||
"intro": "@css:.note.clearfix p@text",
|
||||
"kind": "@css:.note_text,p:eq(4)@text",
|
||||
"lastChapter": "@css:p:eq(3)@text",
|
||||
"name": "@css:.name@text"
|
||||
},
|
||||
"ruleToc": {
|
||||
"chapterList": "-:<li><a[^\"]+\"([^\"]*)\">([^<]*)",
|
||||
"chapterName": "$2",
|
||||
"chapterUrl": "$1",
|
||||
"nextTocUrl": ""
|
||||
},
|
||||
"searchUrl": "/search?q={{key}}&page={{page}}",
|
||||
"weight": 0
|
||||
}
|
||||
```
|
||||
|
||||
**要点：**
|
||||
|
||||
- 详情页规则使用 OnlyOne 正则（`##...###`）从 meta 标签提取信息
|
||||
- 正文规则使用 CSS 选择器取文本节点，后接净化正则移除广告
|
||||
- 目录规则使用 AllInOne 正则（`:` 开头），`-` 前缀使列表倒序
|
||||
|
||||
## 2. XPath + 正则
|
||||
|
||||
使用 XPath 和正则表达式的源示例。
|
||||
|
||||
```json
|
||||
{
|
||||
"bookSourceComment": "",
|
||||
"bookSourceGroup": "XPath; 正则",
|
||||
"bookSourceName": "示例移动源",
|
||||
"bookSourceType": 0,
|
||||
"bookSourceUrl": "https://m.example.com",
|
||||
"bookUrlPattern": "",
|
||||
"customOrder": 0,
|
||||
"enabled": true,
|
||||
"enabledExplore": false,
|
||||
"exploreUrl": "",
|
||||
"lastUpdateTime": 0,
|
||||
"loginUrl": "",
|
||||
"ruleBookInfo": {
|
||||
"author": "//*[@property=\"og:novel:author\"]/@content",
|
||||
"coverUrl": "//*[@property=\"og:image\"]/@content",
|
||||
"intro": "//*[@property=\"og:description\"]/@content",
|
||||
"kind": "//*[@property=\"og:novel:category\"]/@content",
|
||||
"lastChapter": "//*[@id=\"latest-chapter\"]//li[1]/a/text()",
|
||||
"name": "//*[@property=\"og:novel:book_name\"]/@content",
|
||||
"tocUrl": "//a[text()=\"阅读\"]/@href"
|
||||
},
|
||||
"ruleContent": {
|
||||
"content": "//*[@id=\"content\"]",
|
||||
"nextContentUrl": ""
|
||||
},
|
||||
"ruleExplore": {},
|
||||
"ruleSearch": {
|
||||
"author": "//dd[2]/text()",
|
||||
"bookList": "//*[@id=\"search-result\"]/dl",
|
||||
"bookUrl": "//dt/a/@href",
|
||||
"coverUrl": "//img/@src",
|
||||
"kind": "//dd[2]/span/text()",
|
||||
"lastChapter": "",
|
||||
"name": "//h3/a/text()"
|
||||
},
|
||||
"ruleToc": {
|
||||
"chapterList": ":href=\"(/read[^\"]*html)\">([^<]*)",
|
||||
"chapterName": "$2",
|
||||
"chapterUrl": "$1",
|
||||
"nextTocUrl": "//*[@id=\"chapter-list\"]/*[position()>1]/@value"
|
||||
},
|
||||
"searchUrl": "/search,{\n \"method\": \"POST\",\n \"body\": \"q={{key}}\"\n}",
|
||||
"weight": 0
|
||||
}
|
||||
```
|
||||
|
||||
**要点：**
|
||||
|
||||
- 详情页使用 XPath 从 `og:novel` meta 标签提取信息
|
||||
- 目录使用 AllInOne 正则提取链接和标题
|
||||
- 目录下一页使用 XPath 的 `position()` 谓语条件
|
||||
- 搜索使用 POST 方法
|
||||
|
||||
## 3. JSONPath
|
||||
|
||||
使用 JSON API 的源示例。
|
||||
|
||||
```json
|
||||
{
|
||||
"bookSourceComment": "",
|
||||
"bookSourceGroup": "JSON",
|
||||
"bookSourceName": "示例 API 源",
|
||||
"bookSourceType": 0,
|
||||
"bookSourceUrl": "http://api.example.com",
|
||||
"customOrder": 0,
|
||||
"enabled": true,
|
||||
"enabledExplore": false,
|
||||
"header": "{\n \"User-Agent\": \"Mozilla/5.0\"\n}",
|
||||
"lastUpdateTime": 0,
|
||||
"ruleBookInfo": {},
|
||||
"ruleContent": {
|
||||
"content": "$.chapter.body"
|
||||
},
|
||||
"ruleExplore": {},
|
||||
"ruleSearch": {
|
||||
"author": "$.author",
|
||||
"bookList": "$..books[*]",
|
||||
"bookUrl": "/book/detail?id={$._id}",
|
||||
"coverUrl": "$.cover",
|
||||
"intro": "$.shortIntro",
|
||||
"kind": "$.minorCate",
|
||||
"lastChapter": "$.lastChapter",
|
||||
"name": "$.title"
|
||||
},
|
||||
"ruleToc": {
|
||||
"chapterList": "$.chapterInfo.chapters.[*]",
|
||||
"chapterName": "$.title",
|
||||
"chapterUrl": "$.link"
|
||||
},
|
||||
"searchUrl": "/book/search?query={{key}}&start={{(page-1)*20}}&limit=20",
|
||||
"weight": 0
|
||||
}
|
||||
```
|
||||
|
||||
**要点：**
|
||||
|
||||
- 详情页为空（`ruleBookInfo: {}`），直接从搜索结果获取信息
|
||||
- 目录 URL 使用 JSONPath 表达式 `{$._id}` 拼接
|
||||
- 书列表使用递归查找 `$..books[*]`
|
||||
- 搜索 URL 使用 `{{(page-1)*20}}` 计算偏移量
|
||||
|
||||
## 4. 调试技巧
|
||||
|
||||
### JS 错误处理
|
||||
|
||||
使用 try-catch 包裹 JS 逻辑，方便调试：
|
||||
|
||||
```javascript
|
||||
(function(result){
|
||||
try{
|
||||
// 处理 result
|
||||
return result;
|
||||
}
|
||||
catch(e){
|
||||
return "" + e; // 返回错误信息
|
||||
}
|
||||
})(result);
|
||||
```
|
||||
|
||||
### 调试入口
|
||||
|
||||
| 调试项 | 输入示例 |
|
||||
|:----|:--------------------------------------------------|
|
||||
| 搜索 | `系统` |
|
||||
| 发现 | `排行榜::https://www.example.com/rank?page={{page}}` |
|
||||
| 详情页 | `https://www.example.com/book/12345` |
|
||||
| 目录页 | `++https://www.example.com/read/12345` |
|
||||
| 正文页 | `--https://www.example.com/chapter/12345/67890` |
|
||||
|
||||
详细调试方法参见 [源调试](./debug)。
|
||||
Reference in New Issue
Block a user