tazweb annotate README @ rev 178

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