Rules are the primary component of a filter list. A rule is a line in a filter list that changes the way the user-agent handles third-party content.
Rules are matched against the URI of each third-party subdownload in a page. A URI that has a different second-level domain name than the URI in the address bar is a third-party URI.
4.4.1 Allow RulesAllow rules allow content from the specified entity to function within the instance of the user agent. Allow rules must begin with a plus sign (+
). Allow rules must be domain rules.
Domain rules allow or block content on a particular domain. Domain rules must begin with the string “+d
” (to allow content) or the string “–d
” (to block content). For allow rules, the user-agent must evaluate the string specified in the domain part of the allow rule against the target URI, starting from the topmost domain label. An additional and optional string match may be specified to further limit the scope.
For example, the following allow domain rules allow the URI, http://www.subdomain.example.com/file.html
.
+d example.com +d subdomain.example.com
The following allow domain rules, with the optional string, also allow the URI, http://www.subdomain.example.com/file.html
.
+d example.com file +d example.com file.html +d example.com html
The following allow domain rules fail to match and therefore fail to allow the URI, http://www.subdomain.example.com/file.html
.
+d subdomain.example # does not match starting at the topmost domain label # +d othersubdomain.example.com # not a complete match of specified domain labels # +d example.com /path/file.html # “/path/file.html” is not a substring of /file.html
For block rules, the user-agent must evaluate the string specified in the domain part of the block against any contiguous domain labels.
For example, the following block domain rules block the URI, http://www.subdomain.example.com/file.html
.
-d example.com -d subdomain.example.com
The following block domain rules, with the optional string, also block the URI, http://www.subdomain.example.com/file.html
.
-d example.com file -d example.com file.html -d example.com html -d subdomain.example
The following block domain rules fail to match and therefore fail to block the URI, http://www.subdomain.example.com/file.html
.
# -d othersubdomain.example.com # not contiguous domain labels # -d example.com /path/file.html # "/path/file.html" is not a substring of /file.html #4.4.4 Substring Rules
Substring rules match a substring in a URI, blocking content. For example, the following substring rules block the URI, http://www.example.com/test.html
.
- example - exam - test.html - ex*le
However, the following substring rule does not match and therefore does not block the URI, http://www.example.com/test.html
- test2
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3