README (1346B)
1 surf - simple webkit-based browser 2 ================================== 3 surf is a simple Web browser based on WebKit/GTK+. 4 5 Requirements 6 ------------ 7 In order to build surf you need GTK+ and Webkit/GTK+ header files. 8 9 In order to use the functionality of the url-bar, also install dmenu[0]. 10 11 Surf is running a "download" script when a file needs to be downloaded and a 12 "plumb" script when some URI needs to be opened, which is not beginning with 13 "about:", "http://" or "https://". Please create them in your $PATH prior to 14 using surf. 15 16 An example file for the User-Agent switching file is supplied in 17 "useragents.txt". You may need to adapt them to the current world situation. 18 19 Installation 20 ------------ 21 Edit config.mk to match your local setup (surf is installed into 22 the /usr/local namespace by default). 23 24 Afterwards enter the following command to build and install surf (if 25 necessary as root): 26 27 make clean install 28 29 Running surf 30 ------------ 31 run 32 surf [URI] 33 34 See the manpage for further options. 35 36 Running surf in tabbed 37 ---------------------- 38 For running surf in tabbed[1] there is a script included in the distribution, 39 which is run like this: 40 41 surf-open.sh [URI] 42 43 Further invocations of the script will run surf with the specified URI in this 44 instance of tabbed. 45 46 [0] http://tools.suckless.org/dmenu 47 [1] http://tools.suckless.org/tabbed 48