tazweb view README @ rev 141

Add real bookmark support :-)
author Christophe Lincoln <pankso@slitaz.org>
date Sat Apr 05 18:51:42 2014 +0200 (2014-04-05)
parents 131267d07b58
children c2ec2ff2e813
line source
1 TazWeb - SliTaz Web Browser
2 ================================================================================
5 TazWeb is a radically simple and very light web browser providing a single
6 window with one small bottom toolbar using buttons, a URL and search entry,
7 and a contextual menu but no menubar or tabs. Please keep the code simple
8 and clean. If you are motivated and want to add some more functionality,
9 please talk to the AUTHOR before commiting anything in the repos.
11 TazWeb uses a custom page in the user Freedesktop directory to let users add
12 any content to it and get with one click from the toolbar. We may have
13 an external apps/script to handle that file for users who can't manage to
14 edit pure xHTML.
16 This application have been created for Tazpanel and future SliTaz integrated
17 Web applications. The goal is by far to have a fully-featured web browser. But
18 if you find a way to provide a simple plugins mechanism, that would be great.
20 The idea with TazWeb is to have a minimal interface, the approach is to
21 build all the GUI with xHTML and CSS like in TazPanel.
23 For general and end-user documentation have a look at doc/tazweb.html.
24 TazWeb is published, like webkit source under a free BSD license.
26 BUG: Right clicking on "Open Link in New Window" is connecting to an event
27 but doesn't work.
30 Build and install
31 -----------------
32 TazWeb depends on GTK and libwebkit. To build and test, simply:
34 $ make
35 $ ./tazweb
37 Generate translation files:
39 $ make msgfmt
41 Install with 'make install' (PREFIX and DESTDIR are supported for packaging).
44 Qt Build and install
45 --------------------
46 The Qt port is actually only a little toy to play with!
48 $ cd src
49 $ qmake
50 $ make
53 Coding notes
54 ------------
56 * To get the filename of a WebKitDownload:
57 file = webkit_download_get_suggested_filename (download);
59 * Check mime-type before download (needs a callback function)
60 g_signal_connect (web_view, "mime-type-policy-decision-requested",
61 G_CALLBACK (mime_type_decision_cb), webview);
63 * Get user config directory path in $HOME:
64 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
66 * Change font of a widget:
67 PangoFontDescription *font;
68 font = pango_font_description_from_string("8");
69 gtk_widget_modify_font(urientry, font);
70 pango_font_description_free(font);
72 * Change size of a widget:
73 gtk_widget_set_size_request(toolbar, 0, 28);
75 * Append a string
76 g_string_append(string, " - TazWeb");
78 * Editable webview
79 webkit_web_view_set_editable (webview, TRUE);
82 i18n
83 ----
84 Internationalization of TazWeb was introduced since version 1.6.4.
85 Its standard GLib technique is described in developer notes:
86 http://developer.gnome.org/glib/2.32/glib-I18N.html
88 Translation template (tazweb.pot) and all translations (xx.po) contained
89 in the po/ folder. To start a new translation use msginit from the
90 po/ directory. Example for French/France locale (fr_FR):
92 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
94 If you run msginit directly without any parameters, locale settings of your
95 system will be used.
97 To update pot file from a newly updated sources:
99 $ make pot
101 To update all translations from a newly updated pot file:
103 $ make msgmerge
105 To clear the distro from temporary compiled and generated files:
107 $ make clean
109 ================================================================================