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> |