tazweb view doc/tazweb.en.html @ rev 96

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