tazweb view doc/tazweb.en.html @ rev 145
Fix Makefile (install bookmarks.cgi to /var/www/cgi-bin not /usr/var...)
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sun Apr 06 16:58:50 2014 +0200 (2014-04-06) |
| parents | b499c4de5634 |
| children | f9c2b5aeacbd |
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 preferred
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>Kiosk mode</h3>
54 <p>
55 TazWeb provides a Kiosk mode useful for computers in public areas. The
56 Kiosk mode will start TazWeb in fullscreen. It will not allow users to
57 bookmark a page, download anything or open a URL in a new window.
58 </p>
59 <pre>
60 $ tazweb --kiosk
61 </pre>
63 <h3>Home Page and bookmarks</h3>
64 <p>
65 TazWeb handles a home page located in your system wide standard
66 configuration directory, the path is: /usr/share/webhome.
67 </p>
68 <p>
69 The bookmark.txt file is a simple text document with, by default, a
70 list of links. You can edit this file with you favorite editor
71 and add bookmark entries or use the Tazweb right click menu. At first
72 start TazWeb will create and copy your personal bookmarks file to
73 your config directory.
74 </p>
75 <p>
76 Bookmarks can be handled by TazWeb and you can easily add a bookmark to
77 your home page with the right click menu item: <i>"Add a bookmark"</i>.
78 Tazweb also lets you manage your bookmarks via a nifty CGI web interface.
79 </p>
80 <p>
81 Note: You will find the default bookmarks.txt in: /usr/share/tazweb or
82 you can get an original copy with the following command in a terminal:
83 </p>
84 <pre>
85 $ cp -f /usr/share/tazweb/bookmarks.html $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 don’t
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 © <span class="year"></span> TazWeb contributors
169 </div>
171 </body>
172 </html>