tazweb view README @ rev 179

Use helper as as SHell library
author Christophe Lincoln <pankso@slitaz.org>
date Mon Mar 13 01:51:59 2017 +0100 (2017-03-13)
parents c2ec2ff2e813
children dd3b94d5bca8
line source
1 TazWeb - SliTaz Web Browser
2 ================================================================================
3
4
5 TazWeb is a radically simple and very light web browser providing a single
6 window with one small toolbar using buttons, a URL and search entry,
7 and a contextual menu but no menubar. 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 committing anything in the repos.
10
11 This application have been created for Tazpanel and future SliTaz integrated
12 Web applications and it become a daily usable browser. The idea with TazWeb
13 is to have a minimal interface, the approach is to build all the GUI with
14 xHTML and CSS like in TazPanel or welkow web applications.
15
16 For general and end-user documentation have a look at doc/tazweb.html.
17 TazWeb is published, like webkit source under a free BSD license.
18
19
20 Build and install
21 -----------------
22 TazWeb depends on GTK and libwebkit. To build and test, simply:
23
24 $ make
25 $ ./tazweb
26
27 Generate translation files:
28
29 $ make msgfmt
30
31 Install with 'make install' (PREFIX and DESTDIR are supported for packaging).
32
33
34 Qt Build and install
35 --------------------
36 The Qt port is actually only a little toy to play with!
37
38 $ make qt
39 $ ./tazweb-qt
40
41
42 TazWeb helper script
43 --------------------
44 TazWeb use a set of SHell functions from /usr/lib/tazweb/helper.sh. These
45 functions are used to handle bookmarks and cookies. The GTK gui parts use
46 yad and some functions will generated html files to be used by tazweb menu
47 or buttons.
48
49
50 Coding notes
51 --------------------------------------------------------------------------------
52
53 * To get the filename of a WebKitDownload:
54 file = webkit_download_get_suggested_filename (download);
55
56 * Check mime-type before download (needs a callback function)
57 g_signal_connect (web_view, "mime-type-policy-decision-requested",
58 G_CALLBACK (mime_type_decision_cb), webview);
59
60 * Get user config directory path in $HOME:
61 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
62
63 * Change font of a widget:
64 PangoFontDescription *font;
65 font = pango_font_description_from_string("8");
66 gtk_widget_modify_font(urientry, font);
67 pango_font_description_free(font);
68
69 * Change size of a widget:
70 gtk_widget_set_size_request(toolbar, 0, 28);
71
72 * Append a string
73 g_string_append(string, " - TazWeb");
74
75 * Editable webview
76 webkit_web_view_set_editable (webview, TRUE);
77
78
79 Translation (i18n)
80 --------------------------------------------------------------------------------
81 Internationalization of TazWeb was introduced since version 1.6.4.
82 Its standard GLib technique is described in developer notes:
83 http://developer.gnome.org/glib/2.32/glib-I18N.html
84
85 Translation template (tazweb.pot) and all translations (xx.po) contained
86 in the po/ folder. To start a new translation use msginit from the
87 po/ directory. Example for French/France locale (fr_FR):
88
89 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
90
91 If you run msginit directly without any parameters, locale settings of your
92 system will be used.
93
94 To update pot file from a newly updated sources:
95
96 $ make pot
97
98 To update all translations from a newly updated pot file:
99
100 $ make msgmerge
101
102 To clear the distro from temporary compiled and generated files:
103
104 $ make clean
105
106 ================================================================================