转移帮助文档路径，并纳入web服务
This commit is contained in:
Antecer
@@ -0,0 +1,196 @@
|
||||
# 源规则帮助
|
||||
|
||||
* [阅读3.0(Legado)规则说明](https://mgz0227.github.io/The-tutorial-of-Legado/)
|
||||
* [书源帮助文档](https://mgz0227.github.io/The-tutorial-of-Legado/Rule/source.html)
|
||||
* [订阅源帮助文档](https://mgz0227.github.io/The-tutorial-of-Legado/Rule/rss.html)
|
||||
* 辅助键盘❓中可插入URL参数模板,打开帮助,js教程,正则教程,选择文件
|
||||
* 规则标志, {{......}}内使用规则必须有明显的规则标志,没有规则标志当作js执行
|
||||
```
|
||||
@@ 默认规则,直接写时可以省略@@
|
||||
@XPath: xpath规则,直接写时以//开头可省略@XPath
|
||||
@Json: json规则,直接写时以$.开头可省略@Json
|
||||
: regex规则,不可省略,只可以用在书籍列表和目录列表
|
||||
```
|
||||
* jsLib
|
||||
> 注入JavaScript到RhinoJs引擎中，支持两种格式，可实现[函数共用](https://github.com/gedoor/legado/wiki/JavaScript%E5%87%BD%E6%95%B0%E5%85%B1%E7%94%A8)
|
||||
|
||||
> `JavaScript Code` 直接填写JavaScript片段
|
||||
> `{"example":"https://www.example.com/js/example.js", ...}` 自动复用已经下载的js文件
|
||||
|
||||
* 并发率
|
||||
> 并发限制，单位ms，可填写两种格式
|
||||
|
||||
> `1000` 访问间隔1s
|
||||
> `20/60000` 60s内访问次数20
|
||||
|
||||
* 书源类型: 文件
|
||||
> 对于类似知轩藏书提供文件整合下载的网站，可以在书源详情的下载URL规则获取文件链接
|
||||
|
||||
> 通过截取下载链接或文件响应头头获取文件信息，获取失败会自动拼接`书名` `作者`和下载链接的`UrlOption`的`type`字段
|
||||
|
||||
> 压缩文件解压缓存会在下次启动后自动清理，不会占用额外空间
|
||||
|
||||
* CookieJar
|
||||
> 启用后会自动保存每次返回头中的Set-Cookie中的值，适用于验证码图片一类需要session的网站
|
||||
|
||||
* 登录UI
|
||||
> 不使用内置webView登录网站，需要使用`登录URL`规则实现登录逻辑，可使用`登录检查JS`检查登录结果
|
||||
> 版本20221113重要更改：按钮支持调用`登录URL`规则里面的函数，必须实现`login`函数
|
||||
```
|
||||
规则填写示范
|
||||
[
|
||||
{
|
||||
name: "telephone",
|
||||
type: "text"
|
||||
},
|
||||
{
|
||||
name: "password",
|
||||
type: "password"
|
||||
},
|
||||
{
|
||||
name: "注册",
|
||||
type: "button",
|
||||
action: "http://www.yooike.com/xiaoshuo/#/register?title=%E6%B3%A8%E5%86%8C"
|
||||
},
|
||||
{
|
||||
name: "获取验证码",
|
||||
type: "button",
|
||||
action: "getVerificationCode()"
|
||||
}
|
||||
]
|
||||
```
|
||||
* 登录URL
|
||||
> 可填写登录链接或者实现登录UI的登录逻辑的JavaScript
|
||||
```
|
||||
示范填写
|
||||
function login() {
|
||||
java.log("模拟登录请求");
|
||||
java.log(source.getLoginInfoMap());
|
||||
}
|
||||
function getVerificationCode() {
|
||||
java.log("登录UI按钮：获取到手机号码"+result.get("telephone"))
|
||||
}
|
||||
|
||||
登录按钮函数获取登录信息
|
||||
result.get("telephone")
|
||||
login函数获取登录信息
|
||||
source.getLoginInfo()
|
||||
source.getLoginInfoMap().get("telephone")
|
||||
source登录相关方法,可在js内通过source.调用,可以参考阿里云语音登录
|
||||
login()
|
||||
getHeaderMap(hasLoginHeader: Boolean = false)
|
||||
getLoginHeader(): String?
|
||||
getLoginHeaderMap(): Map<String, String>?
|
||||
putLoginHeader(header: String)
|
||||
removeLoginHeader()
|
||||
setVariable(variable: String?)
|
||||
getVariable(): String?
|
||||
AnalyzeUrl相关函数,js中通过java.调用
|
||||
initUrl() //重新解析url,可以用于登录检测js登录后重新解析url重新访问
|
||||
getHeaderMap().putAll(source.getHeaderMap(true)) //重新设置登录头
|
||||
getStrResponse( jsStr: String? = null, sourceRegex: String? = null) //返回访问结果,文本类型,书源内部重新登录后可调用此方法重新返回结果
|
||||
getResponse(): Response //返回访问结果,网络朗读引擎采用的是这个,调用登录后在调用这方法可以重新访问,参考阿里云登录检测
|
||||
```
|
||||
|
||||
* 发现url格式
|
||||
```json
|
||||
[
|
||||
{
|
||||
"title": "xxx",
|
||||
"url": "",
|
||||
"style": {
|
||||
"layout_flexGrow": 0,
|
||||
"layout_flexShrink": 1,
|
||||
"layout_alignSelf": "auto",
|
||||
"layout_flexBasisPercent": -1,
|
||||
"layout_wrapBefore": false
|
||||
}
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
* 请求头,支持http代理,socks4 socks5代理设置
|
||||
```
|
||||
socks5代理
|
||||
{
|
||||
"proxy":"socks5://127.0.0.1:1080"
|
||||
}
|
||||
http代理
|
||||
{
|
||||
"proxy":"http://127.0.0.1:1080"
|
||||
}
|
||||
支持代理服务器验证
|
||||
{
|
||||
"proxy":"socks5://127.0.0.1:1080@用户名@密码"
|
||||
}
|
||||
注意:这些请求头是无意义的,会被忽略掉
|
||||
```
|
||||
|
||||
* url添加js参数,解析url时执行,可在访问url时处理url,例
|
||||
```
|
||||
https://www.baidu.com,{"js":"java.headerMap.put('xxx', 'yyy')"}
|
||||
https://www.baidu.com,{"js":"java.url=java.url+'yyyy'"}
|
||||
```
|
||||
|
||||
* 增加js方法，用于重定向拦截
|
||||
* `java.get(urlStr: String, headers: Map<String, String>)`
|
||||
* `java.post(urlStr: String, body: String, headers: Map<String, String>)`
|
||||
* 对于搜索重定向的源，可以使用此方法获得重定向后的url
|
||||
```
|
||||
(()=>{
|
||||
if(page==1){
|
||||
let url='https://www.yooread.net/e/search/index.php,'+JSON.stringify({
|
||||
"method":"POST",
|
||||
"body":"show=title&tempid=1&keyboard="+key
|
||||
});
|
||||
return java.put('surl',String(java.connect(url).raw().request().url()));
|
||||
} else {
|
||||
return java.get('surl')+'&page='+(page-1)
|
||||
}
|
||||
})()
|
||||
或者
|
||||
(()=>{
|
||||
let base='https://www.yooread.net/e/search/';
|
||||
if(page==1){
|
||||
let url=base+'index.php';
|
||||
let body='show=title&tempid=1&keyboard='+key;
|
||||
return base+java.put('surl',java.post(url,body,{}).header("Location"));
|
||||
} else {
|
||||
return base+java.get('surl')+'&page='+(page-1);
|
||||
}
|
||||
})()
|
||||
```
|
||||
|
||||
* 图片链接支持修改headers
|
||||
```
|
||||
let options = {
|
||||
"headers": {"User-Agent": "xxxx","Referrer":baseUrl,"Cookie":"aaa=vbbb;"}
|
||||
};
|
||||
'<img src="'+src+","+JSON.stringify(options)+'">'
|
||||
```
|
||||
|
||||
* 字体解析使用
|
||||
> 使用方法,在正文替换规则中使用,原理根据f1字体的字形数据到f2中查找字形对应的编码
|
||||
```
|
||||
<js>
|
||||
(function(){
|
||||
var b64=String(src).match(/ttf;base64,([^\)]+)/);
|
||||
if(b64){
|
||||
var f1 = java.queryBase64TTF(b64[1]);
|
||||
var f2 = java.queryTTF("https://alanskycn.gitee.io/teachme/assets/font/Source Han Sans CN Regular.ttf");
|
||||
return java.replaceFont(result, f1, f2);
|
||||
}
|
||||
return result;
|
||||
})()
|
||||
</js>
|
||||
```
|
||||
|
||||
* 购买操作
|
||||
> 可直接填写链接或者JavaScript，如果执行结果是网络链接将会自动打开浏览器,js返回true自动刷新目录和当前章节
|
||||
|
||||
* 图片解密
|
||||
> 适用于图片需要二次解密的情况，直接填写JavaScript，返回解密后的`ByteArray`
|
||||
> 部分变量说明：java（仅支持[js扩展类](https://github.com/gedoor/legado/blob/master/app/src/main/java/io/legado/app/help/JsExtensions.kt)），result为待解密图片的`ByteArray`，src为图片链接
|
||||
|
||||
* 封面解密
|
||||
> 同图片解密 其中result为待解密封面的`inputStream`
|
||||
Reference in New Issue
Block a user