OLD | NEW |
(Empty) | |
| 1 { |
| 2 "s1": { |
| 3 "message": "Текущие версии Adblock Plus позволяют вам \"настраивать\" фильтр
ы многими разными способами. Этот документ расскажет о выборе, который у вас ест
ь, и о том, как его использовать." |
| 4 }, |
| 5 "s10": { |
| 6 "description": "{1}: adv, {2}: http://example.com/advice.html, {3}: @@advice
, {4}: @@", |
| 7 "message": "Для этого случая есть исключающие правила - они позволяют вам оп
ределить, в каком случае фильтры не должны применяться. Например, если фильтр <c
ode>{1}</code> блокирует <code>{2}</code>, вы можете установить исключающее прав
ило <code>{3}</code>. Исключающие правила не отличаются правил фильтров, вы може
те использовать символы обобщения или регулярные выражения. Только вы должны нач
инать их с <code>{4}</code>, указывающее на исключающее правило." |
| 8 }, |
| 9 "s100": { |
| 10 "message": "Правила-исключения «выключают» отдельные правила блокировки и ск
рытия на определённых доменах." |
| 11 }, |
| 12 "s101": { |
| 13 "message": "В основном они полезны авторам подписок, дополняющих сторонние п
одписки, которые они не могут изменить." |
| 14 }, |
| 15 "s102": { |
| 16 "description": "{1}: ##div.textad, {2}: example.com, {3}: example.com#@#div.
textad", |
| 17 "message": "Например, правило <code>{1}</code> можно выключить на <code>{2}<
/code> добавив исключение <code>{3}</code>." |
| 18 }, |
| 19 "s103": { |
| 20 "description": "{1}: ~example.com##div.textad", |
| 21 "message": "Комбинация этих двух правил идентична по эффекту одному правилу
<code>{1}</code>." |
| 22 }, |
| 23 "s104": { |
| 24 "message": "Применять такие исключения рекомендуется только в случае, когда
изменить само правило скрытия не представляется возможным, во всех остальных слу
чаях лучше изменить само правило." |
| 25 }, |
| 26 "s105": { |
| 27 "message": "Упрощённый синтаксис скрытия элементов" |
| 28 }, |
| 29 "s106": { |
| 30 "description": "{1}: #div(id=foo)", |
| 31 "message": "Исключительно для сохранения обратной совместимости Adblock Plus
поддерживает упрощённый синтаксис скрытия элементов (напр., <code>{1}</code>).
Использовать его крайне не желательно, а лучше использовать обычные CSS селектор
ы. В будущем поддержка будет вовсе удалена." |
| 32 }, |
| 33 "s12": { |
| 34 "message": "Соответствие началу/концу адреса" |
| 35 }, |
| 36 "s13": { |
| 37 "description": "{1}: ad, {2}: *ad*, {3}: swf, {4}: http://example.com/swf/in
dex.html", |
| 38 "message": "Обычно Adblock Plus обрабатывает каждый фильтр так,как если бы о
н имел обобщения в начале и в конце. Например, нет разницы между фильтрами <code
>{1}</code> и <code>{2}</code>.Обычно это не является проблемой, но иногда вы мо
жете захотеть, чтобы ваш фильтр соответствовал в начале или в конце адресов. Нап
ример, вы можете захотеть заблокировать весь Flash, но если вы добавите фильтр <
code>{3}</code> , адрес <code>{4}</code> также будет заблокирован." |
| 39 }, |
| 40 "s14": { |
| 41 "description": "{1}: swf|, {2}: http://example.com/annoyingflash.swf, {3}: h
ttp://example.com/swf/index.html", |
| 42 "message": "Решение проблемы: добавьте к фильтру символ |, чтобы показать, ч
то конец адреса находится в этой точке. Например, фильтр <code>{1}</code> будет
блокировать <code>{2}</code> , но не <code>{3}</code>. А фильтр <code>|http://ba
ddomain.example/</code> будет блокировать <code>http://baddomain.example/banner.
gif</code> , но не <code>http://gooddomain.example/analyze?http://baddomain.exam
ple</code>." |
| 43 }, |
| 44 "s15": { |
| 45 "description": "{1}: http://example.com/banner.gif, {2}: https://example.com
/banner.gif, {3}: http://www.example.com/banner.gif, {4}: ||example.com/banner.g
if", |
| 46 "message": "Иногда хочется заблокировать <code>{1}</code> вместе с <code>{2}
</code> и <code>{3}</code>. Этого можно достичь добавлением пары символов | в на
чало фильтра соответствующего началу доменного имени: <code>{4}</code> заблокиру
ет все эти адреса и не тронет <code>http://badexample.com/banner.gif</code> или
<code>http://gooddomain.example/analyze?http://example.com/banner.gif</code> (не
обходим Adblock Plus 1.1 и выше)." |
| 47 }, |
| 48 "s16": { |
| 49 "message": "Разделительные символы" |
| 50 }, |
| 51 "s17": { |
| 52 "description": "{1}: http://example.com/, {2}: http://example.com:8000/, {3}
: http://example.com.ar/, {4}: http://example.com^", |
| 53 "message": "Часто вам нужно будет применить в фильтре любой разделительный с
имвол. Например, вы можете написать фильтр, который блокирует <code>{1}</code> и
<code>{2}</code> , но не <code>{3}</code>. Здесь символ ^ может быть использова
н как указатель для одного разделительного символа: <code>{4}</code> (необходим
Adblock Plus 1.1 и выше)." |
| 54 }, |
| 55 "s18": { |
| 56 "description": "{1}: _ - . %", |
| 57 "message": "Разделителем может быть любой символ кроме буквы, цифры и следую
щих символов: {1}. К концу адреса также применим разделитель. В следующем пример
е все разделители показаны красным:" |
| 58 }, |
| 59 "s19": { |
| 60 "description": "{1}: ^example.com^, {2}: ^%D1%82%D0%B5%D1%81%D1%82^, {3}: ^f
oo.bar^", |
| 61 "message": ". Также этот адрес может быть блокирован фильтром <code>{1}</cod
e> или <code>{2}</code> или <code>{3}</code>." |
| 62 }, |
| 63 "s2": { |
| 64 "message": "<em>Ответственность</em>: Все примеры фильтров приведённые здесь
являются только примерами и не предназначены для использования." |
| 65 }, |
| 66 "s20": { |
| 67 "message": "Комментарии" |
| 68 }, |
| 69 "s21": { |
| 70 "message": "Любое правило, начинающееся с восклицательного знака содержит ко
мментарий. Оно отображается в списке фильтров серым цветом. Adblock Plus будет и
гнорировать это правило при блокировании, так что можете спокойно писать там всё
, что хотите. Вы можете расположить комментарий выше реального фильтра, чтобы оп
исать для чего он нужен. Или вы можете разместить комментарий с указанием вашего
авторства вверху списка фильтров (так делают большинство авторов)." |
| 71 }, |
| 72 "s3": { |
| 73 "message": "Введение" |
| 74 }, |
| 75 "s4": { |
| 76 "message": "Параметров описанных в этом разделе должно быть достаточно для с
оздания фильтров по мере необходимости." |
| 77 }, |
| 78 "s5": { |
| 79 "message": "Основные правила" |
| 80 }, |
| 81 "s51": { |
| 82 "message": "Расширенные возможности" |
| 83 }, |
| 84 "s52": { |
| 85 "message": "Возможности, описанные в этом разделе, обычно используются опытн
ыми пользователями или создателями подписок. Вы можете пропустить его." |
| 86 }, |
| 87 "s53": { |
| 88 "message": "Специфические опции фильтра" |
| 89 }, |
| 90 "s54": { |
| 91 "message": "Adblock Plus позволяет вам определить число параметров, изменяющ
их поведение фильтра. Список этих параметров располагается в конце фильтра после
знака доллара ($) и разделяется запятыми, например:" |
| 92 }, |
| 93 "s55": { |
| 94 "description": "{1}: */ads/*, {2}: script, {3}: match-case", |
| 95 "message": "Здесь <code>{1}</code> текущий фильтр <code>{2}</code> и <code>{
3}</code> его параметры. В настоящее время поддерживаются следующие параметры:" |
| 96 }, |
| 97 "s56": { |
| 98 "message": "Типы параметров: определяют, какие типы элементов могут быть заб
локированы фильтром (или пропущены в случае исключающего правила). Составной тип
параметров, может быть определен, чтобы показать, что фильтр может быть примене
н к нескольким типам элементов. Доступные типы:" |
| 99 }, |
| 100 "s57": { |
| 101 "description": "{1}: script", |
| 102 "message": "<code>{1}</code> — внешние файлы скриптов загруженные через HTML
-тэг SCRIPT" |
| 103 }, |
| 104 "s58": { |
| 105 "description": "{1}: image", |
| 106 "message": "<code>{1}</code> — обычные изображения, загруженные через HTML-т
эг IMG" |
| 107 }, |
| 108 "s59": { |
| 109 "description": "{1}: stylesheet", |
| 110 "message": "<code>{1}</code> — внешние CSS-файлы стилей" |
| 111 }, |
| 112 "s6": { |
| 113 "description": "{1}: http://example.com/ads/banner123.gif, {2}: http://examp
le.com/ads/banner*.gif, {3}: http://example.com/ads/*", |
| 114 "message": "Наиболее простой фильтр это адрес баннера, который вы хотите заб
локировать. Однако, часто этот адрес изменяется каждый раз при загрузке страницы
. Например, он может быть <code>{1}</code> где 123 -случайное число. В этом случ
ае блокирование по адресу вам не поможет, вам нужен более общий фильтр, такой ка
к <code>{2}</code>. Или, может быть, даже <code>{3}</code>." |
| 115 }, |
| 116 "s60": { |
| 117 "description": "{1}: object", |
| 118 "message": "<code>{1}</code> — содержимое, управляемое плагинами браузера, н
апр. Flash или Java" |
| 119 }, |
| 120 "s62": { |
| 121 "description": "{1}: xmlhttprequest", |
| 122 "message": "<code>{1}</code> — запросы, инициируемые <a>XMLHttpRequest объек
том</a> (описание на английском)" |
| 123 }, |
| 124 "s63": { |
| 125 "description": "{1}: object-subrequest", |
| 126 "message": "<code>{1}</code> — запросы инициированные плагинами вроде Flash" |
| 127 }, |
| 128 "s64": { |
| 129 "description": "{1}: subdocument", |
| 130 "message": "<code>{1}</code> — встроенные страницы, обычно при помощи HTML-ф
реймов" |
| 131 }, |
| 132 "s65": { |
| 133 "description": "{1}: document", |
| 134 "message": "<code>{1}</code> — сама страница (только <a>исключающие правила<
/a> могут быть применены к этой странице)" |
| 135 }, |
| 136 "s66": { |
| 137 "description": "{1}: elemhide, {2}: document", |
| 138 "message": "<code>{1}</code> — только для исключающих правил, схоже с <code>
{2}</code> но отключает только <a>правила скрытия элементов</a>, а не все правил
а фильтрации на странице (требуется Adblock Plus 1.2 и выше)" |
| 139 }, |
| 140 "s67": { |
| 141 "description": "{1}: other", |
| 142 "message": "<code>{1}</code> — типы запросов не перечисленные выше" |
| 143 }, |
| 144 "s68": { |
| 145 "description": "{1}: background, {2}: xbl, {3}: ping, {4}: dtd", |
| 146 "message": "Типы <code>{1}</code>, <code>{2}</code>, <code>{3}</code> и <co
de>{4}</code> устарели и их не следует более использовать." |
| 147 }, |
| 148 "s69": { |
| 149 "description": "{1}: ~script, {2}: ~image, {3}: ~stylesheet, {4}: ~object, {
5}: ~xmlhttprequest, {6}: ~object-subrequest, {7}: ~subdocument, {8}: ~document,
{9}: ~elemhide, {10}: ~other", |
| 150 "message": "Обратные типы параметров: определяет типы элементов, фильтр к ко
торым применяться <strong>не</strong> должен. Доступные параметры обратных типов
: <code>{1}</code>, <code>{2}</code>, <code>{3}</code>, <code>{4}</code>, <code>
{5}</code>, <code>{6}</code>, <code>{7}</code>, <code>{8}</code>, <code>{9}</cod
e>, <code>{10}</code>" |
| 151 }, |
| 152 "s7": { |
| 153 "description": "{1}: http://example.com/*", |
| 154 "message": "<em>Примечание</em>: Убедитесь, что вы не обобщили слишком много
е. Фильтр <code>{1}</code> безусловно, заблокирует все баннеры, но также заблоки
рует всё остальное с example.com то, что вы можете захотеть увидеть." |
| 155 }, |
| 156 "s70": { |
| 157 "description": "{1}: third-party, {2}: ~third-party", |
| 158 "message": "Ограничение на сторонние/собственные запросы: Если указана опция
<code>{1}</code>, то фильтр применяется лишь к запросам ресурсов из внешних ист
очников. Аналогично, <code>{2}</code> ограничивает фильтр запросами из того-же и
сточника, что и открытая страница." |
| 159 }, |
| 160 "s71": { |
| 161 "description": "{1}: domain=example.com, {2}: domain=example.com|example.net
, {3}: domain=~example.com, {4}: domain=example.com|~foo.example.com", |
| 162 "message": "Ограничители доменов: Параметр <code>{1}</code> означает, что фи
льтр должен быть применён только на страницах домена \"example.com\". Множество
доменов можно установить, используя \"|\" как разделитель: с параметром <code>{2
}</code> фильтр будет применён только на страницах доменов \"example.com\" или \
"example.net\". Если доменное имя начинается с \"~\", фильтр <strong>не</strong>
должен применяться на страницах этого домена. Например, <code>{3}</code> показы
вает, что фильтр должен применяться на страницах любого домена, но \"example.co
m\" и <code>{4}</code> ограничивает фильтр доменом \"example.com\" исключая подд
омен \"foo.example.com\"." |
| 163 }, |
| 164 "s73": { |
| 165 "description": "{1}: match-case, {2}: */BannerAd.gif$match-case, {3}: http:/
/example.com/BannerAd.gif, {4}: http://example.com/bannerad.gif", |
| 166 "message": "<code>{1}</code> — определяет фильтр, который применяется только
к адресам с совпадением букв, например фильтр <code>{2}</code> будет блокироват
ь <code>{3}</code>, но не <code>{4}</code>." |
| 167 }, |
| 168 "s74": { |
| 169 "description": "{1}: collapse, {2}: ~collapse", |
| 170 "message": "<code>{1}</code> — эта опция принудительно включает скрытие для
данного элемента не смотря на значение глобальной настройки «Прятать метки на ме
сте заблокированных элементов». Соответственно опция <code>{2}</code> выключает
скрытие свободного места от данного элемента." |
| 171 }, |
| 172 "s75": { |
| 173 "description": "{1}: donottrack", |
| 174 "message": "<code>{1}</code> — для каждого адреса, который подходит под прав
ило блокирования с этим параметром и не соответствует никаким исключающим правил
ам с этим параметром, Adblock Plus будет посылать <a>заголовок Do-Not-Track</a>
(необходим Adblock Plus 1.3.5 или выше)." |
| 175 }, |
| 176 "s76": { |
| 177 "description": "{1}: *$donottrack,image,~image", |
| 178 "message": "Для обратной совместимости рекомендуется использовать этот парам
етр с противоречивыми параметрами типа. Это гарантирует, что в старых версиях Ad
block Plus этот фильтр ничего не заблокирует: <code>{1}</code>" |
| 179 }, |
| 180 "s77": { |
| 181 "message": "Использование регулярных выражений" |
| 182 }, |
| 183 "s79": { |
| 184 "description": "{1}: /banner\\d+/, {2}: banner123, {3}: banner321, {4}: bann
ers", |
| 185 "message": "Если желаете добиться большего контроля над тем, к чему ваши фил
ьтры подходят, а к чему нет, то можете использовать регулярные выражения. Наприм
ер, фильтр <code>{1}</code> подойдёт к <code>{2}</code> и <code>{3}</code> , но
не <code>{4}</code>. Изучите <a>документацию по регулярным выражениям</a> и смож
ете составлять их сами." |
| 186 }, |
| 187 "s8": { |
| 188 "message": "Исключающие правила" |
| 189 }, |
| 190 "s80": { |
| 191 "message": "<em>Примечание</em>: Для повышения производительности рекомендуе
тся не использовать регулярные выражения, если этого можно избежать." |
| 192 }, |
| 193 "s81": { |
| 194 "message": "Скрытие элементов" |
| 195 }, |
| 196 "s82": { |
| 197 "message": "Основные правила" |
| 198 }, |
| 199 "s83": { |
| 200 "message": "Иногда вы будете встречать рекламу, которая не может быть заблок
ирована потому, что она была внедрена как текст в саму веб-страницу. Если вы пос
мотрите исходный код такой страницы, то найдёте нечто вроде этого:" |
| 201 }, |
| 202 "s84": { |
| 203 "message": "Для корректного отображения страницу необходимо полностью, а зна
чит и реклама будет скачана и этого нельзя избежать. Всё, что тут можно сделать
- скрыть то, что не желаете видеть. Для этого и применяются правила скрытие элем
ентов." |
| 204 }, |
| 205 "s85": { |
| 206 "description": "{1}: ##div.textad, {2}: ##div#sponsorad, {3}: ##*#sponsorad,
{4}: ##textad", |
| 207 "message": "Первый рекламный слоган выше находится внутри элемента DIV с кла
ссом «textad». Следующее правило скроет скроет именно такую комбинацию: <code>{1
}</code>. Тут «##» является признаком правила скрытия, а остальное — селектором,
определяющим скрываемый элемент. Скрывать элементы по их атрибуту ID можно анал
огичным образом, <code>{2}</code> скроет второй слоган. Указывать имя самого эле
мента не обязательно, фильтр <code>{3}</code> так же будет работать (* тоже не о
бязательна). Также можно скрывать элементы лишь по их имени. Например, <code>{4}
</code> скроет третий рекламный слоган." |
| 208 }, |
| 209 "s86": { |
| 210 "message": "Расширение <a>Element Hiding Helper</a> поможет в выборе нужного
элемента и написании соответствующего правила без изучения исходного кода стран
ицы. Базовые знания в HTML желательны в любом случае." |
| 211 }, |
| 212 "s87": { |
| 213 "message": "<em>Примечание</em>: Правила скрытие кардинально отличается от о
бычных фильтров. Например, не поддерживаются привычные символы масок — они имеют
другое значение и применение." |
| 214 }, |
| 215 "s88": { |
| 216 "message": "Ограничение правил определенными доменами" |
| 217 }, |
| 218 "s89": { |
| 219 "description": "{1}: ##*.sponsor, {2}: example.com##*.sponsor, {3}: http://e
xample.com/, {4}: http://something.example.com/, {5}: http://example.org/, {6}:
domain1.example,domain2.example,domain3.example##*.sponsor", |
| 220 "message": "Обычно вы хотите скрыть определенную рекламу на определенном сай
те и не хотите, чтобы это правило применялось на других сайтах. Например, правил
о <code>{1}</code> может скрыть полезный код на некоторых сайтах. Но если вы нап
ишете его как <code>{2}</code> оно будет применено на <code>{3}</code> и <code>{
4}</code> но не на <code>{5}</code>. Вы также можете определить множество домено
в - просто разделите их запятыми: <code>{6}</code>." |
| 221 }, |
| 222 "s9": { |
| 223 "message": "Иногда вы можете заметить, что один из ваших фильтров обычно раб
отающий нормально, блокирует то, что не должно быть блокировано. Вы не хотите уд
алять этот фильтр, но вы также не хотите, чтобы это продолжалось." |
| 224 }, |
| 225 "s90": { |
| 226 "description": "{1}: ~example.com##*.sponsor, {2}: example.com,~foo.example.
com##*.sponsor", |
| 227 "message": "Если доменному имени предшествует \"~\", правило <strong>не</str
ong> будет применяться на страницах этого домена (требуется Adblock Plus 1.1 и в
ыше). Например, <code>{1}</code> будет применяться на страницах с других доменов
, \"example.com\" и <code>{2}</code> делает правило применимым к домену \"exampl
e.com\" с исключением поддомена \"foo.example.com\"." |
| 228 }, |
| 229 "s91": { |
| 230 "description": "{1}: domain, {2}: domain.example,domain.test", |
| 231 "message": "<em>Примечание</em>: Из-за способа, который применяется при скры
тии элементов, вы можете использовать только полные доменные имена. Нельзя испол
ьзовать другие части адресов и нельзя использовать <code>{1}</code> как замену <
code>{2}</code>." |
| 232 }, |
| 233 "s92": { |
| 234 "description": "{1}: browser##menuitem#javascriptConsole", |
| 235 "message": "<em>Примечание</em>: Правила скрытия элементов с ограничением до
менов могут использоваться для скрытия элементов интерфейса браузера. Например,
правило <code>{1}</code> скроет пункт Консоль JavaScript в меню Инструменты брау
зера Firefox." |
| 236 }, |
| 237 "s93": { |
| 238 "message": "Селекторы атрибутов" |
| 239 }, |
| 240 "s94": { |
| 241 "description": "{1}: ##table[width=\"80%\"], {2}: ##div[title*=\"adv\"], {3}
: ##div[title^=\"adv\"][title$=\"ert\"], {4}: table[width=\"80%\"][bgcolor=\"whi
te\"]", |
| 242 "message": "С некоторыми рекламными вставками справиться не так просто - их
рекламный текст не имеет ни id, ни атрибута class. Вы можете использовать другие
атрибуты для их скрытия, например <code>{1}</code> будет скрывать таблицы атриб
ут width у которых установлен в 80%. Если вы не хотите определять полное значен
ие атрибута, <code>{2}</code> будет скрывать все элементы div с атрибутом заголо
вка, содержащим строку \"adv\". Вы также можете проверять начало и конец атрибут
а, например <code>{3}</code> будет скрывать элементы div начинающиеся с \"adv\"
и заканчивающиеся \"ert\". Как видите, вы также можете использовать множество с
остояний — <code>{4}</code> будет подходить для таблиц с атрибутом width установ
ленным в 80% и атрибутом bgcolor установленным в white." |
| 243 }, |
| 244 "s95": { |
| 245 "message": "Дополнительные селекторы" |
| 246 }, |
| 247 "s97": { |
| 248 "description": "{1}: ##div.adheader + *", |
| 249 "message": "В принципе любой CSS селектор моно работающий в Firefox можно ис
пользовать для скрытия. Например следующее правило скроет всё, что вложено в эле
мент DIV с классом «adheader»: <code>{1}</code>. Полный список CSS селекторов см
отрите в <a>спецификации CSS от W3C</a> (учтите: на данный момент Firefox поддер
живает ещё не все селекторы)." |
| 250 }, |
| 251 "s98": { |
| 252 "message": "<em>Примечание</em>: Эта функция для продвинутых пользователей,
необходимо свободное владение CSS селекторами, чтоб их корректно использовать. A
dblock Plus не способен проверить синтаксис добавляемого селектора и если исполь
зовать неправильный синтаксис, то можно сломать другие (корректные) фильтры. Про
веряйте консоль ошибок JavaScript на предмет сообщений об ошибках в CSS." |
| 253 }, |
| 254 "s99": { |
| 255 "message": "Исключения" |
| 256 }, |
| 257 "title": { |
| 258 "message": "Создание фильтров для Adblock Plus" |
| 259 } |
| 260 } |
OLD | NEW |