tazweb annotate doc/tazweb.en.html @ rev 109

WebHome now localizable and translated to ru, doc also translated to ru, Makefile changed, tiny edit in docs on other langs
author Aleksej Bobylev <al.bobylev@gmail.com>
date Tue Mar 20 23:12:06 2012 +0200 (2012-03-20)
parents dc7215b94384
children c9e4365230ec
rev   line source
pankso@3 1 <!DOCTYPE html>
pankso@3 2 <html xmlns="http://www.w3.org/1999/xhtml">
pankso@3 3 <head>
pankso@3 4 <title>TazWeb Documentation</title>
pankso@3 5 <meta charset="utf-8" />
pankso@38 6 <link rel="stylesheet" type="text/css" href="style.css" />
pankso@3 7 </head>
pankso@3 8 <body>
pankso@3 9
pankso@3 10 <div id="header">
pankso@3 11 <h1>TazWeb Documentation</h1>
pankso@3 12 </div>
pankso@3 13
pankso@3 14 <!-- Start content -->
pankso@3 15 <div id="content">
pankso@3 16
pankso@3 17 <h2>SliTaz Web Browser</h2>
pankso@3 18
pankso@3 19 <p>
paul@42 20 TazWeb is a radically simple and very light web browser providing a
pankso@93 21 single window with a small toolbar and a contextual menu, but without
pankso@93 22 any menubar or tabs. Navigation is done with a right click anywhere in
paul@94 23 the browser window or from the toolbar. It can also handle bookmarks in a
paul@94 24 personal home page, provide a source view mode and zoom and printing
paul@94 25 functions. TazWeb lets you quickly search the web through a search
pankso@93 26 entry and Google. This documentation file is always accessible from the
paul@94 27 right-hand side of the toolbar.
pankso@3 28 </p>
pankso@3 29 <p>
paul@94 30 The browser fast, very fast and small, the binary is about 24 Kb and uses
paul@94 31 the Webkit engine for page rendering and therefore supports all the latest
paul@94 32 web standards as well as Javascript and Flash animations or videos.
pankso@93 33 </p>
pankso@93 34
pankso@93 35 <h3>History</h3>
pankso@93 36 <p>
paul@42 37 The SliTaz Web Browser was created for the needs of TazPanel which is
paul@31 38 the SliTaz administration and packages manager panel and made with
pankso@36 39 the latest technologies such as xHTML 5 and CSS 3 for the graphical
pankso@36 40 user interface. The content is powered by CGI scripts and the prefered
pankso@16 41 web server is Busybox httpd.
pankso@3 42 </p>
pankso@93 43
paul@94 44 <h3>Security and personal data</h3>
pankso@3 45 <p>
paul@94 46 TazWeb is a very secure browser and doesn't store any personal data, therefore
paul@94 47 no sessions, cookies or history files are created. So your websites settings
paul@94 48 will not be saved and you will have to enter login information each
paul@94 49 time you restart the browser (by the way websites can track you
paul@94 50 with cookies!).
pankso@3 51 </p>
pankso@3 52
pankso@93 53 <h3>My Home Page and bookmarks</h3>
pankso@36 54 <p>
paul@42 55 TazWeb handles a personal page located in your Freedesktop standard
pankso@78 56 configuration directory, the path is: $HOME/.config/tazweb/home.html.
paul@42 57 It lets you have a custom page with bookmarks and other content. The
paul@42 58 CSS style is defined in $HOME/.config/tazweb/style.css.
pankso@36 59 </p>
pankso@36 60 <p>
pankso@38 61 The file is a simple xHTML 5 document with, by default, a list of
pankso@38 62 links and a box. You can edit this file with you favorite editor
pankso@38 63 and add content such as bookmarks entries or change the look and
pankso@38 64 feel as you want. At first start TazWeb will create and copy your
paul@42 65 personal page and style to your config directory.
pankso@38 66 </p>
pankso@38 67 <p>
paul@42 68 To add some life to your pages you can use your own Javascript
paul@42 69 widgets or some from a third party website such as the famous
pankso@39 70 <a href="http://twitter.com/about/resources/widgets">
paul@42 71 Twitter Widget</a> as seen on the SliTaz main website.
pankso@39 72 </p>
pankso@39 73 <p>
pankso@93 74 Bookmarks can be handled by TazWeb and you can easily add a bookmark to
paul@94 75 your home page with the right click menu item: <i>"Add a bookmark"</i>. To function
paul@94 76 TazWeb uses markup in your home.html document; this markup should not
pankso@93 77 be removed if you want bookmarking to work since each new item will be
al@109 78 added just before the line: <i>&lt;!-- end:bookmarks --&gt;</i>
pankso@93 79 </p>
pankso@93 80 <p>
pankso@78 81 Note: You will find the default home.html in: /usr/share/tazweb and
pankso@39 82 can get an original copy with the following commands in a terminal:
pankso@36 83 </p>
pankso@36 84 <pre>
pankso@93 85 $ cp -r /usr/share/tazweb $HOME/.config/tazweb
pankso@36 86 </pre>
pankso@36 87
pankso@78 88 <h3>Start page and url in argument</h3>
pankso@3 89
pankso@3 90 <p>
paul@31 91 The default start page has been defined in the source code and can't be
pankso@93 92 changed and is the default SliTaz WebHome, but TazWeb accepts an URL as
pankso@93 93 a first argument, you can for example execute:
pankso@93 94 </p>
pankso@93 95 <pre>
pankso@93 96 $ tazweb <a href="http://www.slitaz.org/">http://www.slitaz.org/</a>
pankso@93 97 </pre>
pankso@93 98 <p>
pankso@93 99 In this way you can for example create your own and custom home page in
pankso@93 100 a pretty xHTML document and start tazweb with a standard desktop file or
pankso@93 101 from the command line: tazweb file://$HOME/.config/tazweb/home.html.
pankso@3 102 </p>
pankso@3 103 <p>
pankso@78 104 If you want a custom start page for your Live system or all system users,
pankso@3 105 you can create your own slitaz-configs package or edit the xHTML file
pankso@3 106 located in /usr/share/webhome/index.html. If you modify it, make sure
paul@31 107 to block slitaz-configs or make a backup because it will be overwritten
pankso@3 108 with a slitaz-configs package update.
pankso@3 109 </p>
pankso@93 110 <p>
paul@94 111 When you start TazWeb from the cmdline with an URL in the argument, you dont
paul@94 112 have to put http:// since TazWeb will transform URLs for you.
pankso@93 113 </p>
pankso@93 114
pankso@93 115 <h3>URL and search entry</h3>
pankso@93 116 <p>
paul@94 117 The URL entry in the toolbar lets you enter a website address and shows
pankso@93 118 the current website location. You can use selection, copy and paste in
paul@94 119 the URL entry and don't have to put http:// before a location, Tazweb
paul@94 120 will transform URLs for you. To activate a new URL you must press
pankso@93 121 ENTER.
pankso@93 122 </p>
pankso@93 123 <p>
paul@94 124 The search entry lets you search the web at anytime using Google. Just
paul@94 125 enter your query and press ENTER or click on the entry icon to validate
pankso@93 126 your request.
pankso@93 127 </p>
pankso@3 128
pankso@3 129 <h3>Web applications</h3>
pankso@3 130 <p>
pankso@3 131 TazWeb browser is perfect to launch web applications via a simple
pankso@3 132 desktop file. Once created with a simple text editor, the desktop
pankso@3 133 file can stand on the desktop with a nice icon or in the standard
pankso@36 134 SliTaz menu. Example of a web application launcher that you could
pankso@36 135 name scn.desktop:
pankso@3 136 </p>
pankso@3 137 <pre>
pankso@3 138 [Desktop Entry]
pankso@3 139 Type=Application
pankso@3 140 Name=SliTaz SCN
pankso@3 141 Icon=slitaz-menu
pankso@3 142 Exec=tazweb http://scn.slitaz.org/
pankso@3 143 </pre>
pankso@3 144
pankso@93 145 <h3>Bugs and development</h3>
pankso@93 146 <p>
paul@94 147 TazWeb is an open-source project under a BSD license and all resources are
pankso@93 148 provided by SliTaz GNU/Linux, we use a Mercurial repository for code
paul@94 149 management, discussion and support is done through the SliTaz community
paul@94 150 <a href="http://forum.slitaz.org/">forum</a>. If you're missing any features in
paul@94 151 TazWeb or find any bugs ? Please post an issue on our Roundup bug tracker
pankso@93 152 at: <a href="http://bugs.slitaz.org/">bugs.slitaz.org</a>
pankso@93 153 </p>
pankso@93 154 <p>
paul@94 155 If you want to help and get involved in development, you can start by cloning the
paul@94 156 TazWeb repository and then submit your patch, improved documentation or artwork
paul@94 157 to the SliTaz mailing list or on the <a href="http://scn.slitaz.org/">SCN</a>. To
paul@94 158 clone or browse the TazWeb Hg repository:
pankso@93 159 </p>
pankso@93 160 <pre>
pankso@93 161 $ hg clone <a href="http://hg.slitaz.org/tazweb">http://hg.slitaz.org/tazweb</a>
pankso@93 162 </pre>
pankso@93 163
pankso@3 164 <!-- End content -->
pankso@3 165 </div>
pankso@3 166
pankso@3 167 <div id="footer">
pankso@93 168 Copyright (C) 2011 TazWeb contributors
pankso@3 169 </div>
pankso@3 170
pankso@3 171 </body>
pankso@3 172 </html>
pankso@3 173