| rev |
line source |
|
paul@134
|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
paul@134
|
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
paul@134
|
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
paul@134
|
4 <head>
|
|
paul@134
|
5 <title>SliTaz Handbook (en) - Desktop</title>
|
|
paul@134
|
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
|
|
paul@134
|
7 <meta name="description" content="slitaz English handbook" />
|
|
paul@134
|
8 <meta name="expires" content="never" />
|
|
paul@134
|
9 <meta name="modified" content="2008-02-26 18:30:00" />
|
|
paul@134
|
10 <meta name="publisher" content="www.slitaz.org" />
|
|
paul@134
|
11 <meta name="author" content="Christophe Lincoln, Paul Issott"/>
|
|
paul@134
|
12 <link rel="shortcut icon" href="favicon.ico" />
|
|
paul@134
|
13 <link rel="stylesheet" type="text/css" href="book.css" />
|
|
paul@134
|
14 </head>
|
|
paul@134
|
15 <body bgcolor="#ffffff">
|
|
paul@134
|
16
|
|
paul@134
|
17 <!-- Header and quick navigation -->
|
|
paul@134
|
18 <div id="header">
|
|
paul@134
|
19 <div align="right" id="quicknav">
|
|
paul@134
|
20 <a name="top"></a>
|
|
paul@135
|
21 <a href="enlightenment.html">Enlightenment</a> |
|
|
paul@134
|
22 <a href="index.html">Table of contents</a>
|
|
paul@134
|
23 </div>
|
|
paul@134
|
24 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
|
|
paul@134
|
25 </div>
|
|
paul@134
|
26
|
|
paul@134
|
27 <!-- Content. -->
|
|
paul@134
|
28 <div id="content">
|
|
paul@134
|
29 <div class="content-right"></div>
|
|
paul@134
|
30
|
|
paul@134
|
31 <h2><font color="#DF8F06">SliTaz Desktop</font></h2>
|
|
paul@134
|
32
|
|
paul@134
|
33 <ul>
|
|
paul@134
|
34 <li><a href="#intro">Introduction.</a></li>
|
|
paul@134
|
35 <li><a href="#jwm">JWM.</a></li>
|
|
paul@134
|
36 <li><a href="#lxpanel">LxPanel.</a></li>
|
|
paul@134
|
37 <li><a href="x-window.html#openbox">Openbox.</a></li>
|
|
paul@135
|
38 <li><a href="enlightenment.html">Enlightenment.</a></li>
|
|
paul@134
|
39 </ul>
|
|
paul@134
|
40
|
|
paul@134
|
41 <a name="intro"></a>
|
|
paul@134
|
42 <h3>Introduction</h3>
|
|
paul@134
|
43 <p>
|
|
paul@134
|
44 The default SliTaz desktop is brought to you by many different components.
|
|
paul@134
|
45 JWM (Joe's Window Manager) and LXPanel combine to provide a Desktop providing
|
|
paul@134
|
46 simplicity and functionality.
|
|
paul@134
|
47 </p>
|
|
paul@134
|
48
|
|
paul@134
|
49 <a name="jwm"></a>
|
|
paul@134
|
50 <h3>JWM - Joe's Window Manager</h3>
|
|
paul@134
|
51 <p>
|
|
paul@134
|
52 Joe's window manager, written in C is quick, simple, clean, stable and efficient.
|
|
paul@134
|
53 JWM proposes a taskbar, a menu of icons and a
|
|
paul@134
|
54 pager for the management of virtual desktops, the taskbar can also act as a dock.
|
|
paul@134
|
55 In addition it is easily configurable with a single text file that can
|
|
paul@134
|
56 change the menu, fonts and their sizes and different colors.
|
|
paul@134
|
57 </p>
|
|
paul@134
|
58
|
|
paul@134
|
59 <h4>Use and configure JWM</h4>
|
|
paul@134
|
60 <p>
|
|
paul@134
|
61 The application of Joe's Window Manager is very fast. To view the menu just
|
|
paul@134
|
62 click somewhere on the desktop. You can resize a window through the edges or
|
|
paul@134
|
63 corners, minimize or pass a virtual desktop to another via a pager. You
|
|
paul@134
|
64 also have configurable keyboard shortcuts for faster access to the applications
|
|
paul@134
|
65 that you use the most. On SliTaz the system configuration file is
|
|
paul@134
|
66 <code>/etc/jwm/system.jwmrc</code>. Apart from this file, each user can use
|
|
paul@134
|
67 its own configuration file hidden in <code>~/.jwmrc</code>. This is a text file using XML
|
|
paul@134
|
68 syntax, it can edited with a simple text editor - lines beginning with:
|
|
paul@134
|
69 <code><!--</code> are comments that let you understand what each tag does.
|
|
paul@134
|
70 </p>
|
|
paul@134
|
71 <p>
|
|
paul@134
|
72 To facilitate the customization of the desktop, SliTaz automatically copies
|
|
paul@134
|
73 at the launch of the first (graphical) session, a system configuration file to
|
|
paul@134
|
74 the root directory of the user. You can directly modify this file and test
|
|
paul@134
|
75 without risk. To edit with your favorite text editor:
|
|
paul@134
|
76 </p>
|
|
paul@134
|
77 <pre>
|
|
paul@134
|
78 $ geany $HOME/.jwmrc &
|
|
paul@134
|
79 </pre>
|
|
paul@134
|
80 <p>
|
|
paul@134
|
81 To retrieve an original configuration file, you can copy the system configuration
|
|
paul@134
|
82 file and rename it <code>.jwmrc</code> in your home directory:
|
|
paul@134
|
83 </p>
|
|
paul@134
|
84 <pre>
|
|
paul@134
|
85 $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc
|
|
paul@134
|
86 </pre>
|
|
paul@134
|
87 <p>
|
|
paul@134
|
88 The tag <code>RootMenu</code> corresponds to the menu displayed by clicking on one of the
|
|
paul@134
|
89 (three) buttons on the mouse. To add a category, you must use the tag: <code>Menu</code>
|
|
paul@134
|
90 - this contains entries for various programs. Any entry in the JWM menu can
|
|
paul@134
|
91 fit on one line. Example using the GQview image management application:
|
|
paul@134
|
92 </p>
|
|
paul@134
|
93 <pre class="script">
|
|
paul@134
|
94 <Program icon="gqview.png" label="GQview">gqview</Program>
|
|
paul@134
|
95 </pre>
|
|
paul@134
|
96 <p>
|
|
paul@134
|
97 There are still many opportunities to configure <code>RootMenu</code> according to the
|
|
paul@134
|
98 mouse buttons, the choice of method to move windows, create groups, etc.
|
|
paul@134
|
99 The Manual is available online at the official website of the project. To view
|
|
paul@134
|
100 a list of command-line options, just type <code>jwm -h</code> in a terminal.
|
|
paul@134
|
101 </p>
|
|
paul@134
|
102
|
|
paul@134
|
103 <h4>Create your own JWM style</h4>
|
|
paul@134
|
104 <p>
|
|
paul@134
|
105 Creating your own graphical style with JWM is relatively quick
|
|
paul@134
|
106 and easy, the tags are clear and the attributes possible
|
|
paul@134
|
107 are given in the comments. When preparing your work, you can
|
|
paul@134
|
108 see your amendments by restarting the window manager from the
|
|
paul@134
|
109 menu or via the <code>jwm -restart</code> command. In the configuration
|
|
paul@134
|
110 file, style tags start after the <!-- Visual Styles --> comment. To
|
|
paul@134
|
111 begin, here is a short list of the main style tags with a short
|
|
paul@134
|
112 description:
|
|
paul@134
|
113 </p>
|
|
paul@134
|
114 <ul>
|
|
paul@134
|
115 <li><code>Background</code> manages the wallpaper. This tag supports the
|
|
paul@134
|
116 <code>solid</code>, <code>gradient</code>, <code>image</code> or <code>tile</code>
|
|
paul@134
|
117 attributes, to respectively; use a solid color, create a gradient,
|
|
paul@134
|
118 display a resized image or tile an image.</li>
|
|
paul@134
|
119
|
|
paul@134
|
120 <li><code>BorderStyle</code> controls the windows border.</li>
|
|
paul@134
|
121
|
|
paul@134
|
122 <li><code>TrayStyle</code> controls a taskbar. The taskbar may, among other
|
|
paul@134
|
123 things be automatically hidden or only fill a part of the
|
|
paul@134
|
124 screen with the <code>width</code> attribute.</li>
|
|
paul@134
|
125
|
|
paul@134
|
126 <li><code>TrayListStyle</code> controls the style of the list of open windows
|
|
paul@134
|
127 on the current desktop.</li>
|
|
paul@134
|
128
|
|
paul@134
|
129 <li><code>PagerStyle</code> controls the pager displaying different virtual
|
|
paul@134
|
130 desktops (4 by default).</li>
|
|
paul@134
|
131
|
|
paul@134
|
132 <li><code>MenuStyle</code> defines the menu style.</li>
|
|
paul@134
|
133
|
|
paul@134
|
134 <li>The icons are defined by the <code>IconPath</code> tag, you can use your
|
|
paul@134
|
135 own personal icons by specifing the full path to the directory
|
|
paul@134
|
136 that contains them. Note that you can specify more than
|
|
paul@134
|
137 one path, if you want, you can use your own icons <em>and</em> those
|
|
paul@134
|
138 contained in the <code>/usr/share/pixmaps</code> and <code>/usr/share/icons</code>
|
|
paul@134
|
139 system directories. SliTaz uses the Tango theme icons:
|
|
paul@134
|
140 <a href="http://tango.freedesktop.org/">tango.freedesktop.org</a>
|
|
paul@134
|
141 for the menu, they are 16x16 and are stored in
|
|
paul@134
|
142 <code>/usr/share/icons/Tango</code>. You can add, edit, delete
|
|
paul@134
|
143 these... If you want to install new icons in your user
|
|
paul@134
|
144 space, we advise you to use <code>~/Picture/Icons</code> (set as default)
|
|
paul@134
|
145 or a hidden directory <code>~/.Icons</code>.</li>
|
|
paul@134
|
146 </ul>
|
|
paul@134
|
147 <p>
|
|
paul@134
|
148 The colors can be defined by their name or RGB number, such
|
|
paul@134
|
149 as <code>#3A4956</code>. To use colors in their gradient mode, you must
|
|
paul@134
|
150 specify the two colors separated by a colon, example
|
|
paul@134
|
151 <code>#6C0023:#3E1220</code>. You can change fonts and their sizes by
|
|
paul@134
|
152 using the <code>Font</code> tag. There are still some small things that
|
|
paul@134
|
153 you can change to customize your desktop, such as the name
|
|
paul@134
|
154 of a menu item and its icon. Before restarting JWM with your
|
|
paul@134
|
155 new configuration file, you can check its syntax by using
|
|
paul@134
|
156 the command: <code>jwm -p</code>. To explore further, the official
|
|
paul@134
|
157 handbook describes all the tags, options and valid attributes.
|
|
paul@134
|
158 You can view it online at the JWM website.
|
|
paul@134
|
159 </p>
|
|
paul@134
|
160
|
|
paul@134
|
161 <h4>JWM website</h4>
|
|
paul@134
|
162 <ul>
|
|
paul@134
|
163 <li><a href="http://www.joewing.net/programs/jwm/"
|
|
paul@134
|
164 >www.joewing.net/programs/jwm/</a> - The official website of
|
|
paul@134
|
165 Joe's Window Manager, providing news and a comprehensive manual.</li>
|
|
paul@134
|
166 <li>#jwm on irc.freenode.net - The JWM IRC discussion channel on
|
|
paul@134
|
167 Freenode server.</li>
|
|
paul@134
|
168 </ul>
|
|
paul@134
|
169
|
|
paul@134
|
170 <a name="lxpanel"></a>
|
|
paul@134
|
171 <h3>LXPanel</h3>
|
|
paul@134
|
172 <p>
|
|
paul@134
|
173 LXPanel is part of the LXDE project and follows the Freedesktop standards. Menus
|
|
paul@134
|
174 are dynamically generated by adding <code>.desktop</code> files to the
|
|
paul@134
|
175 <code>/usr/share/applications</code> directory.
|
|
paul@134
|
176 </p>
|
|
paul@134
|
177 <h4>*.desktop files</h4>
|
|
paul@134
|
178 <p>
|
|
paul@134
|
179 A single .desktop file
|
|
paul@134
|
180 can contain eight lines with respectively:-
|
|
paul@134
|
181 the name (<code>Name</code>), generic name, comment, the command to
|
|
paul@134
|
182 execute (<code>Exec</code>), icon, type and Freedesktop categories.
|
|
paul@134
|
183 Example of a .desktop file:
|
|
paul@134
|
184 </p>
|
|
paul@134
|
185 <pre class="script">[Desktop Entry]
|
|
paul@134
|
186 Name=XTerm
|
|
paul@134
|
187 GenericName=Terminal
|
|
paul@134
|
188 Comment=Run commands in a shell
|
|
paul@134
|
189 Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar
|
|
paul@134
|
190 Icon=xterm.png
|
|
paul@134
|
191 Type=Application
|
|
paul@134
|
192 Categories=Utility;Terminal;
|
|
paul@134
|
193 </pre>
|
|
paul@134
|
194 <p>
|
|
paul@134
|
195 Note that the icons are located in <code>/usr/share/icons</code> or
|
|
paul@134
|
196 <code>/usr/share/pixmaps</code> directory. The <code>Categories</code>
|
|
paul@134
|
197 entry states where the program will sit in the menu.
|
|
paul@134
|
198 </p>
|
|
paul@134
|
199 <p>
|
|
paul@134
|
200 The system configuration file is located in <code>/etc/lxpanel</code>
|
|
paul@134
|
201 and can also be stored locally in <code>~/.config</code> though it is
|
|
paul@134
|
202 recommended that you configure LXPanel graphically by using the
|
|
paul@134
|
203 preferences entry in the main menu.
|
|
paul@134
|
204 </p>
|
|
paul@134
|
205
|
|
paul@134
|
206 <h4>LXPanel configurator</h4>
|
|
paul@134
|
207 <p>
|
|
paul@134
|
208 The LXPanel configurator has 3 tabs:-
|
|
paul@134
|
209 </p>
|
|
paul@134
|
210 <ul>
|
|
paul@134
|
211 <li><code>General</code> handles the position, size - either dynamic
|
|
paul@134
|
212 or fixed, panel background and properties.</li>
|
|
paul@134
|
213 <li><code>Plugins</code> lets you add, remove, edit and move plugins
|
|
paul@134
|
214 around on the panel.</li>
|
|
paul@134
|
215 <li><code>Applications</code> allows you to set preferred applications
|
|
paul@134
|
216 like the file manager, terminal and logout command.</li>
|
|
paul@134
|
217 </ul>
|
|
paul@134
|
218 <p>
|
|
paul@134
|
219 The official website for the LXDE project and LXPanel can be found
|
|
paul@134
|
220 <a href="http://lxde.org/">here</a>.
|
|
paul@134
|
221 </p>
|
|
paul@134
|
222
|
|
paul@134
|
223 <!-- End of content -->
|
|
paul@134
|
224 </div>
|
|
paul@134
|
225
|
|
paul@134
|
226 <!-- Footer. -->
|
|
paul@134
|
227 <div id="footer">
|
|
paul@134
|
228 <div class="footer-right"></div>
|
|
paul@134
|
229 <a href="#top">Top of the page</a> |
|
|
paul@134
|
230 <a href="index.html">Table of contents</a>
|
|
paul@134
|
231 </div>
|
|
paul@134
|
232
|
|
paul@134
|
233 <div id="copy">
|
|
paul@134
|
234 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
|
|
paul@134
|
235 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
|
|
paul@134
|
236 Documentation is under
|
|
paul@134
|
237 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
|
|
paul@134
|
238 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
|
|
paul@134
|
239 </div>
|
|
paul@134
|
240
|
|
paul@134
|
241 </body>
|
|
paul@134
|
242 </html>
|
|
paul@134
|
243
|