website view en/doc/handbook/jwm.html @ rev 456
FR: Fixed typos
| author | Pierre ROMILLON <pierre.romillon@slitaz.org> |
|---|---|
| date | Sun May 10 17:08:59 2009 +0200 (2009-05-10) |
| parents | 0350a87566cc |
| children | fa2c5bed2417 |
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) - JWM</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 pager for the management of virtual
37 desktops. The taskbar can also act as a dock. In addition it is easily configurable
38 with a single text file that can change the menu, fonts and their sizes, and different
39 colors. To install jwm on SliTaz:
40 </p>
41 <pre> # tazpkg get-install jwm
42 </pre>
43 <p>
44 Logout your current X session, type <code>F1</code> at Slim login and choose
45 <code>jwm</code> to start JWM. To make JWM your default Window
46 Manager, just type: <code>tazx jwm</code>.
47 </p>
49 <h4>Use and configure JWM</h4>
50 <p>
51 The application of Joe's Window Manager is very fast. To view the menu just
52 click somewhere on the desktop. You can resize a window through the edges or
53 corners, minimize or pass a virtual desktop to another via a pager. You
54 also have configurable keyboard shortcuts for faster access to the applications
55 that you often use. On SliTaz the system configuration file is
56 <code>/etc/jwm/system.jwmrc</code>. Apart from this file, each user can use
57 its own configuration file hidden in <code>~/.jwmrc</code>. This is a text file using XML
58 syntax, it can edited with a simple text editor - lines beginning with:
59 <code><!--</code> are comments that let you understand what each tag does.
60 </p>
61 <p>
62 To facilitate the customization of the desktop, SliTaz automatically copies
63 at the launch of the first (graphical) session, a system configuration file to
64 the root directory of the user. You can directly modify this file and test
65 without risk. To edit with your favorite text editor:
66 </p>
67 <pre>
68 $ geany $HOME/.jwmrc &
69 </pre>
70 <p>
71 To retrieve an original configuration file, you can copy the system configuration
72 file and rename it <code>.jwmrc</code> in your home directory:
73 </p>
74 <pre>
75 $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc
76 </pre>
77 <p>
78 The tag <code>RootMenu</code> corresponds to the menu displayed by clicking on one of the
79 (three) buttons on the mouse. To add a category, you must use the tag: <code>Menu</code>
80 - this contains entries for various programs. Any entry in the JWM menu can
81 fit on one line. Example using the GQview image management application:
82 </p>
83 <pre class="script">
84 <Program icon="gqview.png" label="GQview">gqview</Program>
85 </pre>
86 <p>
87 There are still many opportunities to configure <code>RootMenu</code> according to the
88 mouse buttons; the choice of method to move windows, create groups, etc.
89 The Manual is available online at the official website of the project. To view
90 a list of command-line options, just type <code>jwm -h</code> in a terminal.
91 </p>
93 <h4>Create your own JWM style</h4>
94 <p>
95 Creating your own graphical style with JWM is relatively quick
96 and easy, the tags are clear and the attributes possible
97 are given in the comments. When preparing your work, you can
98 see your amendments by restarting the window manager from the
99 menu or via the <code>jwm -restart</code> command. In the configuration
100 file, style tags start after the <!-- Visual Styles --> comment. To
101 begin, here is a short list of the main style tags with a short
102 description:
103 </p>
104 <ul>
105 <li><code>Background</code> manages the wallpaper. This tag supports the
106 <code>solid</code>, <code>gradient</code>, <code>image</code> or <code>tile</code>
107 attributes, to respectively:- use a solid color, create a gradient,
108 display a resized image or tile an image.</li>
110 <li><code>BorderStyle</code> controls the windows border.</li>
112 <li><code>TrayStyle</code> controls a taskbar. The taskbar may, among other
113 things be automatically hidden or only fill a part of the
114 screen with the <code>width</code> attribute.</li>
116 <li><code>TrayListStyle</code> controls the style of the list of open windows
117 on the current desktop.</li>
119 <li><code>PagerStyle</code> controls the pager displaying different virtual
120 desktops (4 by default).</li>
122 <li><code>MenuStyle</code> defines the menu style.</li>
124 <li>The icons are defined by the <code>IconPath</code> tag, you can use your
125 own personal icons by specifing the full path to the directory
126 that contains them. Note that you can specify more than
127 one path, if you want, you can use your own icons <em>and</em> those
128 contained in the <code>/usr/share/pixmaps</code> and <code>/usr/share/icons</code>
129 system directories. SliTaz uses the Tango theme icons:
130 <a href="http://tango.freedesktop.org/">tango.freedesktop.org</a>
131 for the menu, they are 16x16 and are stored in
132 <code>/usr/share/icons/Tango</code>. You can add, edit, delete
133 these... If you want to install new icons in your user
134 space, we advise you to use <code>~/Picture/Icons</code> (set as default)
135 or a hidden directory <code>~/.Icons</code>.</li>
136 </ul>
137 <p>
138 The colors can be defined by their name or RGB number, such
139 as <code>#3A4956</code>. To use colors in their gradient mode, you must
140 specify the two colors separated by a colon, example
141 <code>#6C0023:#3E1220</code>. You can change fonts and their sizes by
142 using the <code>Font</code> tag. There are still some small things that
143 you can change to customize your desktop, such as the name
144 of a menu item and its icon. Before restarting JWM with your
145 new configuration file, you can check its syntax by using
146 the command: <code>jwm -p</code>. To explore further, the official
147 handbook describes all the tags, options and valid attributes.
148 You can view it online at the JWM website.
149 </p>
151 <h4>JWM website</h4>
152 <ul>
153 <li><a href="http://www.joewing.net/programs/jwm/"
154 >www.joewing.net/programs/jwm/</a> - The official website of
155 Joe's Window Manager, providing news and a comprehensive manual.</li>
156 <li>#jwm on irc.freenode.net - The JWM IRC discussion channel on
157 Freenode server.</li>
158 </ul>
160 <!-- End of content -->
161 </div>
163 <!-- Footer. -->
164 <div id="footer">
165 <div class="footer-right"></div>
166 <a href="#top">Top of the page</a> |
167 <a href="index.html">Table of contents</a>
168 </div>
170 <div id="copy">
171 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
172 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
173 Documentation is under
174 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
175 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
176 </div>
178 </body>
179 </html>