Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: metadoc.xml lxde-howto.xml
Date: Mon, 30 Nov 2009 19:19:35
Message-Id: E1NFBmQ-00078r-OZ@stork.gentoo.org
1 nightmorph 09/11/30 19:19:26
2
3 Modified: metadoc.xml
4 Added: lxde-howto.xml
5 Log:
6 New guide: LXDE Howto from nathanzachary and yngwin, bug 281345
7
8 Revision Changes Path
9 1.226 xml/htdocs/doc/en/metadoc.xml
10
11 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/metadoc.xml?rev=1.226&view=markup
12 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/metadoc.xml?rev=1.226&content-type=text/plain
13 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/metadoc.xml?r1=1.225&r2=1.226
14
15 Index: metadoc.xml
16 ===================================================================
17 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v
18 retrieving revision 1.225
19 retrieving revision 1.226
20 diff -u -r1.225 -r1.226
21 --- metadoc.xml 12 Nov 2009 22:53:00 -0000 1.225
22 +++ metadoc.xml 30 Nov 2009 19:19:26 -0000 1.226
23 @@ -1,8 +1,8 @@
24 <?xml version="1.0" encoding="UTF-8"?>
25 <!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd">
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.225 2009/11/12 22:53:00 nightmorph Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.226 2009/11/30 19:19:26 nightmorph Exp $ -->
28 <metadoc lang="en">
29 - <version>1.147</version>
30 + <version>1.148</version>
31 <members>
32 <lead>neysx</lead>
33 <member>cam</member>
34 @@ -362,6 +362,7 @@
35 <file id="change-chost">/doc/en/change-chost.xml</file>
36 <file id="xfce-config">/doc/en/xfce-config.xml</file>
37 <file id="openbox">/doc/en/openbox.xml</file>
38 + <file id="lxde-howto">/doc/en/lxde-howto.xml</file>
39 <file id="gcc-optimization">/doc/en/gcc-optimization.xml</file>
40 <file id="vpnc-howto">/doc/en/vpnc-howto.xml</file>
41 <file id="qa-autofailure">/proj/en/qa/autofailure.xml</file>
42 @@ -792,6 +793,9 @@
43 <doc fileid="openbox">
44 <memberof>desktop_install</memberof>
45 </doc>
46 + <doc fileid="lxde-howto">
47 + <memberof>desktop_install</memberof>
48 + </doc>
49 <doc fileid="vserver-howto">
50 <memberof>sysadmin_specific</memberof>
51 </doc>
52
53
54
55 1.1 xml/htdocs/doc/en/lxde-howto.xml
56
57 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/lxde-howto.xml?rev=1.1&view=markup
58 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/lxde-howto.xml?rev=1.1&content-type=text/plain
59
60 Index: lxde-howto.xml
61 ===================================================================
62 <?xml version="1.0" encoding="UTF-8"?>
63 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
64 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/lxde-howto.xml,v 1.1 2009/11/30 19:19:26 nightmorph Exp $ -->
65
66 <guide>
67 <title>The LXDE Configuration HOWTO</title>
68
69 <author title="Author">
70 <mail link="nathanzachary"/>
71 </author>
72 <author title="Editor">
73 <mail link="yngwin"/>
74 </author>
75 <author title="Editor">
76 <mail link="nightmorph"/>
77 </author>
78
79 <abstract>
80 This guide introduces the user to LXDE, explains its components, and leads the
81 user through the installation.
82 </abstract>
83
84 <!-- The content of this document is licensed under the CC-BY-SA license -->
85 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
86 <license/>
87
88 <version>1</version>
89 <date>2009-11-30</date>
90
91 <chapter>
92 <title>Introduction</title>
93 <section>
94 <title>What is LXDE?</title>
95 <body>
96
97 <p>
98 After installing your base Gentoo system, and <uri
99 link="/doc/en/xorg-config.xml">the X Server</uri>, you have to make many
100 choices regarding your graphical environment, if you want one at all. There
101 are many options available to you, ranging from minimalistic window managers
102 like <uri link="/doc/en/openbox.xml">Openbox</uri>, to full-featured
103 desktop environments like <uri link="/proj/en/desktop/kde/kde-config.xml">
104 KDE</uri>, and <uri link="/doc/en/gnome-config.xml">GNOME</uri>.
105 </p>
106
107 <p>
108 You may find yourself saying "well, I like the idea of having a lightweight
109 graphical environment, but I don't want to install and configure every
110 component individually like with Openbox." For quite some time, such users
111 installed <uri link="/doc/en/xfce-config.xml">Xfce</uri>. While it provides
112 a nice full-featured environment without the extensive resource usage of KDE or
113 GNOME, it could still become a bit on the heavy side. Now, you have another
114 choice: the <uri link="http://www.lxde.org">Lightweight X11 Desktop
115 Environment</uri>, or <uri link="http://www.lxde.org">LXDE</uri> for short.
116 </p>
117
118 </body>
119 </section>
120 <section>
121 <title>Components of LXDE</title>
122 <body>
123
124 <p>
125 LXDE, being a desktop environment, is comprised of several components. Each
126 program offers a certain functionality, and together they form the complete
127 desktop environment. Currently, there are eleven core components, and several
128 other programs necessary to make a complete LXDE installation. These programs
129 are the ones pulled in by the <uri
130 link="http://packages.gentoo.org/package/lxde-base/lxde-meta">LXDE meta</uri>
131 package, discussed in the installation section.
132 </p>
133
134 </body>
135 </section>
136 <section>
137 <title>Core Components</title>
138 <body>
139
140 <ul>
141 <li>
142 <uri
143 link="http://packages.gentoo.org/package/lxde-base/lxappearance">LXappearance</uri>
144 is a GTK theme and icon configurator that allows you to customise the look
145 of LXDE
146 </li>
147 <li>
148 <uri
149 link="http://packages.gentoo.org/package/lxde-base/lxde-common">LXDE-common</uri>
150 is a collection of default configuration files and the main set of icons
151 </li>
152 <li>
153 <uri
154 link="http://packages.gentoo.org/package/lxde-base/lxmenu-data">LXmenu-data</uri>
155 is the application menu manager
156 </li>
157 <li>
158 <uri
159 link="http://packages.gentoo.org/package/lxde-base/lxinput">LXinput</uri> is
160 a keyboard and mouse configurator
161 </li>
162 <li>
163 <uri
164 link="http://packages.gentoo.org/package/lxde-base/lxpanel">LXpanel</uri> is
165 the panel that includes the application menu, system tray, and clock
166 </li>
167 <li>
168 <uri
169 link="http://packages.gentoo.org/package/lxde-base/lxrandr">LXrandr</uri> is
170 a graphical interface to X Resize and Rotate, allowing for display
171 manipulation
172 </li>
173 <li>
174 <uri
175 link="http://packages.gentoo.org/package/lxde-base/lxsession">LXsession</uri>
176 is a session manager, providing options to shutdown, reboot, and suspend the
177 system
178 </li>
179 <li>
180 <uri link="http://packages.gentoo.org/package/lxde-base/lxsession-edit">
181 LXsession-edit</uri> allows you to enable/disable applications at startup
182 </li>
183 <li>
184 <uri
185 link="http://packages.gentoo.org/package/lxde-base/lxshortcut">LXshortcut</uri>
186 is an easy way to edit application shortcuts, especially for desktop icons
187 </li>
188 <li>
189 <uri link="http://packages.gentoo.org/package/lxde-base/lxtask">LXtask</uri>
190 is the task manager used to view/edit running services and programs
191 </li>
192 <li>
193 <uri
194 link="http://packages.gentoo.org/package/lxde-base/lxterminal">LXterminal</uri>
195 is the vte-based tabbed terminal emulator
196 </li>
197 </ul>
198
199 </body>
200 </section>
201 <section>
202 <title>Other Applications used by LXDE</title>
203 <body>
204
205 <ul>
206 <li>
207 <uri
208 link="http://packages.gentoo.org/package/x11-wm/openbox">OpenBox</uri>
209 is the window manager, responsible for drawing the containers for programs
210 </li>
211 <li>
212 <uri
213 link="http://packages.gentoo.org/package/x11-misc/pcmanfm">PCManFM</uri> is
214 the incredibly fast, tabbed file manager
215 </li>
216 <li>
217 <uri
218 link="http://packages.gentoo.org/package/x11-misc/obconf">ObConf</uri> is
219 the configurator for OpenBox, allowing you to change window decorations
220 and more
221 </li>
222 <li>
223 <uri link="http://packages.gentoo.org/package/media-gfx/gpicview">GPicView
224 </uri> is the default image viewer
225 </li>
226 </ul>
227
228 </body>
229 </section>
230 </chapter>
231
232 <chapter>
233 <title>Installation</title>
234 <section>
235 <title>Initial installation</title>
236 <body>
237
238 <p>
239 After you have emerged and configured <uri
240 link="/doc/en/xorg-config">xorg-server</uri>, you are ready to install LXDE.
241 While you may install each component individually, the more efficient and
242 preferred method is to emerge the meta package set:
243 </p>
244
245 <pre caption="Installing LXDE">
246 # <i>emerge -av lxde-meta</i>
247 </pre>
248
249 <p>
250 If everything looks to your liking (meaning the current set of USE flags,
251 etc.), then say "yes" when asked if you want to emerge the packages.
252 Just like with other desktop environments, you will need to tell the
253 X Server to load LXDE automatically, by adding it to your
254 <path>~/.xinitrc</path>.
255 </p>
256
257 <pre caption="Adding LXDE to your .xinitrc">
258 $ <i>echo "exec startlxde" >> ~/.xinitrc</i>
259 </pre>
260
261 <p>
262 This will automatically start your LXDE session when you type <c>startx</c>
263 at the console.
264 </p>
265
266 <note>
267 If you use a login manager like SLiM, XDM, GDM, or KDM, you do not need to
268 edit your <path>~/.xinitrc</path>. LXDE will simply show up as a choice in
269 your login manager's screen.
270 </note>
271
272 <impo>
273 As each user has his or her own <path>.xinitrc</path>, you need to make sure to
274 issue that command as <e>your user</e>, not as root.
275 </impo>
276
277 </body>
278 </section>
279 </chapter>
280
281 <chapter>
282 <title>Configuration</title>
283 <section>
284 <title>GTK icon warning</title>
285 <body>
286
287 <p>
288 Now that the X server knows to start LXDE on command, type in <c>startx</c> to
289 fire up LXDE. The first thing you may notice is that you get a warning about an
290 improper GTK icon set. To fix this minor hangup, you simply need to change the
291 icon theme. To do so, click on the LXDE application menu (in the lower left-hand
292 corner of the panel), and go to Preferences --> Appearance. In the LXappearance
293 menu, click on the "Icon" tab, and choose nuoveXT.2.2. Hit "Apply," and then
294 "Close." The next time you login to LXDE, the error message will not appear.
295 However, you are not limited to using the nuoveXT.2.2 icon theme. You may
296 install any other icon theme through LXappearance, and when it is selected, the
297 GTK icon warning will no longer appear when starting PCManFM.
298 </p>
299
300 </body>
301 </section>
302 <section>
303 <title>Right-click menu</title>
304 <body>
305
306 <p>
307 In LXDE, every appearance option is not handled through LXappearance as one
308 might believe. Rather, there are some common options that are handled through
309 a right-click menu on the desktop. At the bottom of that menu is the
310 "Desktop Settings" menu. In here, you can find icon sizes, single-click and
311 double-click behavior, maximum thumbnail size, and desktop wallpaper
312 settings. It may behoove you to look through the these tabs for additional
313 appearance settings.
314 </p>
315
316 <note>
317 These "Desktop Settings" can also be found by opening up the file manager
318 (PCManFM), and going to Edit --> Preferences.
319 </note>
320
321 </body>
322 </section>
323 </chapter>
324
325 <chapter>
326 <title>Further documentation</title>
327 <section>
328 <title>External resources</title>
329 <body>
330
331 <p>
332 Though this guide will help you get LXDE installed, the documentation does not
333 stop here. There are many resources available to you regarding the various
334 facets of the Lightweight X11 Desktop Environment. Some such resources are
335 listed below:
336 </p>
337
338 <ul>
339 <li>
340 On the <uri link="http://www.lxde.org">Official LXDE website</uri> you
341 will find information regarding developmental progress, a community
342 of support, and recommend system specifications for running LXDE
343 </li>
344 <li>
345 The <uri link="http://wiki.lxde.org/en/Main_Page">LXDE wiki</uri> contains
346 instructions for customising your LXDE installation, including
347 keyboard layouts, autostarting applications, changing the default window
348 manager, and much more
349 </li>
350 </ul>
351
352 </body>
353 </section>
354 </chapter>
355 </guide>