diff --git a/Wiki/SyntaxMeaningsThatAreActuallyHumanReadable.md b/Wiki/SyntaxMeaningsThatAreActuallyHumanReadable.md index b352b1f9b..4da26bbdd 100644 --- a/Wiki/SyntaxMeaningsThatAreActuallyHumanReadable.md +++ b/Wiki/SyntaxMeaningsThatAreActuallyHumanReadable.md @@ -1,7 +1,6 @@ ### All up-to-date significant adblockers¹ #### Element removal (a.k.a. cosmetic rules, a.k.a. hiding rules) - * `##.` / `##` / `###`: Hides parts of a page. * `#@#`: Whitelists parts of a page to make them load. * `[href="text"]`: Finds page elements whose values in the F12 filetree console contains such a value. The value can be `href`, `id`, `class`, `type`, or numerous other things. Does not support RegEx. @@ -19,44 +18,44 @@ * `+`: Blocks the element that is right below the criteria in the filetree. Example: `##.element + div` blocks that particular `div`. #### File blocking (a.k.a. blocking rules) - * `||`: Blocks resources from domains or parts thereof from being loaded. For non-domain-specific resources, no pre-emption is needed at all. * `@@`: Whitelists resources from specific URLs to make them load. * `^`: Usually ensures that the subdomains are also covered by the entry. * `$third-party`: Ensures that resources from a domain are only blocked if you're not visiting the domain itself. * `$~third-party`: Ensures that resources from a domain are only blocked if you're visiting the domain itself. * `$domain=`: Ensures that resources from a domain are only blocked if you're visiting a specified website. -* `$generichide`: Prevents all non-domain-specific hiding entries from working on a website. On Nano/uBO it prevents *all* generic entries from working. +* `$generichide`: Prevents all non-domain-specific (a.k.a. generic) hiding entries from working on a website. On Nano/uBO it prevents *all* non-domain-specific entries from working. * `$script`: Blocks resources from domains or parts thereof from being loaded, but only if it's a script, e.g. a JavaScript runtime. * `$csp`: Inserts additional *Content Security Policies* into the page. #### Universal - * `! ` / `# `: Marks the start of a comment that shall not be interpreted as an entry. * `~`: Means that an entry does *not* apply to a specific domain. * `/\/\/\/` and similar: Text detections in RegEx format. * `[Adblock Plus n.n]`: Used by Adblock Plus, AdBlock, and forks of them to determine if they should load the filterlist. Number is the intended minimum ABP version. `2.0` and `1.1` are most common; `3.1` and higher is on the rise and can be used to block support for old or low-quality forks. This has no effect on uBO or its forks. ### Nano Adblocker, uBlock Origin and AdGuard only: - +#### Hiding * `:style`: Changes the CSS values of an element, in much the same way as what userstyle extensions like Stylish would've done. * `{ }`: Same as above. -* `$badfilter`: Deactivates a resource-blocking entry, even if it is present in another list. * `:has-text`: Same as `:-abp-contains`. * `:has`: Same as `:-abp-has`. * `!#if`: Specifies that a section of entries only applies to specific platforms or extensions. Closed out by `!#endif`. * `:matches-css`: Looks for page elements whose existing native (i.e. non-inherited) CSS values match those of the criteria. * `:matches-css-before`: Same as above, but looks for CSS values in its pseudo-elements instead. +#### Blocking +* `$badfilter`: Deactivates a resource-blocking entry, even if it is present in another list. +* `$important`: Makes a resource-blocking entry take precedence over another whitelisting entry. ### Nano Adblocker and uBlock Origin only: - +#### Hiding * `!#include`: Embeds another filterlist that is hosted on the same domain (with numerous restrictions). * `##+js` (prev. `##script:inject`): Invokes a script that is embedded in those extensions, and usually using the script to modify a value on the site. * `:xpath`: An entry written with the very advanced Xpath syntax. -* `$important`: Makes a resource-blocking entry take precedence over another whitelisting entry. -* `127.0.0.1` / `0.0.0.0` / `::1`: Used by "*hosts*" system files to signify that network requests to such a domain shall be redirected to a local-only IP address, thus preventing it from loading. Nano and uBO treats it the same as `||`. * `##^`: Blocks resources before they've even been loaded, based on their values in *View source* instead of their F12 ones. -* `||` + `$document`: Guarantees a danger warning when loading a page (unless a specific setting is changed), which is not 110% guaranteed otherwise. +#### Blocking +* `127.0.0.1` / `0.0.0.0` / `::1`: Used by "*hosts*" system files to signify that network requests to such a domain shall be redirected to a local-only IP address, thus preventing it from loading. Nano and uBO treats it the same as `||`. +* `||` + `$document`: Guarantees a danger warning when loading a page, which is not 110% guaranteed otherwise. * `$redirect`: Redirects resources to a neutered version that has been embedded in those extensions. * `$3p`: Same as `$third-party`. * `$first-party` / `$1p`: Same as `$~third-party`. @@ -68,9 +67,9 @@ ### Adblock Plus and AdBlock only: * `! Redirect: `: Tells the adblocker to look for list updates from a new URL from that point on. +* `#?#`: Required to make entries with `:-abp-has`, `:-abp-contains` and `:-abp-properties` work in those particular extensions. * `@@||` + `$document`: Turns off adblocking entirely while on that domain. * `$genericblock`: Prevents all non-domain-specific blocking entries from working on a website. -* `#?#`: Required to make entries with `:-abp-has`, `:-abp-contains` and `:-abp-properties` work in those particular extensions. ### AdGuard only: @@ -79,7 +78,7 @@ ### AdGuard for [Windows/Mac/Android] only: -* `! Description: `: Shows a description of the list's purpose, when the question mark next to the list in the AdGuard settings is hovered over. That being said, a description is convenient for users of all adblockers, if they're willing to look up a list's raw content. +* `! Description:`: Shows a description of the list's purpose, when the question mark next to the list in the AdGuard settings is hovered over. That being said, a description is convenient for users of all adblockers, if they're willing to look up a list's raw content. * `$network`: When applied to an IP address, it blocks all incoming requests from it, and not just when it's typed into a browser address bar. #### I honestly don't know what these ones do: