tazweb annotate README @ rev 108

Added tag 1.5 for changeset 3d18e79e330d
author Christophe Lincoln <pankso@slitaz.org>
date Fri Mar 09 14:37:15 2012 +0100 (2012-03-09)
parents faa4ee68950b
children a8d926c59509
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
paul@72 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
paul@72 8 and clean, if you are motivated and want to add some more functionality,
paul@72 9 please 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
paul@72 26 BUG: Right clicking on "Open Link in New Window" is connecting to an 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@44 39 Coding notes
pankso@44 40 ------------
pankso@44 41
pankso@81 42 * To get the filename of a WebKitDownload:
pankso@45 43 file = webkit_download_get_suggested_filename (download);
pankso@44 44
pankso@44 45 * Check mime-type before download (needs a callback function)
pankso@44 46 g_signal_connect (web_view, "mime-type-policy-decision-requested",
pankso@81 47 G_CALLBACK (mime_type_decision_cb), webview);
pankso@44 48
pankso@81 49 * Get user config directory path in $HOME:
pankso@71 50 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
pankso@71 51
pankso@81 52 * Change font of a widget:
pankso@81 53 PangoFontDescription *font;
pankso@81 54 font = pango_font_description_from_string("8");
pankso@81 55 gtk_widget_modify_font(urientry, font);
pankso@81 56 pango_font_description_free(font);
pankso@81 57
pankso@81 58 * Change size of a widget:
pankso@81 59 gtk_widget_set_size_request(toolbar, 0, 28);
pankso@81 60
pankso@81 61 * Append a string
pankso@81 62 g_string_append(string, " - TazWeb");
pankso@84 63
pankso@84 64 * Editable webview
pankso@84 65 webkit_web_view_set_editable (webview, TRUE);
pankso@71 66
pankso@44 67
pankso@0 68 ================================================================================