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><!-- end:bookmarks --></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">
|
pascal@120
|
168 Copyright (C) 2013 TazWeb contributors
|
pankso@3
|
169 </div>
|
pankso@3
|
170
|
pankso@3
|
171 </body>
|
pankso@3
|
172 </html>
|
pankso@3
|
173
|