add jouz to authors file
[uzbl-mobile] / INSTALLING
1 Arch Linux
2 ----------
3 [Arch Linux](http://www.archlinux.org) is our distro of choice, and the distro we use for testing.
4
5 You can find a [PKGBUILD](http://aur.archlinux.org/packages.php?ID=25972) on the AUR, which installs the latest
6 from the master branch. You can edit the PKGBUILD to change to any other
7 branch you want.
8
9 From source
10 -----------
11         $ git clone git://github.com/Dieterbe/uzbl.git
12         [ $ git checkout master/experimental ] # master == fairly stable.  experimental is more bleeding edge
13         $ cd uzbl
14         $ make
15         $ sudo make install
16
17 Dependencies
18 ------------
19 * git (for building)
20 * pkgconfig (for Make/gcc)
21 * libwebkit 1.1.4 or higher
22 * gtk 2 something something
23
24 Optional/Recommended
25 --------------------
26 The following tools are quite useful, and some of them are used in the
27 sample scripts:
28
29 * dmenu
30 * zenity
31 * bash 
32
33 File locations
34 --------------
35 After installing - using either method - you will find:
36
37 * /usr/bin : uzbl [and uzblctrl]
38 * /usr/share/uzbl/docs/ : documentation files included with uzbl. (readme, checklist,..)
39 * /usr/share/uzbl/examples: sample scripts, config files and a sample bookmarks file. 
40
41 You will probably want to change the scripts to behave more like you want, so copy the scripts to your home dir. If you save your config as
42 $XDG\_CONFIG\_HOME/uzbl/config (this expands to ~/.config/uzbl/config on most systems) it will be recognized automatically. You can also pass the path to
43 the config file with the --config parameter.
44
45 You're free to store your personal stuff where you want, but we think the [XDG basedir spec](http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html)
46 is very useful for keeping a clean home directory, so we recommend:
47
48 * $XDG\_CONFIG\_HOME/uzbl/config* (~/.config/uzbl/config on most systems): config file
49 * $XDG\_DATA\_HOME/uzbl (~/.local/share/uzbl on most systems): bookmarks file, history file. and "scripts" directory with scripts