OLD | NEW |
1 { | 1 { |
2 "title": { | 2 "title": { |
3 "message": "常见问题 - Adblock Plus 内部详情" | 3 "message": "常见问题 - Adblock Plus 内部详情" |
4 }, | 4 }, |
5 "s1": { | 5 "s1": { |
6 "message": "我该如何了解 Adblock Plus 所有首选项的含义?" | 6 "message": "我该如何了解 Adblock Plus 所有首选项的含义?" |
7 }, | 7 }, |
8 "s2": { | 8 "s2": { |
9 "message": " Adblock Plus 在" | 9 "message": " Adblock Plus 在 <a>about:config</a> 中包含一系列以" |
10 }, | 10 }, |
11 "s3": { | 11 "s3": { |
12 "message": "http://kb.mozillazine.org/About:config" | 12 "message": "extensions.adblockplus." |
13 }, | 13 }, |
14 "s4": { | 14 "s4": { |
15 "message": "about:config" | 15 "message": "打头的首选项。(这有别于 Adblock 和 Adblock Plus 0.5 的首选项以" |
16 }, | 16 }, |
17 "s5": { | 17 "s5": { |
18 "message": "中包含一系列以" | 18 "message": "adblock." |
19 }, | 19 }, |
20 "s6": { | 20 "s6": { |
21 "message": "extensions.adblockplus." | 21 "message": "打头)。 所有的首选项及其解释可以在<a>这里</a>查阅。" |
22 }, | 22 }, |
23 "s7": { | 23 "s7": { |
24 "message": "打头的首选项。(这有别于 Adblock 和 Adblock Plus 0.5 的首选项以" | 24 "message": "我该如何让我的扩展接入 Adblock Plus?" |
25 }, | 25 }, |
26 "s8": { | 26 "s8": { |
27 "message": "adblock." | 27 "message": " 通过" |
28 }, | 28 }, |
29 "s9": { | 29 "s9": { |
30 "message": "打头)。 所有的首选项及其解释可以在<a>这里</a>查阅。" | 30 "message": "IAdblockPlus" |
31 }, | 31 }, |
32 "s10": { | 32 "s10": { |
33 "message": "我该如何让我的扩展接入 Adblock Plus?" | 33 "message": "接口的输出,其他扩展可以集成到 Adblock Plus。详情请参阅<a>接口文档</a>。" |
34 }, | 34 }, |
35 "s11": { | 35 "s11": { |
36 "message": " 通过" | 36 "message": "Adblock Plus 是怎么过滤地址的?" |
37 }, | 37 }, |
38 "s12": { | 38 "s12": { |
39 "message": "IAdblockPlus" | 39 "message": " 实际上最难的事情是由 Firefox、Thunderbird 及其他应用程序所基于的底层引擎 -- Gecko 来完成的。它
支持一种称为 \"内容策略(content policies)\"的机制。所谓的内容策略简单来说就是一个 JavaScript(或 C++)对象,浏览器一旦需要
加载内容就必须调用它。此时它会根据地址和其他数据来判断是否加载这些内容。Gecko 引擎内置了一些内容策略(当你在 Firefox 或者 Seamonkey 中
定义哪些站点不允许加载图片的时候,实际上就是配置了一个内置的内容策略),任何扩展都可以注册自己的内容策略。因此,Adblock Plus 要做的就是注册自己的内
容策略,剩下的就只有定义哪些地址需要被阻挡的程序逻辑和配置过滤规则的用户界面了。" |
40 }, | 40 }, |
41 "s13": { | 41 "s13": { |
42 "message": "接口的输出,其他扩展可以集成到 Adblock Plus。详情请参阅<a>接口文档</a>。" | 42 "message": " 对于开发人员来说,要注册一个内容策略,您编写的 <a>XPCOM 组件</a>需要实现 <a>nsIContentPolic
y 接口</a>。通过模块的 registerSelf 方法在\"内容策略\"分类中注册您的组件(使用 <a>category manager</a> 来实现)
。然后,您就可以通过调用 shouldLoad 方法来决定是否接受指定的请求。" |
43 }, | 43 }, |
44 "s14": { | 44 "s14": { |
45 "message": "Adblock Plus 是怎么过滤地址的?" | 45 "message": "Adblock Plus 是怎么处理过滤规则的,什么样的规则处理得更快?" |
46 }, | 46 }, |
47 "s15": { | 47 "s15": { |
48 "message": " 实际上最难的事情是由 Firefox、Thunderbird 及其他应用程序所基于的底层引擎 -- Gecko 来完成的。它
支持一种称为 \"内容策略(content policies)\"的机制。所谓的内容策略简单来说就是一个 JavaScript(或 C++)对象,浏览器一旦需要
加载内容就必须调用它。此时它会根据地址和其他数据来判断是否加载这些内容。Gecko 引擎内置了一些内容策略(当你在 Firefox 或者 Seamonkey 中
定义哪些站点不允许加载图片的时候,实际上就是配置了一个内置的内容策略),任何扩展都可以注册自己的内容策略。因此,Adblock Plus 要做的就是注册自己的内
容策略,剩下的就只有定义哪些地址需要被阻挡的程序逻辑和配置过滤规则的用户界面了。" | 48 "message": " 所有的过滤规则都会在内部转换为<a>正则表达式</a>,包括那些简单规则。例如," |
49 }, | 49 }, |
50 "s16": { | 50 "s16": { |
51 "message": " 对于开发人员来说,要注册一个内容策略,您编写的" | 51 "message": "ad*banner.gif|" |
52 }, | 52 }, |
53 "s17": { | 53 "s17": { |
54 "message": "http://developer.mozilla.org/cn/docs/How_to_Build_an_XPCOM_Compo
nent_in_Javascript" | 54 "message": "会被转换为" |
55 }, | 55 }, |
56 "s18": { | 56 "s18": { |
57 "message": "XPCOM 组件" | 57 "message": "/ad.*banner\\.gif$/" |
58 }, | 58 }, |
59 "s19": { | 59 "s19": { |
60 "message": "需要实现" | 60 "message": "。Adblock Plus 在处理给定地址时需要校验所有过滤规则,但此时它并不会简单地一条接着一条校验,因为这无疑会拖慢浏览速度
。" |
61 }, | 61 }, |
62 "s20": { | 62 "s20": { |
63 "message": "http://www.xulplanet.com/references/xpcomref/ifaces/nsIContentPo
licy.html" | 63 "message": " 除了转换过滤规则为正则表达式之外,Adblock Plus 还会尝试提取其中的文本信息得到唯一一个 8 字符的字符串(称为\
"快捷方式,shortcut\")。该字符串必须包含在每个匹配过滤规则的地址中(其实字符串长度可以是任意的,只是这里 8 字符最合理)。举例来说,对于过滤规则" |
64 }, | 64 }, |
65 "s21": { | 65 "s21": { |
66 "message": "nsIContentPolicy 接口" | 66 "message": "|http://ad.*" |
67 }, | 67 }, |
68 "s22": { | 68 "s22": { |
69 "message": "。通过模块的 registerSelf 方法在\"内容策略\"分类中注册您的组件(使用" | 69 "message": ",Adblock Plus 可以选择 \"http://a\"、\"ttp://ad\" 或是 \"tp://ad.\",这些字
符串都包含在这条规则匹配的地址中。可惜的是目前我们还无法为不满足连续 8 个字符(不含通配符)的简单规则和正则表达式指定“快捷方式”。" |
70 }, | 70 }, |
71 "s23": { | 71 "s23": { |
72 "message": "http://www.xulplanet.com/references/xpcomref/ifaces/nsICategoryM
anager.html" | 72 "message": " 所有快捷方式都存放在一个可查找的表中,Adblock Plus 可以通过快捷方式非常高效地查找到相应的规则。Adblock
Plus 处理指定的地址时首先会查找这个表(查找速度非常快,几乎和快捷方式的数量无关)。只有匹配到快捷方式后才会应用相应的规则。处理没有快捷方式的规则(称为\"
慢速规则\")时,则需要对所有过滤规则一条一条地匹配。" |
73 }, | 73 }, |
74 "s24": { | 74 "s24": { |
75 "message": "category manager" | 75 "message": " 总结: 什么样的过滤规则处理速度更快?尽量少使用处理速度较慢的正则表达式,同时保证简单规则至少包含 8 个连续字符(这里所说
的\"连续\"是指不含 * 这样的特殊字符),否则等同于处理速度较慢的正则表达式。但只要简单规则符合要求,其处理时间都是一样的,与规则数量多少无关。这意味着就算
您用 20 条简单规则代替一条正则表达式都是值得的。说到这里,建议使用这个<a>小工具</a>转换正则表达式为简单规则。" |
76 }, | 76 }, |
77 "s25": { | 77 "s25": { |
78 "message": "来实现)。然后,您就可以通过调用 shouldLoad 方法来决定是否接受指定的请求。" | 78 "message": "点击这里查阅详细的过滤规则匹配算法" |
79 }, | 79 }, |
80 "s26": { | 80 "s26": { |
81 "message": "Adblock Plus 是怎么处理过滤规则的,什么样的规则处理得更快?" | 81 "message": "元素隐藏功能是怎么实现的?" |
82 }, | 82 }, |
83 "s27": { | 83 "s27": { |
84 "message": " 所有的过滤规则都会在内部转换为<a>正则表达式</a>,包括那些简单规则。例如," | 84 "message": " 元素隐藏规则会被转换为 <a>CSS</a> 并应用到所有用户正在访问的网页。像是" |
85 }, | 85 }, |
86 "s28": { | 86 "s28": { |
87 "message": "ad*banner.gif|" | 87 "message": "example.com#div(evil_ad)" |
88 }, | 88 }, |
89 "s29": { | 89 "s29": { |
90 "message": "会被转换为" | 90 "message": "这条规则会被转换为:" |
91 }, | 91 }, |
92 "s30": { | 92 "s30": { |
93 "message": "/ad.*banner\\.gif$/" | 93 "message": " @-moz-document 是一个 CSS 标准的推荐扩展规则,您可以查阅 <a>Mozilla 开发者中心</a>。" |
94 }, | 94 }, |
95 "s31": { | 95 "s31": { |
96 "message": "。Adblock Plus 在处理给定地址时需要校验所有过滤规则,但此时它并不会简单地一条接着一条校验,因为这无疑会拖慢浏览速度
。" | 96 "message": " 对于那些没有指定域名的规则会按照 http:// 和 https:// 进行处理,防止这些规则应用到浏览器的用户界面(它使用
的是 chrome:// 协议模型)。例如," |
97 }, | 97 }, |
98 "s32": { | 98 "s32": { |
99 "message": " 除了转换过滤规则为正则表达式之外,Adblock Plus 还会尝试提取其中的文本信息得到唯一一个 8 字符的字符串(称为\
"快捷方式,shortcut\")。该字符串必须包含在每个匹配过滤规则的地址中(其实字符串长度可以是任意的,只是这里 8 字符最合理)。举例来说,对于过滤规则" | 99 "message": "#div(evil_ad)" |
100 }, | 100 }, |
101 "s33": { | 101 "s33": { |
102 "message": "|http://ad.*" | 102 "message": "这条规则会被转换为:" |
103 }, | 103 }, |
104 "s34": { | 104 "s34": { |
105 "message": ",Adblock Plus 可以选择 \"http://a\"、\"ttp://ad\" 或是 \"tp://ad.\",这些字
符串都包含在这条规则匹配的地址中。可惜的是目前我们还无法为不满足连续 8 个字符(不含通配符)的简单规则和正则表达式指定“快捷方式”。" | 105 "message": " 对于开发人员来说, Adblock Plus 使用的是<a>这个</a>样式表服务实现元素隐藏功能。这个接口是在 Gecko
1.8 时引入的,它允许扩展动态加载用户自定义 CSS(在此之前只能通过修改 userContent.css 并重启浏览器才能生效)。用户自定义 CSS 会覆
盖所有网站的 CSS 代码,因为它具有最高的<a>优先级</a>。" |
106 }, | 106 }, |
107 "s35": { | 107 "s35": { |
108 "message": " 所有快捷方式都存放在一个可查找的表中,Adblock Plus 可以通过快捷方式非常高效地查找到相应的规则。Adblock
Plus 处理指定的地址时首先会查找这个表(查找速度非常快,几乎和快捷方式的数量无关)。只有匹配到快捷方式后才会应用相应的规则。处理没有快捷方式的规则(称为\"
慢速规则\")时,则需要对所有过滤规则一条一条地匹配。" | 108 "message": "过滤规则文件的第一行表示什么?" |
109 }, | 109 }, |
110 "s36": { | 110 "s36": { |
111 "message": " 总结: 什么样的过滤规则处理速度更快?尽量少使用处理速度较慢的正则表达式,同时保证简单规则至少包含 8 个连续字符(这里所说
的"连续"是指不含 * 这样的特殊字符),否则等同于处理速度较慢的正则表达式。但只要简单规则符合要求,其处理时间都是一样的,与规则数量多少无
关。这意味着就算您用 20 条简单规则代替一条正则表达式都是值得的。说到这里,建议使用这个<a>小工具</a>转换正则表达式为简单规则。" | 111 "message": " 过滤规则文件的第一行通常都是" |
112 }, | 112 }, |
113 "s37": { | 113 "s37": { |
114 "message": "点击这里查阅详细的过滤规则匹配算法" | 114 "message": "[Adblock]" |
115 }, | 115 }, |
116 "s38": { | 116 "s38": { |
117 "message": "元素隐藏功能是怎么实现的?" | 117 "message": "。但您可能发现在最近版本的 Adblock Plus 中过滤文件第一行有时显示为其他文字,这是由于您列表中部分过滤规则的语法只支
持新版本 Adblock Plus 而不支持早期的 Adblock。例如:" |
118 }, | 118 }, |
119 "s39": { | 119 "s39": { |
120 "message": " 元素隐藏规则会被转换为" | 120 "message": " 这里括号中的内容只是一个注释,Adblock 或 Adblock Plus 读取时会忽略实际标记之前的任何内容。由于 Adb
lock Plus 0.6.1.2 还不支持这种写法,因此这里 Adblock Plus 不会强制要求用户更新到新版本。然而,如果您使用更加新的过滤规则语法,则
第一行有可能会变成:" |
121 }, | 121 }, |
122 "s40": { | 122 "s40": { |
123 "message": "http://www.w3.org/TR/CSS21/" | 123 "message": " 上面这种写法是从 Adblock Plus 0.7.1 开始支持的,而之前版本的 Adblock Plus 以及 Adblo
ck 则无法打开这种文件。Adblock Plus 会将文件第一行的版本号和扩展自身版本号进行比较,如果文件要求的版本号高于扩展当前版本号,则 Adblock
Plus 会提示用户更新到新版本。对于过滤规则订阅,它仍会加载这个文件,但会在首选项对话框显示扩展更新提示。" |
124 }, | 124 }, |
125 "s41": { | 125 "s41": { |
126 "message": "CSS" | 126 "message": " 最后,如果只想兼容 Adblock Plus 但不在乎其版本号,您可以将文件第一行修改为" |
127 }, | 127 }, |
128 "s42": { | 128 "s42": { |
129 "message": "并应用到所有用户正在访问的网页。像是" | 129 "message": "[Adblock Plus]" |
130 }, | 130 }, |
131 "s43": { | 131 "s43": { |
132 "message": "example.com#div(evil_ad)" | |
133 }, | |
134 "s44": { | |
135 "message": "这条规则会被转换为:" | |
136 }, | |
137 "s45": { | |
138 "message": "@-moz-document domain(example.com)\n{\n div#evil_ad, div.evil_a
d\n {\n display: none !important;\n }\n}" | |
139 }, | |
140 "s46": { | |
141 "message": " @-moz-document 是一个 CSS 标准的推荐扩展规则,您可以查阅" | |
142 }, | |
143 "s47": { | |
144 "message": "https://developer.mozilla.org/en/CSS/@-moz-document" | |
145 }, | |
146 "s48": { | |
147 "message": "Mozilla 开发者中心" | |
148 }, | |
149 "s49": { | |
150 "message": "。" | |
151 }, | |
152 "s50": { | |
153 "message": " 对于那些没有指定域名的规则会按照 http:// 和 https:// 进行处理,防止这些规则应用到浏览器的用户界面(它使用
的是 chrome:// 协议模型)。例如," | |
154 }, | |
155 "s51": { | |
156 "message": "#div(evil_ad)" | |
157 }, | |
158 "s52": { | |
159 "message": "这条规则会被转换为:" | |
160 }, | |
161 "s53": { | |
162 "message": "@-moz-document url-prefix(http://),url-prefix(https://)\n{\n di
v#evil_ad, div.evil_ad\n {\n display: none !important;\n }\n}" | |
163 }, | |
164 "s54": { | |
165 "message": " 对于开发人员来说, Adblock Plus 使用的是" | |
166 }, | |
167 "s55": { | |
168 "message": "https://developer.mozilla.org/en/XPCOM_Interface_Reference/nsISt
yleSheetService" | |
169 }, | |
170 "s56": { | |
171 "message": "这个" | |
172 }, | |
173 "s57": { | |
174 "message": "样式表服务实现元素隐藏功能。这个接口是在 Gecko 1.8 时引入的,它允许扩展动态加载用户自定义 CSS(在此之前只能通过修
改 userContent.css 并重启浏览器才能生效)。用户自定义 CSS 会覆盖所有网站的 CSS 代码,因为它具有最高的" | |
175 }, | |
176 "s58": { | |
177 "message": "http://www.w3.org/TR/CSS21/cascade.html#cascading-order" | |
178 }, | |
179 "s59": { | |
180 "message": "优先级" | |
181 }, | |
182 "s60": { | |
183 "message": "。" | |
184 }, | |
185 "s61": { | |
186 "message": "过滤规则文件的第一行表示什么?" | |
187 }, | |
188 "s62": { | |
189 "message": " 过滤规则文件的第一行通常都是" | |
190 }, | |
191 "s63": { | |
192 "message": "[Adblock]" | |
193 }, | |
194 "s64": { | |
195 "message": "。但您可能发现在最近版本的 Adblock Plus 中过滤文件第一行有时显示为其他文字,这是由于您列表中部分过滤规则的语法只支
持新版本 Adblock Plus 而不支持早期的 Adblock。例如:" | |
196 }, | |
197 "s65": { | |
198 "message": "(Adblock Plus 0.6.1.2 or higher required) [Adblock]" | |
199 }, | |
200 "s66": { | |
201 "message": " 这里括号中的内容只是一个注释,Adblock 或 Adblock Plus 读取时会忽略实际标记之前的任何内容。由于 Adb
lock Plus 0.6.1.2 还不支持这种写法,因此这里 Adblock Plus 不会强制要求用户更新到新版本。然而,如果您使用更加新的过滤规则语法,则
第一行有可能会变成:" | |
202 }, | |
203 "s67": { | |
204 "message": "[Adblock Plus 0.7.1]" | |
205 }, | |
206 "s68": { | |
207 "message": " 上面这种写法是从 Adblock Plus 0.7.1 开始支持的,而之前版本的 Adblock Plus 以及 Adblo
ck 则无法打开这种文件。Adblock Plus 会将文件第一行的版本号和扩展自身版本号进行比较,如果文件要求的版本号高于扩展当前版本号,则 Adblock
Plus 会提示用户更新到新版本。对于过滤规则订阅,它仍会加载这个文件,但会在首选项对话框显示扩展更新提示。" | |
208 }, | |
209 "s69": { | |
210 "message": " 最后,如果只想兼容 Adblock Plus 但不在乎其版本号,您可以将文件第一行修改为" | |
211 }, | |
212 "s70": { | |
213 "message": "[Adblock Plus]" | |
214 }, | |
215 "s71": { | |
216 "message": "。当然这样的过滤规则文件只支持 Adblock Plus 0.7.1 及更高版本。" | 132 "message": "。当然这样的过滤规则文件只支持 Adblock Plus 0.7.1 及更高版本。" |
217 } | 133 } |
218 } | 134 } |
OLD | NEW |