website rev 134
en: Add Desktop page to Hdbk
author | Paul Issott <paul@slitaz.org> |
---|---|
date | Sun Aug 10 09:45:16 2008 +0000 (2008-08-10) |
parents | 5007dd335a94 |
children | a1fd009ac7b3 |
files | en/doc/handbook/desktop.html en/doc/handbook/index.html en/doc/handbook/livecd.html |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/en/doc/handbook/desktop.html Sun Aug 10 09:45:16 2008 +0000 1.3 @@ -0,0 +1,243 @@ 1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 1.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 1.7 +<head> 1.8 + <title>SliTaz Handbook (en) - Desktop</title> 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="slitaz English handbook" /> 1.11 + <meta name="expires" content="never" /> 1.12 + <meta name="modified" content="2008-02-26 18:30:00" /> 1.13 + <meta name="publisher" content="www.slitaz.org" /> 1.14 + <meta name="author" content="Christophe Lincoln, Paul Issott"/> 1.15 + <link rel="shortcut icon" href="favicon.ico" /> 1.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 1.17 +</head> 1.18 +<body bgcolor="#ffffff"> 1.19 + 1.20 +<!-- Header and quick navigation --> 1.21 +<div id="header"> 1.22 +<div align="right" id="quicknav"> 1.23 + <a name="top"></a> 1.24 + <a href="cmdline.html">Commands</a> | 1.25 + <a href="index.html">Table of contents</a> 1.26 +</div> 1.27 +<h1><font color="#3E1220">SliTaz Handbook (en)</font></h1> 1.28 +</div> 1.29 + 1.30 +<!-- Content. --> 1.31 +<div id="content"> 1.32 +<div class="content-right"></div> 1.33 + 1.34 +<h2><font color="#DF8F06">SliTaz Desktop</font></h2> 1.35 + 1.36 +<ul> 1.37 + <li><a href="#intro">Introduction.</a></li> 1.38 + <li><a href="#jwm">JWM.</a></li> 1.39 + <li><a href="#lxpanel">LxPanel.</a></li> 1.40 + <li><a href="x-window.html#openbox">Openbox.</a></li> 1.41 + <li><a href="x-window.html#enlightenment">Enlightenment.</a></li> 1.42 +</ul> 1.43 + 1.44 +<a name="intro"></a> 1.45 +<h3>Introduction</h3> 1.46 +<p> 1.47 +The default SliTaz desktop is brought to you by many different components. 1.48 +JWM (Joe's Window Manager) and LXPanel combine to provide a Desktop providing 1.49 +simplicity and functionality. 1.50 +</p> 1.51 + 1.52 +<a name="jwm"></a> 1.53 +<h3>JWM - Joe's Window Manager</h3> 1.54 +<p> 1.55 +Joe's window manager, written in C is quick, simple, clean, stable and efficient. 1.56 +JWM proposes a taskbar, a menu of icons and a 1.57 +pager for the management of virtual desktops, the taskbar can also act as a dock. 1.58 +In addition it is easily configurable with a single text file that can 1.59 +change the menu, fonts and their sizes and different colors. 1.60 +</p> 1.61 + 1.62 +<h4>Use and configure JWM</h4> 1.63 +<p> 1.64 +The application of Joe's Window Manager is very fast. To view the menu just 1.65 +click somewhere on the desktop. You can resize a window through the edges or 1.66 +corners, minimize or pass a virtual desktop to another via a pager. You 1.67 +also have configurable keyboard shortcuts for faster access to the applications 1.68 +that you use the most. On SliTaz the system configuration file is 1.69 +<code>/etc/jwm/system.jwmrc</code>. Apart from this file, each user can use 1.70 +its own configuration file hidden in <code>~/.jwmrc</code>. This is a text file using XML 1.71 +syntax, it can edited with a simple text editor - lines beginning with: 1.72 +<code><!--</code> are comments that let you understand what each tag does. 1.73 +</p> 1.74 +<p> 1.75 +To facilitate the customization of the desktop, SliTaz automatically copies 1.76 +at the launch of the first (graphical) session, a system configuration file to 1.77 +the root directory of the user. You can directly modify this file and test 1.78 +without risk. To edit with your favorite text editor: 1.79 +</p> 1.80 +<pre> 1.81 + $ geany $HOME/.jwmrc & 1.82 +</pre> 1.83 +<p> 1.84 +To retrieve an original configuration file, you can copy the system configuration 1.85 +file and rename it <code>.jwmrc</code> in your home directory: 1.86 +</p> 1.87 +<pre> 1.88 + $ cp /etc/jwm/system.jwmrc $HOME/.jwmrc 1.89 +</pre> 1.90 +<p> 1.91 +The tag <code>RootMenu</code> corresponds to the menu displayed by clicking on one of the 1.92 +(three) buttons on the mouse. To add a category, you must use the tag: <code>Menu</code> 1.93 + - this contains entries for various programs. Any entry in the JWM menu can 1.94 +fit on one line. Example using the GQview image management application: 1.95 +</p> 1.96 +<pre class="script"> 1.97 +<Program icon="gqview.png" label="GQview">gqview</Program> 1.98 +</pre> 1.99 +<p> 1.100 +There are still many opportunities to configure <code>RootMenu</code> according to the 1.101 +mouse buttons, the choice of method to move windows, create groups, etc. 1.102 +The Manual is available online at the official website of the project. To view 1.103 +a list of command-line options, just type <code>jwm -h</code> in a terminal. 1.104 +</p> 1.105 + 1.106 +<h4>Create your own JWM style</h4> 1.107 +<p> 1.108 +Creating your own graphical style with JWM is relatively quick 1.109 +and easy, the tags are clear and the attributes possible 1.110 +are given in the comments. When preparing your work, you can 1.111 +see your amendments by restarting the window manager from the 1.112 +menu or via the <code>jwm -restart</code> command. In the configuration 1.113 +file, style tags start after the <!-- Visual Styles --> comment. To 1.114 +begin, here is a short list of the main style tags with a short 1.115 +description: 1.116 +</p> 1.117 +<ul> 1.118 + <li><code>Background</code> manages the wallpaper. This tag supports the 1.119 + <code>solid</code>, <code>gradient</code>, <code>image</code> or <code>tile</code> 1.120 + attributes, to respectively; use a solid color, create a gradient, 1.121 + display a resized image or tile an image.</li> 1.122 + 1.123 + <li><code>BorderStyle</code> controls the windows border.</li> 1.124 + 1.125 + <li><code>TrayStyle</code> controls a taskbar. The taskbar may, among other 1.126 + things be automatically hidden or only fill a part of the 1.127 + screen with the <code>width</code> attribute.</li> 1.128 + 1.129 + <li><code>TrayListStyle</code> controls the style of the list of open windows 1.130 + on the current desktop.</li> 1.131 + 1.132 + <li><code>PagerStyle</code> controls the pager displaying different virtual 1.133 + desktops (4 by default).</li> 1.134 + 1.135 + <li><code>MenuStyle</code> defines the menu style.</li> 1.136 + 1.137 + <li>The icons are defined by the <code>IconPath</code> tag, you can use your 1.138 + own personal icons by specifing the full path to the directory 1.139 + that contains them. Note that you can specify more than 1.140 + one path, if you want, you can use your own icons <em>and</em> those 1.141 + contained in the <code>/usr/share/pixmaps</code> and <code>/usr/share/icons</code> 1.142 + system directories. SliTaz uses the Tango theme icons: 1.143 + <a href="http://tango.freedesktop.org/">tango.freedesktop.org</a> 1.144 + for the menu, they are 16x16 and are stored in 1.145 + <code>/usr/share/icons/Tango</code>. You can add, edit, delete 1.146 + these... If you want to install new icons in your user 1.147 + space, we advise you to use <code>~/Picture/Icons</code> (set as default) 1.148 + or a hidden directory <code>~/.Icons</code>.</li> 1.149 +</ul> 1.150 +<p> 1.151 +The colors can be defined by their name or RGB number, such 1.152 +as <code>#3A4956</code>. To use colors in their gradient mode, you must 1.153 +specify the two colors separated by a colon, example 1.154 +<code>#6C0023:#3E1220</code>. You can change fonts and their sizes by 1.155 +using the <code>Font</code> tag. There are still some small things that 1.156 +you can change to customize your desktop, such as the name 1.157 +of a menu item and its icon. Before restarting JWM with your 1.158 +new configuration file, you can check its syntax by using 1.159 +the command: <code>jwm -p</code>. To explore further, the official 1.160 +handbook describes all the tags, options and valid attributes. 1.161 +You can view it online at the JWM website. 1.162 +</p> 1.163 + 1.164 +<h4>JWM website</h4> 1.165 +<ul> 1.166 + <li><a href="http://www.joewing.net/programs/jwm/" 1.167 + >www.joewing.net/programs/jwm/</a> - The official website of 1.168 + Joe's Window Manager, providing news and a comprehensive manual.</li> 1.169 + <li>#jwm on irc.freenode.net - The JWM IRC discussion channel on 1.170 + Freenode server.</li> 1.171 +</ul> 1.172 + 1.173 +<a name="lxpanel"></a> 1.174 +<h3>LXPanel</h3> 1.175 +<p> 1.176 +LXPanel is part of the LXDE project and follows the Freedesktop standards. Menus 1.177 +are dynamically generated by adding <code>.desktop</code> files to the 1.178 +<code>/usr/share/applications</code> directory. 1.179 +</p> 1.180 +<h4>*.desktop files</h4> 1.181 +<p> 1.182 +A single .desktop file 1.183 +can contain eight lines with respectively:- 1.184 +the name (<code>Name</code>), generic name, comment, the command to 1.185 +execute (<code>Exec</code>), icon, type and Freedesktop categories. 1.186 +Example of a .desktop file: 1.187 +</p> 1.188 +<pre class="script">[Desktop Entry] 1.189 +Name=XTerm 1.190 +GenericName=Terminal 1.191 +Comment=Run commands in a shell 1.192 +Exec=xterm -bg black -fg white -cr orange -sb -bd violet -rightbar 1.193 +Icon=xterm.png 1.194 +Type=Application 1.195 +Categories=Utility;Terminal; 1.196 +</pre> 1.197 +<p> 1.198 +Note that the icons are located in <code>/usr/share/icons</code> or 1.199 +<code>/usr/share/pixmaps</code> directory. The <code>Categories</code> 1.200 +entry states where the program will sit in the menu. 1.201 +</p> 1.202 +<p> 1.203 +The system configuration file is located in <code>/etc/lxpanel</code> 1.204 +and can also be stored locally in <code>~/.config</code> though it is 1.205 +recommended that you configure LXPanel graphically by using the 1.206 +preferences entry in the main menu. 1.207 +</p> 1.208 + 1.209 +<h4>LXPanel configurator</h4> 1.210 +<p> 1.211 +The LXPanel configurator has 3 tabs:- 1.212 +</p> 1.213 +<ul> 1.214 + <li><code>General</code> handles the position, size - either dynamic 1.215 + or fixed, panel background and properties.</li> 1.216 + <li><code>Plugins</code> lets you add, remove, edit and move plugins 1.217 + around on the panel.</li> 1.218 + <li><code>Applications</code> allows you to set preferred applications 1.219 + like the file manager, terminal and logout command.</li> 1.220 +</ul> 1.221 +<p> 1.222 +The official website for the LXDE project and LXPanel can be found 1.223 +<a href="http://lxde.org/">here</a>. 1.224 +</p> 1.225 + 1.226 +<!-- End of content --> 1.227 +</div> 1.228 + 1.229 +<!-- Footer. --> 1.230 +<div id="footer"> 1.231 + <div class="footer-right"></div> 1.232 + <a href="#top">Top of the page</a> | 1.233 + <a href="index.html">Table of contents</a> 1.234 +</div> 1.235 + 1.236 +<div id="copy"> 1.237 + Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> - 1.238 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 1.239 + Documentation is under 1.240 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 1.241 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 1.242 +</div> 1.243 + 1.244 +</body> 1.245 +</html> 1.246 +
2.1 --- a/en/doc/handbook/index.html Tue Aug 05 08:18:55 2008 +0000 2.2 +++ b/en/doc/handbook/index.html Sun Aug 10 09:45:16 2008 +0000 2.3 @@ -34,6 +34,7 @@ 2.4 <ul> 2.5 <li><a href="livecd.html">LiveCD usage</a> - How to boot and set options 2.6 at the command prompt.</li> 2.7 + <li><a href="desktop.html">Desktop</a> - Configure the Desktop.</li> 2.8 <li><a href="cmdline.html">Commands</a> - List of useful commands.</li> 2.9 <li><a href="install.html">Installation</a> - HD install instructions.</li> 2.10 </ul>
3.1 --- a/en/doc/handbook/livecd.html Tue Aug 05 08:18:55 2008 +0000 3.2 +++ b/en/doc/handbook/livecd.html Sun Aug 10 09:45:16 2008 +0000 3.3 @@ -18,7 +18,7 @@ 3.4 <div id="header"> 3.5 <div align="right" id="quicknav"> 3.6 <a name="top"></a> 3.7 - <a href="cmdline.html">Commands</a> | 3.8 + <a href="desktop.html">Desktop</a> | 3.9 <a href="index.html">Table of contents</a> 3.10 </div> 3.11 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>