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