tazweb annotate README @ rev 71

Update README
author Christophe Lincoln <pankso@slitaz.org>
date Sat Apr 23 13:42:53 2011 +0200 (2011-04-23)
parents 8961264a6475
children 5bc3369a201f
rev   line source
pankso@0 1 TazWeb - SliTaz Web Browser
pankso@0 2 ================================================================================
pankso@0 3
pankso@0 4
paul@42 5 TazWeb is a radically simple and very light web browser providing a single
pankso@71 6 window with one small bottom toolbar using buttons, an URL and search entry
pankso@71 7 and a contextual menu but no menubar or tabs. Please keep the code simple
pankso@71 8 and clean, if you are motivated and want to add some functionnalities, please
pankso@71 9 talk to the AUTHOR before commiting anything in the repos.
pankso@0 10
paul@42 11 TazWeb uses a custom page in the user Freedesktop directory to let users add
paul@42 12 any content to it and get with one click from the toolbar. We may have
paul@42 13 an external apps/script to handle that file for users who can't manage to
pankso@38 14 edit pure xHTML.
pankso@38 15
paul@31 16 This application have been created for Tazpanel and future SliTaz integrated
paul@31 17 Web applications. The goal is by far to have a fully-featured web browser. But
paul@31 18 if you find a way to provide a simple plugins mechanism, that would be great.
pankso@0 19
paul@31 20 The idea with TazWeb is to have a minimal interface, the approach is to
pankso@15 21 build all the GUI with xHTML and CSS like in TazPanel.
pankso@0 22
pankso@0 23 For general and end-user documentation have a look at doc/tazweb.html.
paul@31 24 TazWeb is published, like webkit source under a free BSD license.
pankso@0 25
pankso@71 26 BUG: Right clicking on "Open Link in New Window" is connect to a event
pankso@71 27 but doesn't work.
pankso@0 28
pankso@0 29
pankso@0 30 Build and install
pankso@0 31 -----------------
pankso@0 32 TazWeb depends on GTK and libwebkit. To build and test, simply:
pankso@0 33
pankso@0 34 $ make
pankso@0 35 $ ./tazweb
pankso@0 36
pankso@0 37 Install with 'make install' (PREFIX and DESTDIR are supported for packaging)
pankso@0 38
pankso@0 39
pankso@44 40 Coding notes
pankso@44 41 ------------
pankso@44 42
pankso@44 43 * To get the filename of a WebKitDownload
pankso@45 44 file = webkit_download_get_suggested_filename (download);
pankso@44 45
pankso@44 46 * Check mime-type before download (needs a callback function)
pankso@44 47 g_signal_connect (web_view, "mime-type-policy-decision-requested",
pankso@44 48 G_CALLBACK (mime_type_decision_cb), web_view);
pankso@44 49
pankso@45 50 * Get user config directory path in $HOME
pankso@71 51 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
pankso@71 52
pankso@71 53 * This code change the browser user-agent
pankso@71 54 static gchar *useragent = "TazWeb/1.0 (X11; Linux; U; en_US) AppleWebKit/531.2+";
pankso@71 55
pankso@71 56 /* User agent */
pankso@71 57 WebKitWebSettings *settings;
pankso@71 58 settings = webkit_web_view_get_settings (web_view);
pankso@71 59 g_object_set (G_OBJECT (settings), "user-agent", useragent, NULL);
pankso@45 60
pankso@44 61
pankso@0 62 ================================================================================