diff --git a/Hosts-Blocklists.md b/Hosts-Blocklists.md index 1379410..40af232 100644 --- a/Hosts-Blocklists.md +++ b/Hosts-Blocklists.md @@ -17,6 +17,8 @@ * [Domains-Only Syntax](#domains-only) * [Hostlists Compiler](#hostlists-compiler) + + ## Introduction There are three different approaches to writing hosts blocklists: @@ -110,6 +112,8 @@ modifiers = [modifier0, modifier1[, ...[, modifierN]]] * `modifiers`: parameters that clarify the rule. They may limit the scope of the rule or even completely change the way it works. + + ### Special Characters * `*`: the wildcard character. It is used to represent any set of characters. @@ -128,6 +132,8 @@ modifiers = [modifier0, modifier1[, ...[, modifierN]]] `ample.org|` corresponds to `example.org` but not to `example.org.com`. `|example` corresponds to `example.org` but not to `test.example`. + + ### Regular Expressions If you want even more flexibility in making rules, you can use [regular @@ -138,33 +144,37 @@ want to use a regular expression, the pattern has to look like this: pattern = "/" regexp "/" ``` -**Examples:** +Examples: * `/example.*/` will block hosts matching the `example.*` regexp. * `@@/example.*/$important` will unblock hosts matching the `example.*` regexp. Note that this rule also implies the `important` modifier. + + ### Comments Any line that starts with an exclamation mark or a hash sign is a comment and it will be ignored by the filtering engine. Comments are usually placed above rules and used to describe what a rule does. -**Example:** +Example: ```none ! This is a comment. # This is also a comment. ``` + + ### Rule Modifiers You can change the behavior of a rule by adding modifiers. Modifiers must be located at the end of the rule after the `$` character and be separated by commas. -**Examples:** +Examples: * ```none ||example.org^$important @@ -228,7 +238,7 @@ supported. Use the backslash (`\`) to escape quotes (`"` and `'`), commas **NOTE:** When excluding a client, you **must** keep `~` out of the quotes. -**Examples:** +Examples: * `@@||*^$client=127.0.0.1`: unblock everything for localhost. @@ -282,7 +292,7 @@ how to solve this with `denyallow`: *$denyallow=com|net ``` -**Examples:** +Examples: * `*$denyallow=com|net`: block everything save for `*.com` and `*.net`. @@ -320,7 +330,7 @@ is equivalent to this: $dnstype=value2 ``` -**Examples:** +Examples: * `||example.org^$dnstype=AAAA`: block DNS queries for the IPv6 addresses of `example.org`. @@ -414,7 +424,7 @@ Name: example.net Address: 1.2.3.4 ``` -Next, the `CNAME` rewrite. After that, all other records's values are summed as +Next, the `CNAME` rewrite. After that, all other records' values are summed as one response, so this: ```none @@ -490,7 +500,7 @@ Exception rules remove one or all rules: The `important` modifier applied to a rule increases its priority over any other rule without the modifier. Even over basic exception rules. -**Examples:** +Examples: * In this example: @@ -517,7 +527,7 @@ The rules with the `badfilter` modifier disable other basic rules to which they refer. It means that the text of the disabled rule should match the text of the `badfilter` rule (without the `badfilter` modifier). -**Examples:** +Examples: * `||example.com$badfilter` disables `||example.com`. @@ -550,7 +560,7 @@ $ctag=~value1|~value2|... If one of client's tags matches the exclusion `ctag` values, this rule doesn't apply to the client. -**Examples:** +Examples: * `||example.org^$ctag=device_pc|device_phone`: block `example.org` for clients tagged as `device_pc` or `device_phone`. @@ -591,7 +601,7 @@ The list of allowed tags: * `user_child`: children. [adb]: https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters -[regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions +[regexp]: https://github.com/google/re2/wiki/Syntax [rfc1035]: https://tools.ietf.org/html/rfc1035#section-3.5 @@ -613,7 +623,7 @@ and periods (`.`). They must begin with an alphabetic character and end with an alphanumeric character. Optional aliases provide for name changes, alternate spellings, shorter hostnames, or generic hostnames (for example, `localhost`). -**Example:** +Example: ```none # This is a comment