tazweb view README @ rev 125
Fix make install
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Wed Feb 27 20:07:58 2013 +0000 (2013-02-27) |
| parents | c32ca77dcded |
| children | 0940993683ef |
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 Coding notes
45 ------------
46 * To get the filename of a WebKitDownload:
47 file = webkit_download_get_suggested_filename (download);
49 * Check mime-type before download (needs a callback function)
50 g_signal_connect (web_view, "mime-type-policy-decision-requested",
51 G_CALLBACK (mime_type_decision_cb), webview);
53 * Get user config directory path in $HOME:
54 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
56 * Change font of a widget:
57 PangoFontDescription *font;
58 font = pango_font_description_from_string("8");
59 gtk_widget_modify_font(urientry, font);
60 pango_font_description_free(font);
62 * Change size of a widget:
63 gtk_widget_set_size_request(toolbar, 0, 28);
65 * Append a string
66 g_string_append(string, " - TazWeb");
68 * Editable webview
69 webkit_web_view_set_editable (webview, TRUE);
72 i18n
73 ----
74 Internationalization of TazWeb was introduced since version 1.6.4.
75 It's standard GLib technique described in developer notes:
76 http://developer.gnome.org/glib/2.32/glib-I18N.html
78 Translation template (tazweb.pot) and all translations (xx.po) contained
79 in the po/ folder. To start a new translation use msginit from the
80 po/ directory. Example for French/France locale (fr_FR):
82 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
84 If you run msginit directly without any parameters, locale settings of your
85 system will be used.
87 To update pot file from a newly updated sources:
89 $ make pot
91 To update all translations from a newly updated pot file:
93 $ make msgmerge
95 To clear the distro from temporary compiled and generated files:
97 $ make clean
99 ================================================================================