tazweb view README @ rev 129

Add small Qt port :-)
author Christophe Lincoln <pankso@slitaz.org>
date Sat Jan 04 02:11:10 2014 +0100 (2014-01-04)
parents a8d926c59509
children 131267d07b58
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, an 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 little toy to play with!
48 $ cd src
49 $ qmake
50 $ make
53 Coding notes
54 ------------
55 * To get the filename of a WebKitDownload:
56 file = webkit_download_get_suggested_filename (download);
58 * Check mime-type before download (needs a callback function)
59 g_signal_connect (web_view, "mime-type-policy-decision-requested",
60 G_CALLBACK (mime_type_decision_cb), webview);
62 * Get user config directory path in $HOME:
63 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
65 * Change font of a widget:
66 PangoFontDescription *font;
67 font = pango_font_description_from_string("8");
68 gtk_widget_modify_font(urientry, font);
69 pango_font_description_free(font);
71 * Change size of a widget:
72 gtk_widget_set_size_request(toolbar, 0, 28);
74 * Append a string
75 g_string_append(string, " - TazWeb");
77 * Editable webview
78 webkit_web_view_set_editable (webview, TRUE);
81 i18n
82 ----
83 Internationalization of TazWeb was introduced since version 1.6.4.
84 It's standard GLib technique described in developer notes:
85 http://developer.gnome.org/glib/2.32/glib-I18N.html
87 Translation template (tazweb.pot) and all translations (xx.po) contained
88 in the po/ folder. To start a new translation use msginit from the
89 po/ directory. Example for French/France locale (fr_FR):
91 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
93 If you run msginit directly without any parameters, locale settings of your
94 system will be used.
96 To update pot file from a newly updated sources:
98 $ make pot
100 To update all translations from a newly updated pot file:
102 $ make msgmerge
104 To clear the distro from temporary compiled and generated files:
106 $ make clean
108 ================================================================================