Les filtres personnalisés de Maxthon v2.0
Version: 2.0.1 Last Modified: 2006-07-17 5:42 PM
Overview
The new filter system of Maxthon Browser 2.0 can be customized.
Custom Filter Proprties
The INI File is where you instruct Maxthon how to process your skin files. You can build your own skin by following the guide of this section or by modifying an exist skin.
属性： ○可选 √必须 －无
TXT URL REQ RESP 说明
name
√ 项目名称
type
√ 项目类型（text, url, requestheader, responseheader）
action
√ 处理方式，见action类型定义
postaction
√ 后期处理方式。见postaction类型定义
priority
√ 项目优先级，大于零的整数，数值越大优先级越高(0～999)
enable
○ 该项目是否启用。值：1（启用），0（禁用）。缺省为0
header
－ － √ √ 要匹配的Header Name
match_url
○ √ ○ ○ URL匹配串
exclude_url
○ ○ ○ ○ URL例外（符合该串的不过滤）
bound
○ － － － 用于查找match的范围的匹配串
max_bound_size
○ － － － bound最大的匹配范围（最大值2048）
缺省值为最大值
match
√ － √ √ 文本匹配串
match_count
√ － － － 每个页面的匹配次数限制
exclude
○ － ○ ○ match例外（符合该串的不过滤）
replace
√ ○ ○ ○ 用于替换的字符串
return
－ ○ ○ ○ 返回该字符串给浏览器
Action（处理方式）类型定义
0
√ √ √ √ 无操作
1
－ － √ √ 删除 该header
2
－ － √ √ 增加 该Header，值为replace
3
√ √ √ √ 替换 用replace替换match(match_url)所匹配的字符串
（也用于文件头$FILESTART、文件尾$FILEEND模式）
PostAction（处理方式）类型定义
0
√ √ √ √ 无操作
1
√ √ √ √ 不再处理同类的filter
2
－ √ √ √ 关闭 当前连接
3
－ √ √ √ 返回return字符串，关闭当前连接
函数语法 关键字
含义
$KEYWORDS(LISTNAME)
将内容替换为括号内指定的关键字列表内容。
LISTNAME为该关键字列表的名称（blacklist whitelist为系统保留名称，如果filter重用该名称则以filter自定义的为准）
$BASE64(string)
说明括号内部的内容是经过base64编码的，使用时需要解码。
$STR(string)
用来表示string是html中的一个字符串，即string前后可能为””,’’,或者前后为空。
$FILECONTENT(string)
读取文件(string)的内容来替换该串。仅用于replace。
$TAG(string)
获取类似< string href=”#”>...</a>的标记，包括<string href=”#”>未关闭标记。仅用于Bound
附：正则表达式(Regular Expression)说明 基本语法 /pattern/
结果
.
匹配除 "\n" 之外的任何单个字符。要匹配包括 '\n' 在内的任何字符，请使用象 '[.\n]' 的模式。
[ ]
指定一个字符类，匹配方括号内的任意字符。例：[abc] 匹配 "a", "b"或 "c"。
^
如果^出现在字符类的开始处，它否定了字符类，这个被否定的字符类匹配除却方括号内的字符的字符。如：[^abc]匹配除了"a", "b"和"c"之外的字符。如果^出现在正则表达式前边，它匹配输入的开头，例：^[abc]匹配以"a", "b"或"c"开头的输入。
$
放在正则表达式的最后，它匹配输入的末端。例如：[0-9]$匹配输入的最后一个数字。
-
在字符类中，指定一个字符的范围。例如：[0-9]匹配"0"到"9"的数字。
?
匹配前面的子表达式零次或一次。例如，"do(es)?" 可以匹配 "do" 或 "does" 中的"do" 。? 等价于 {0,1}。
+
匹配前面的子表达式一次或多次。例如，'zo+' 能匹配 "zo" 以及 "zoo"，但不能匹配 "z"。+ 等价于 {1,}。
匹配前面的子表达式零次或多次。例如，zo* 能匹配 "z" 以及 "zoo"。 * 等价于{0,}。
??, +?, *?，{n}?,{n,}?,{n,m}?
?, +,*, {n}, {n,}, {n,m}的非贪婪匹配版本，它们尽可能匹配较少的字符；而?, +,*, {n}, {n,}, {n,m}则是贪婪版本，尽可能匹配较多的字符。例如：输入"<abc><def>", 则<.*?> 匹配"<abc>"，而<.*>匹配"<abc><def>"。
( )
分组操作符。例如：(\d+,)*\d+匹配一串由逗号分开的数字，例如： "1"或"1,23,456"。
(pattern)
匹配pattern 并获取这一匹配。所获取的匹配可以从产生的 Matches 集合得到
(?:pattern)
匹配 pattern 但不获取匹配结果，也就是说这是一个非获取匹配，不进行存储供以后使用。这在使用 "或" 字符 (|) 来组合一个模式的各个部分是很有用。例如， 'industr(?:y|ies) 就是一个比 'industry|industries' 更简略的表达式。
(?=pattern)
正向预查，在任何匹配 pattern 的字符串开始处匹配查找字符串。这是一个非获取匹配，也就是说，该匹配不需要获取供以后使用。例如， 'Windows (?=95|98|NT|2000)' 能匹配 "Windows 2000" 中的 "Windows" ，但不能匹配 "Windows 3.1" 中的 "Windows"。预查不消耗字符，也就是说，在一个匹配发生后，在最后一次匹配之后立即开始下一次匹配的搜索，而不是从包含预查的字符之后开始。
(?!pattern)
负向预查，在任何不匹配pattern的字符串开始处匹配查找字符串。这是一个非获取匹配，也就是说，该匹配不需要获取供以后使用。例如'Windows (?!95|98|NT|2000)' 能匹配 "Windows 3.1" 中的 "Windows"，但不能匹配 "Windows 2000" 中的 "Windows"。预查不消耗字符，也就是说，在一个匹配发生后，在最后一次匹配之后立即开始下一次匹配的搜索，而不是从包含预查的字符之后开始
\
转义字符，转义紧跟的字符。例如，[0-9]+ 匹配一个或多个数字，而 [0-9]\+ 匹配一个数字后跟随一个加号的情况。
反斜杠\也用于表示缩写，\a 就表示任何数字、字母。 如果\后紧跟一个数字n，则它匹配第n个匹配群组(从0开始)，例如，<{.*?}>.*?</\0>匹配"<head>Contents</head>"。注意，在C++字符串中，反斜杠\需要用双反斜杠\\来表示： "\\+", "\\a", "<{.*?}>.*?</\\0>"。
|
间隔符，分隔两个表达式，以正确匹配其中一个，例如：T|the匹配"The" 或"the"。
{n}
n 是一个非负整数。匹配确定的 n 次。例如，'o{2}' 不能匹配 "Bob" 中的 'o'，但是能匹配 "food" 中的两个 o。
{n,}
n 是一个非负整数。至少匹配n 次。例如，'o{2,}' 不能匹配 "Bob" 中的 'o'，但能匹配 "foooood" 中的所有 o。'o{1,}' 等价于 'o+'。'o{0,}' 则等价于 'o*'。
{n,m}
m 和 n 均为非负整数，其中n <= m。最少匹配 n 次且最多匹配 m 次。 "o{1,3}" 将匹配 "fooooood" 中的前三个 o。'o{0,1}' 等价于 'o?'。请注意在逗号和两个数之间不能有空格。
缩写语法 范例
说明
\a
字母、数字([a-zA-Z0-9])
\b
空格(blank): ([ \\t])
\B
非空格字符
\c
字母([a-zA-Z])
\cx
匹配由x指明的控制字符。例如， \cM 匹配一个 Control-M 或回车符。 x 的值必须为 A-Z 或 a-z 之一。否则，将 c 视为一个原义的 'c' 字符。
\d
十进制数 ([0-9])
\D
匹配一个非数字字符。等价于 [^0-9]。
\f
匹配一个换页符。等价于 \x0c 和 \cL。
\h
十六进制数([0-9a-fA-F])
\n
换行: (\r|(\r?\n))
\num
匹配 num，其中 num 是一个正整数。对所获取的匹配的引用。例如，'(.)\1' 匹配两个连续的相同字符。
\r
匹配一个回车符。等价于 \x0d 和 \cM。
\s
匹配任何空白字符，包括空格、制表符、换页符等等。等价于 [ \f\n\r\t\v]。
\S
匹配任何非空白字符。等价于 [^ \f\n\r\t\v]。
\t
匹配一个制表符。等价于 \x09 和 \cI。
\v
匹配一个垂直制表符。等价于 \x0b 和 \cK。
\q
引用字符串(\"[^\"]*\")|(\'[^\']*\')
\un
匹配 n，其中 n 是一个用四个十六进制数字表示的 Unicode 字符。例如， \u00A9 匹配版权符号 (?)。
\w
匹配包括下划线的任何单词字符。等价于'[A-Za-z0-9_]'。
\W
匹配任何非单词字符。等价于 '[^A-Za-z0-9_]'
\xn
匹配 n，其中 n 为十六进制转义值。十六进制转义值必须为确定的两个数字长。例如， '\x41' 匹配 "A"。'\x041' 则等价于 '\x04' & "1"。正则表达式中可以使用 ASCII 编码。
\z
一个整数([0-9]+)