Create a dark theme for `MainWebViewActivity`.
[PrivacyBrowser.git] / app / src / main / assets / en / guide_javascript.html
1 <!--
2   Copyright © 2016-2017 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         <!-- We have to make an image into its own block to center it. -->
24         <style>
25             h3 {
26                 color: 0D4781;
27             }
28
29             img.title {
30                 vertical-align: bottom;
31                 height: 32;
32                 width: 32;
33             }
34
35             img.center {
36                 display: block;
37                 margin-left: auto;
38                 margin-right: auto;
39                 height: 640;
40                 width: 360;
41             }
42         </style>
43     </head>
44
45     <body>
46         <h3><img class="title" src="images/privacy_browser.png"> JavaScript Is Powerful</h3>
47
48         <p>Back in the early days of the internet, web pages were static, meaning they they contained text and images that were displayed on the screen
49             but didn’t change or interact with the user. Of course, only so much that is interesting can happen with static content.
50             Several different technologies were developed to facilitate dynamic web pages. JavaScript is one of these technologies.</p>
51
52         <p>JavaScript is a programming language. Many web servers host programs written in JavaScript, which are sent to devices as part of the web page.
53             The device runs the JavaScript on its local processor and follows the commands of the program, which can animate images on the website,
54             popup a menu, and do many other useful things.</p>
55
56
57         <h3><img class="title" src="images/javascript_enabled.png"> JavaScript Is Dangerous</h3>
58
59         <p>Of course, the concept of running arbitrary programs from a website is potentially dangerous. So there are limitations placed on JavaScript
60             to keep it from doing things like installing viruses. However, it turns out that these limitations are overly broad.
61             Below is a screenshot from <a href="http://webkay.robinlinus.com">webkay</a>, which is a website that demonstrates the type of information that
62             JavaScript can produce about a device. <a href="http://www.browserleaks.com/">Browser Leaks</a> is another good resource.</p>
63
64         <p><img class="center" src="images/webkay.png"></p>
65
66         <p>For privacy purposes, the ideal would be to browse the internet with JavaScript disabled. However, there are some websites that legitimately require
67             JavaScript to accomplish their purposes and others that don’t work correctly without JavaScript even though they could be programmed to do so.
68             Privacy Browser addresses this by making it easy to toggle JavaScript on and off. Tapping the privacy shield will toggle it between blue
69             <img src="images/privacy_browser.png" height="16" width="16"> or yellow <img src="images/warning.png" height="16" width="16"> (both of which indicate
70             that JavaScript is disabled) and red <img src="images/javascript_enabled.png" height="16" width="16"> (JavaScript enabled).
71             Looking at the different information <a href="http://webkay.robinlinus.com">webkay</a> can collect with JavaScript enabled and disabled is informative.</p>
72
73         <p>Browsing the internet with JavaScript disabled, and only enabling it if needed, goes a long way to protecting user privacy. In addition, JavaScript
74             is used to load much of the annoying advertisements and extra cruft that comes along with most modern websites. With it disabled, websites will
75             load faster, consume less network traffic, and contain less annoying advertisements, instead of those that do things like cover up the text of the
76             entire web page.</p>
77     </body>
78 </html>