summaryrefslogtreecommitdiff
path: root/INSTALL
blob: 8af421f33cf122323abbbed380033625abd1a7e3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
SimplyRead is written in JavaScript, and how to launch it varies a
little depending on browser.

# Firefox

SimplyRead is now packaged as an extension for firefox (and other
browsers of its kin.) You can either get it from the SimplyRead web
page, or build it (requires rsvg and librdf) by running:

	make xpi

# Chromium

SimplyRead also exists as an extension for chromium (and derived
browsers.) It isn't currently available on the "extensions gallery,"
but if someone wants to post it there, please go ahead. For now
you can get it from the SimplyRead web page, or build it (requires
rsvg) by running:

	make crx

# Surf

To use SimplyRead from surf, and trigger it from alt+r, add the
contents of keybind.js and simplyread.js to script.js:

	cat keybind.js simplyread.js >> $HOME/.surf/script.js

# Uzbl

To use this from uzbl, add the following line to the config file:

@cbind r = script file:///path/to/simplyread.js

You'll also have to add the statement 'simplyread();' to the bottom of
simplyread.js.

# Other browsers; 'bookmarklet'

To use this as a 'bookmarklet', create a new bookmark with an address of:

javascript:(function(){document.body.appendChild(document.createElement('script')).src='file:///path/to/simplyread.js';alert("SimplyRead");simplyread();})();

Note that due to browsers being afraid of mixing local and remote files
this may not work for http:// addresses. If this is the case, you can
either run the script from a remote location (eg your webserver), or
integrate it into a browser-specific extension.