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