website view en/doc/handbook/jwm.html @ rev 344
fr: Typo and add language links
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sat Mar 28 01:45:51 2009 +0100 (2009-03-28) |
| parents | |
| children | 181e51e86dd6 |
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <title>SliTaz Handbook (en) - Desktop</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz window manager jwm" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2009-03-25 10:30:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="Christophe Lincoln"/>
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" />
14 </head>
15 <body bgcolor="#ffffff">
17 <!-- Header and quick navigation -->
18 <div id="header">
19 <div align="right" id="quicknav">
20 <a name="top"></a>
21 <a href="index.html">Table of contents</a>
22 </div>
23 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
24 </div>
26 <!-- Content. -->
27 <div id="content">
28 <div class="content-right"></div>
30 <h2><font color="#DF8F06">JWM</font></h2>
32 <a name="jwm"></a>
33 <h3>JWM - Joe's Window Manager</h3>
34 <p>
35 Joe's window manager, written in C is quick, simple, clean, stable and efficient.
36 JWM proposes a taskbar, a menu of icons and a
37 pager for the management of virtual desktops. The taskbar can also act as a dock.
38 In addition it is easily configurable with a single text file that can
39 change the menu, fonts and their sizes, and different colors. To install
40 jwm on SliTaz:
41 </p>
42 <pre> # tazpkg get-install jwm
43 </pre>
45 <h4>Use and configure JWM</h4>
46 <p>
47 The application of Joe's Window Manager is very fast. To view the menu just
48 click somewhere on the desktop. You can resize a window through the edges or
49 corners, minimize or pass a virtual desktop to another via a pager. You
50 also have configurable keyboard shortcuts for faster access to the applications
51 that you often use. On SliTaz the system configuration file is
52 <code>/etc/jwm/system.jwmrc</code>. Apart from this file, each user can use
53 its own configuration file hidden in <code>~/.jwmrc</code>. This is a text file using XML
54 syntax, it can edited with a simple text editor - lines beginning with:
55 <code><!--</code> are comments that let you understand what each tag does.
56 </p>
57 <p>
58 To facilitate the customization of the desktop, SliTaz automatically copies
59 at the launch of the first (graphical) session, a system configuration file to
60 the root directory of the user. You can directly modify this file and test
61 without risk. To edit with your favorite text editor:
62 </p>
63 <pre>
64 $ geany $HOME/.jwmrc &
65 </pre>
66 <p>
67 To retrieve an original configuration file, you can copy the system configuration
68 file and rename it <code>.jwmrc</code> in your home directory:
69 </p>
70 <pre>
71 $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc
72 </pre>
73 <p>
74 The tag <code>RootMenu</code> corresponds to the menu displayed by clicking on one of the
75 (three) buttons on the mouse. To add a category, you must use the tag: <code>Menu</code>
76 - this contains entries for various programs. Any entry in the JWM menu can
77 fit on one line. Example using the GQview image management application:
78 </p>
79 <pre class="script">
80 <Program icon="gqview.png" label="GQview">gqview</Program>
81 </pre>
82 <p>
83 There are still many opportunities to configure <code>RootMenu</code> according to the
84 mouse buttons; the choice of method to move windows, create groups, etc.
85 The Manual is available online at the official website of the project. To view
86 a list of command-line options, just type <code>jwm -h</code> in a terminal.
87 </p>
89 <h4>Create your own JWM style</h4>
90 <p>
91 Creating your own graphical style with JWM is relatively quick
92 and easy, the tags are clear and the attributes possible
93 are given in the comments. When preparing your work, you can
94 see your amendments by restarting the window manager from the
95 menu or via the <code>jwm -restart</code> command. In the configuration
96 file, style tags start after the <!-- Visual Styles --> comment. To
97 begin, here is a short list of the main style tags with a short
98 description:
99 </p>
100 <ul>
101 <li><code>Background</code> manages the wallpaper. This tag supports the
102 <code>solid</code>, <code>gradient</code>, <code>image</code> or <code>tile</code>
103 attributes, to respectively:- use a solid color, create a gradient,
104 display a resized image or tile an image.</li>
106 <li><code>BorderStyle</code> controls the windows border.</li>
108 <li><code>TrayStyle</code> controls a taskbar. The taskbar may, among other
109 things be automatically hidden or only fill a part of the
110 screen with the <code>width</code> attribute.</li>
112 <li><code>TrayListStyle</code> controls the style of the list of open windows
113 on the current desktop.</li>
115 <li><code>PagerStyle</code> controls the pager displaying different virtual
116 desktops (4 by default).</li>
118 <li><code>MenuStyle</code> defines the menu style.</li>
120 <li>The icons are defined by the <code>IconPath</code> tag, you can use your
121 own personal icons by specifing the full path to the directory
122 that contains them. Note that you can specify more than
123 one path, if you want, you can use your own icons <em>and</em> those
124 contained in the <code>/usr/share/pixmaps</code> and <code>/usr/share/icons</code>
125 system directories. SliTaz uses the Tango theme icons:
126 <a href="http://tango.freedesktop.org/">tango.freedesktop.org</a>
127 for the menu, they are 16x16 and are stored in
128 <code>/usr/share/icons/Tango</code>. You can add, edit, delete
129 these... If you want to install new icons in your user
130 space, we advise you to use <code>~/Picture/Icons</code> (set as default)
131 or a hidden directory <code>~/.Icons</code>.</li>
132 </ul>
133 <p>
134 The colors can be defined by their name or RGB number, such
135 as <code>#3A4956</code>. To use colors in their gradient mode, you must
136 specify the two colors separated by a colon, example
137 <code>#6C0023:#3E1220</code>. You can change fonts and their sizes by
138 using the <code>Font</code> tag. There are still some small things that
139 you can change to customize your desktop, such as the name
140 of a menu item and its icon. Before restarting JWM with your
141 new configuration file, you can check its syntax by using
142 the command: <code>jwm -p</code>. To explore further, the official
143 handbook describes all the tags, options and valid attributes.
144 You can view it online at the JWM website.
145 </p>
147 <h4>JWM website</h4>
148 <ul>
149 <li><a href="http://www.joewing.net/programs/jwm/"
150 >www.joewing.net/programs/jwm/</a> - The official website of
151 Joe's Window Manager, providing news and a comprehensive manual.</li>
152 <li>#jwm on irc.freenode.net - The JWM IRC discussion channel on
153 Freenode server.</li>
154 </ul>
156 <!-- End of content -->
157 </div>
159 <!-- Footer. -->
160 <div id="footer">
161 <div class="footer-right"></div>
162 <a href="#top">Top of the page</a> |
163 <a href="index.html">Table of contents</a>
164 </div>
166 <div id="copy">
167 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
168 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
169 Documentation is under
170 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
171 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
172 </div>
174 </body>
175 </html>