Release 2.17.
[PrivacyBrowser.git] / app / src / main / assets / en / guide_requests_light.html
1 <!--
2   Copyright © 2018 Soren Stoutner <soren@stoutner.com>.
3
4   This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
5
6   Privacy Browser is free software: you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation, either version 3 of the License, or
9   (at your option) any later version.
10
11   Privacy Browser is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>. -->
18
19 <html>
20     <head>
21         <meta charset="UTF-8">
22
23         <link rel="stylesheet" href="../css/light_theme.css">
24     </head>
25
26     <body>
27         <h3><img class="title" src="../shared_images/local_activity_blue_light.png"> Resource Requests</h3>
28
29         <p>When a URL is loaded, it typically makes a number of resource requests for CCS, JavaScript, image, and other files. Details about these requests can be viewed in the Requests activity.
30             The navigation drawer has a link to the Requests activity and also shows how many requests were blocked. Tapping on a request displays details about why it was allowed or blocked.</p>
31
32         <p><img class="center21" src="images/request_details.png"></p>
33
34         <p>Privacy Browser includes four <a href="https://easylist.to/">common blocklists</a> based on the <a href="https://adblockplus.org/filters">Adblock syntax</a>:
35             EasyList, EasyPrivacy, Fanboy’s Annoyance List, and Fanboy’s Social Blocking List.
36             These blocklists are processed by Privacy Browser into the following 22 sublists, which check resource requests in the order listed.</p>
37
38         <ol>
39             <li>Main Whitelist</li>
40             <li>Final Whitelist</li>
41             <li>Domain Whitelist</li>
42             <li>Domain Initial Whitelist</li>
43             <li>Domain Final Whitelist</li>
44             <li>Third-Party Whitelist</li>
45             <li>Third-Party Domain Whitelist</li>
46             <li>Third-Party Domain Initial Whitelist</li>
47             <li>Main Blacklist</li>
48             <li>Initial Blacklist</li>
49             <li>Final Blacklist</li>
50             <li>Domain Blacklist</li>
51             <li>Domain Initial Blacklist</li>
52             <li>Domain Final Blacklist</li>
53             <li>Domain Regular Expression Blacklist</li>
54             <li>Third-Party Blacklist</li>
55             <li>Third-Party Initial Blacklist</li>
56             <li>Third-Party Domain Blacklist</li>
57             <li>Third-Party Domain Initial Blacklist</li>
58             <li>Third-Party Regular Expression Blacklist</li>
59             <li>Third-Party Domain Regular Expression Blacklist</li>
60             <li>Regular Expression Blacklist</li>
61         </ol>
62
63         <p>Initial lists check against the beginning of the URL. Final lists check against the end of the URL. Domain lists only check against certain domains.
64             Third-party lists only apply if the root domain of the request is different than the root domain of the main URL.
65             Regular expression lists follow the <a href="https://en.wikipedia.org/wiki/Regular_expression">regular expression syntax</a>. Each sublist item has one or more entry.
66             In the case of domain sublists, the resource request is only checked against the item if the first entry matches the domain of the main URL.</p>
67
68         <p>Because of limitations in Android’s WebView, and to speed up processing of requests, Privacy Browser implements a simplified interpretation of the Adblock syntax.
69             This can sometimes lead to false positives, where resources are allowed or blocked in ways that weren’t intended by the original entry.
70             A more detailed description of how the blocklist entries are processed is available at <a href="https://www.stoutner.com/privacy-browser/blocklists/">stoutner.com</a>.</p>
71
72         <p>Privacy Browser has two additional blocklists,
73             one called <a href="https://www.stoutner.com/privacy-browser/blocklists/ultraprivacy/">UltraPrivacy</a> that blocks trackers that EasyPrivacy allows,
74             and the other that blocks all third-party requests.
75             A request is only considered third-party if the base domain of the request is different than the base domain of the URL.
76             For example, if <code>www.website.com</code> loads a picture from <code>images.website.com</code>,
77             this is not blocked as a third-party request because they both share the same base domain of <code>website.com</code>.
78             Blocking all third-party requests increases privacy, but this blocklist is disabled by default because it breaks a large number of websites.</p>
79     </body>
80 </html>