tazweb annotate README @ rev 154

Add .hgignore (skip tazweb binary)
author Christophe Lincoln <pankso@slitaz.org>
date Sat Apr 19 21:43:25 2014 +0200 (2014-04-19)
parents b499c4de5634
children 02eed5624373
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@131 6 window with one small bottom toolbar using buttons, a URL and search entry,
pankso@71 7 and a contextual menu but no menubar or tabs. Please keep the code simple
paul@131 8 and clean. If you are motivated and want to add some more functionality,
paul@144 9 please talk to the AUTHOR before committing 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 --------------------
paul@131 46 The Qt port is actually only a 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@141 55
pankso@81 56 * To get the filename of a WebKitDownload:
pankso@45 57 file = webkit_download_get_suggested_filename (download);
pankso@44 58
pankso@44 59 * Check mime-type before download (needs a callback function)
pankso@44 60 g_signal_connect (web_view, "mime-type-policy-decision-requested",
pankso@81 61 G_CALLBACK (mime_type_decision_cb), webview);
pankso@44 62
pankso@81 63 * Get user config directory path in $HOME:
pankso@71 64 config = g_strdup_printf ("%s/.config/tazweb", g_get_home_dir ());
pankso@71 65
pankso@81 66 * Change font of a widget:
pankso@81 67 PangoFontDescription *font;
pankso@81 68 font = pango_font_description_from_string("8");
pankso@81 69 gtk_widget_modify_font(urientry, font);
pankso@81 70 pango_font_description_free(font);
pankso@81 71
pankso@81 72 * Change size of a widget:
pankso@81 73 gtk_widget_set_size_request(toolbar, 0, 28);
pankso@81 74
pankso@81 75 * Append a string
pankso@81 76 g_string_append(string, " - TazWeb");
pankso@84 77
al@121 78 * Editable webview
al@121 79 webkit_web_view_set_editable (webview, TRUE);
al@121 80
al@121 81
al@121 82 i18n
al@121 83 ----
al@121 84 Internationalization of TazWeb was introduced since version 1.6.4.
paul@131 85 Its standard GLib technique is described in developer notes:
al@121 86 http://developer.gnome.org/glib/2.32/glib-I18N.html
al@121 87
al@121 88 Translation template (tazweb.pot) and all translations (xx.po) contained
al@121 89 in the po/ folder. To start a new translation use msginit from the
al@121 90 po/ directory. Example for French/France locale (fr_FR):
al@121 91
al@121 92 $ msginit -l fr_FR -o fr.po -i tazpanel.pot
al@121 93
al@121 94 If you run msginit directly without any parameters, locale settings of your
al@121 95 system will be used.
al@121 96
al@121 97 To update pot file from a newly updated sources:
al@121 98
al@121 99 $ make pot
al@121 100
al@121 101 To update all translations from a newly updated pot file:
al@121 102
al@121 103 $ make msgmerge
al@121 104
al@121 105 To clear the distro from temporary compiled and generated files:
al@121 106
al@121 107 $ make clean
pankso@44 108
pankso@0 109 ================================================================================