GNU LibreJS 6.0.10.20151023: How to Use

From deaf2b1d1233f9ac8cb6e16240b3619870728732 Mon Sep 17 00:00:00 2001 From: Nik Nyby Date: Sat, 24 Oct 2015 23:09:24 -0400 Subject: remove manual output from source repo --- doc/manual/html_node/How-to-Use.html | 160 ----------------------------------- 1 file changed, 160 deletions(-) delete mode 100644 doc/manual/html_node/How-to-Use.html (limited to 'doc/manual/html_node/How-to-Use.html') diff --git a/doc/manual/html_node/How-to-Use.html b/doc/manual/html_node/How-to-Use.html deleted file mode 100644 index ebe42a1..0000000 --- a/doc/manual/html_node/How-to-Use.html +++ /dev/null @@ -1,160 +0,0 @@ - - - - - -GNU LibreJS 6.0.10.20151023: How to Use - - - - - - - - - - - - - - - - - - - - -

- -

4 How to Use

- - -

4.1 LibreJS in action

- -

After installing the add-on, you will see the LibreJS widget in the -add-on bar at the bottom of the browser window. After loading a page, -left-click on the widget to view the deactivated JavaScript code from -the page (both on page and external) and, if applicable, the scripts -that were accepted. -

- -

4.2 Complaint Feature

- -

It is very important to complain when a site has nonfree JavaScript -code, especially if it won’t work without that code. LibreJS makes it -easy to complain by heuristically finding where to send the complaint. -

When nonfree/nontrivial code is detected in a page, LibreJS attempts to -find a relevant contact link or email for the website you are -visiting. In order to do so, it will attempt to visit a few links from -the current page (for instance, a link labeled “contact” on the same -domain as the current page, …) -

LibreJS detects contact pages, email addresses that are likely to be -owned by the maintainer of the site, Twitter and identi.ca links, and -phone numbers. -

After LibreJS detects any of the above, a “Complain” tab will appear -on the right of your web browser. When you click on this tab, a large -panel will appear with contact information. Ideally, at the top you will -find the email address of the maintainer, labeled as the “Email you -should use”. -

When you complain to the website for their nonfree nontrivial -JavaScript, provide them with the link to the JavaScript Trap essay so -that they can get more information on what the issue is and how they can -solve it on their own site. -

LibreJS includes a default subject line and body for the complaint email, -with a link to the JavaScript Trap essay. This can be configured in the -LibreJS add-on preferences in your web browser. -

- - -

4.3 Options

- -

Whitelist: LibreJS lets you whitelist domain names and subdomains to bypass the -regular JavaScript check. This might be useful, for example, if you are -running your own code in a local web server. In order to add a -whitelisted domain or url, go to Tools >> Add-ons, or press Control -+ Shift + A. Inside the add-on window, click on Extensions, and in -the list, where you see LibreJS, click on the Preferences button. -You will see an input field labeled Whitelist. In the field, -enter comma-separated domain names. Do not enter the protocol. For -instance to whitelist all the pages of http://www.gnu.org and -https://gnu.org, enter ‘gnu.org’. To allow all subdomains from -gnu.org, enter: ‘*.gnu.org’. This will match such sites as -http://savannah.gnu.org and http://audio-video.gnu.org. -
-
Complaint tab: This specifies whether the complaint tab appears when a site is running -nonfree JavaScript. -
-
Display notifications of JavaScript analysis: This option enables an info bar of realtime JavaScript analysis. -
-
Complaint email subject: Configure the default subject used in complaint emails. -
-
Complaint email body: Configure the default body used in complaint emails. -

- -

- - - - - - -- cgit v1.2.3