website annotate en/doc/handbook/jwm.html @ rev 550

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