tazweb annotate README @ rev 121

Add i18n to src, Makefile & README; BSD license from Wikipedia; add comment to .desktop file; add Russian translation to .po and .desktop file
author Aleksej Bobylev <al.bobylev@gmail.com>
date Wed Feb 27 18:15:40 2013 +0000 (2013-02-27)
parents c32ca77dcded
children 0940993683ef
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 ================================================================================