| 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
|
|
al@121
|
37 Generate translation files:
|
|
al@121
|
38
|
|
al@121
|
39 $ make msgfmt
|
|
al@121
|
40
|
|
al@121
|
41 Install with 'make install' (PREFIX and DESTDIR are supported for packaging).
|
|
al@121
|
42
|
|
pankso@0
|
43
|
|
pankso@44
|
44 Coding notes
|
|
pankso@44
|
45 ------------
|
|
pankso@81
|
46 * To get the filename of a WebKitDownload:
|
|
pankso@45
|
47 file = webkit_download_get_suggested_filename (download);
|
|
pankso@44
|
48
|
|
pankso@44
|
49 * Check mime-type before download (needs a callback function)
|
|
pankso@44
|
50 g_signal_connect (web_view, "mime-type-policy-decision-requested",
|
|
pankso@81
|
51 G_CALLBACK (mime_type_decision_cb), webview);
|
|
pankso@44
|
52
|
|
pankso@81
|
53 * Get user config directory path in $HOME:
|
|
pankso@71
|
54 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
|
|
pankso@71
|
55
|
|
pankso@81
|
56 * Change font of a widget:
|
|
pankso@81
|
57 PangoFontDescription *font;
|
|
pankso@81
|
58 font = pango_font_description_from_string("8");
|
|
pankso@81
|
59 gtk_widget_modify_font(urientry, font);
|
|
pankso@81
|
60 pango_font_description_free(font);
|
|
pankso@81
|
61
|
|
pankso@81
|
62 * Change size of a widget:
|
|
pankso@81
|
63 gtk_widget_set_size_request(toolbar, 0, 28);
|
|
pankso@81
|
64
|
|
pankso@81
|
65 * Append a string
|
|
pankso@81
|
66 g_string_append(string, " - TazWeb");
|
|
pankso@84
|
67
|
|
al@121
|
68 * Editable webview
|
|
al@121
|
69 webkit_web_view_set_editable (webview, TRUE);
|
|
al@121
|
70
|
|
al@121
|
71
|
|
al@121
|
72 i18n
|
|
al@121
|
73 ----
|
|
al@121
|
74 Internationalization of TazWeb was introduced since version 1.6.4.
|
|
al@121
|
75 It's standard GLib technique described in developer notes:
|
|
al@121
|
76 http://developer.gnome.org/glib/2.32/glib-I18N.html
|
|
al@121
|
77
|
|
al@121
|
78 Translation template (tazweb.pot) and all translations (xx.po) contained
|
|
al@121
|
79 in the po/ folder. To start a new translation use msginit from the
|
|
al@121
|
80 po/ directory. Example for French/France locale (fr_FR):
|
|
al@121
|
81
|
|
al@121
|
82 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
|
|
al@121
|
83
|
|
al@121
|
84 If you run msginit directly without any parameters, locale settings of your
|
|
al@121
|
85 system will be used.
|
|
al@121
|
86
|
|
al@121
|
87 To update pot file from a newly updated sources:
|
|
al@121
|
88
|
|
al@121
|
89 $ make pot
|
|
al@121
|
90
|
|
al@121
|
91 To update all translations from a newly updated pot file:
|
|
al@121
|
92
|
|
al@121
|
93 $ make msgmerge
|
|
al@121
|
94
|
|
al@121
|
95 To clear the distro from temporary compiled and generated files:
|
|
al@121
|
96
|
|
al@121
|
97 $ make clean
|
|
pankso@44
|
98
|
|
pankso@0
|
99 ================================================================================
|