(本節表格結合本節漫畫插件示例看,表格里?表示隨意可以不寫的屬性)
<br>
## 2.2.1 sited(插件根節點)格式說明
```xml
<sited ver="3" debug="1" engine="34" schema="1">
```
||下級|類型|官方說明|補充說明|
|:-|:-|:-|:-|:-|
|sited|||||
||@ver|Int|插件版本|最少為1,每次更新前要加1。如果你先安裝了低版本正式版插件,調試時就要加1不然引擎可能會讀取先安裝版本代碼|
||@vip?|Int|app用戶等級限制,0:普通用戶可用;1:最低需要VIP用戶;2:最低需要SVIP用戶|(不寫該屬性的話默認為0的效果)|
||@debug?|1或0|是否開啟調試模式|(不寫該屬性的話默認為0的效果)作為插件開發者我都是寫1即開啟,開啟后才能使插件開發者模式下的容器app在運行本插件時生成調試log日志等|
||@private?|1或0|是否為私密插件|(不寫該屬性的話默認為0的效果)1為私密插件,在兩條街不可見,收藏別人不可見,不可通過二維碼分享出去|
||@engine|Int|需要支持的app引擎版本號|引擎越高實現功能越強,引擎版本的能力詳見官方開發文檔PDF。我新做插件是寫34因為想兼容三平臺可用,最新安卓版引擎是36,最新Win10版引擎是35,最新ios內測版引擎是34|
||@schema|Int|插件規范版本號(v27引擎開始支持),0為測試規范(舊格式),1為正式規范(新格式)|新來的插件者請寫1,因為官方開發文檔是基于schema="1"|
||@head?|String|指定頭部節點名稱(v27引擎支持)(不寫該屬性的話默認為:meta的效果)||
||@body?|String|指定主體節點名稱(v27支持)(不寫該屬性的話默認為:main的效果)||
||@script?|String|指定腳本節點名稱(v27支持)(不寫該屬性的話默認為:script的效果)||
||@sds?|Uri|插件自動更新接口(參考官方開發文檔的插件更新接口規范)檢查時,@sds末尾附上插件的url。插件托管在插件中心的,不需要添加||
<br>
## 2.2.2 meta(頭部節點)格式說明
```xml
<meta>
<ua></ua>
<guid>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</guid>
<title>naver網漫</title>
<author>Guang</author>
<contact></contact>
<intro>[漫畫](v3修復)LINE WEBTOON韓國naver官網。???? ??? ??, ??? ??.(部分章節提示下架,要登陸源網站觀看)</intro>
<alert></alert>
<url>http://m.comic.naver.com/</url>
<expr>comic\.naver\.com\/</expr>
<logo>http://static.naver.net/m/comic/im/favicon/favicon_140327.ico</logo>
<encode>UTF-8</encode>
<about title="反饋" mail="xx@xx.com">
<item url="我郵箱是xx@xx.com" />
<item />
<item url="歡迎打賞插件開發者Guang,反饋問題。"/>
<item txt="點擊或掃描二維碼對[xxx]支付寶打賞" expr="https://qr.alipay.com/xxx" logo="http://xxx.jpg"/>
<item />
<item txt="掃描二維碼對我的微信打賞" logo="http://xxx.jpg"/>
<item />
</about>
</meta>
```
||下級|類型|官方說明|補充說明|
|:-|:-|:-|:-|:-|
|>meta|||||
||>ua?|String|訪問插件的默認UserAgent|此處ua標簽寫完后,后面每一級節點都可以自行設置ua屬性,不寫該屬性的話默認繼承父節點ua|
||>guid|GUID|插件唯一標識(采用小寫無間隔),此標識為插件更新提供權限保障。示例:0a00983f87a24475 bcb6759603e76f7c|有[guid在線隨機生成工具即點擊此處](http://sited.noear.org/tool/?guid=1),對不同網站做插件要設置不同的guid,如果插件中心里2個插件的guid相同,后上傳插件會覆蓋先上傳插件。升級插件時,ver加大,guid不改變|
||>title|String|插件名稱(最好不要超過5個漢字)||
||>author|String|插件開發者(最好不要超過6個字母)||
||>contact|String|插件開發者聯系方式:mail或sited磁鏈或phone|留空不寫,因為app開發者還沒做好該功能|
||>intro|String|插件介紹(顯示在插件中心列表)|寫插件介紹,最開頭在方括號里面寫插件內容類型標簽(可在標簽后面寫此次版本插件修復了什么),標簽選以下一個:[漫畫][輕小說][小說][動畫][視頻][FM][音樂][圖片][商品][資訊][直播][小游戲][小工具][綜合]|
||>alert?|String|插件提醒(用戶打開插件時,跳出提醒)|安裝插件后首次打開插件時彈窗出現該節點中文本內容,如果不寫內容或刪去該節點就不會彈窗|
||>url|String|源網站地址|只能寫一個域名。如果源網站url變化了,url節點里不要修改,而在main節點增加durl屬性為變化后網站首頁,expr節點內容里同時匹配新舊兩個域名的網址,在book節點buildUrl函數對url參數做一下域名替換,以兼容用戶在舊域名的收藏|
||>expr|String|匹配目標網址的正則表達式|寫到xx\\.com\\/就可以停下來了,保證源網站所有網頁url都被該正則表達式匹配到才能被插件解析。可寫1個以上,比如同時匹配新舊兩個域名|
||>logo?|Uri|插件圖標(顯示在插件中心列表)|寫源網站icon圖標的網址,如果不寫或刪去該節點就顯示默認圖標|
||>encode|String|目標網址的默認編碼|一般中文小說網站編碼是GBK的,該節點里寫GB18030,以更好兼容全平臺設備|
||>login?|Node|登錄|見高級篇加login節點教程|
||>about?|Node|關于(簡介、提供反饋渠道、讓人贊助等)|見下文about節點說明。不寫該節點留下聯系方式接受反饋的,就不要發布到插件中心里|
<br>
## 2.2.3 meta>about節點說明
about節點中可以寫一次title屬性和mail屬性,前者寫的內容是app打開A按鈕后彈窗首行標題;后者寫插件者電子郵箱地址(在app彈窗中點擊“反饋”后會調用郵箱軟件準備發郵件到該地址,如果沒有安裝郵箱軟件會沒有效果,所以我還會在下級的item節點加上郵箱地址文本。
|about節點下級item節點(可以寫多個)的屬性|輸出效果(每個屬性各占一行)|
|:-|:-|
|txt|普通文本|
|title|加粗文本|
|url|下劃線且A按鈕彈窗上可復制的文本|
|logo,寫圖片的網址|圖片|
|::expr|對::url或logo點擊后的用瀏覽器打開expr(expr是寫想打開的鏈接地址),expr屬性寫在url或logo的同一行|
|無屬性,只有item節點|空一行|
(本節完)
- 序言
- 第一章 基礎
- 1.1 Html基礎
- 1.2 CSS選擇器
- 1.2.1 標簽選擇器
- 1.2.2 class/id選擇器
- 1.2.3 屬性選擇器
- 1.3 JavaScript基礎
- 1.4 json基礎
- 第二章 中級
- 2.1 插件結構總覽
- 2.2 meta頭部節點講解
- 2.3 main主體節點講解
- 2.4 script腳本節點講解
- 2.5 插件的安裝調試與發布
- 第三章 高級
- 3.1 插件高級特性
- 3.2 常見內容保護突破方法
- 3.3 開發文檔所沒說的事
- 3.4 電腦js腳本測試插件
- 3.5 加login節點教程
- 3.6 使用yeoman生成器
- 3.7 自動化發布插件
- 第四章 附錄
- 4.1 markdown基本用法