| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
2 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.33 2010/08/31 18:06:31 nightmorph Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.34 2011/01/23 07:28:31 nightmorph Exp $ --> |
| 4 | |
4 | |
| 5 | <guide> |
5 | <guide> |
| 6 | <title>The Xfce Configuration Guide</title> |
6 | <title>The Xfce Configuration Guide</title> |
| 7 | |
7 | |
| 8 | <author title="Author"> |
8 | <author title="Author"> |
| … | |
… | |
| 16 | |
16 | |
| 17 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
17 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 18 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
18 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 19 | <license/> |
19 | <license/> |
| 20 | |
20 | |
| 21 | <version>1.28</version> |
21 | <version>2</version> |
| 22 | <date>2010-08-31</date> |
22 | <date>2011-01-22</date> |
| 23 | |
23 | |
| 24 | <chapter> |
24 | <chapter> |
| 25 | <title>Introduction</title> |
25 | <title>Introduction</title> |
| 26 | <section> |
26 | <section> |
| 27 | <title>The Xfce desktop environment</title> |
27 | <title>The Xfce desktop environment</title> |
| … | |
… | |
| 64 | </p> |
64 | </p> |
| 65 | |
65 | |
| 66 | <p> |
66 | <p> |
| 67 | Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll |
67 | Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll |
| 68 | probably at least want <c>USE="-gnome -kde -minimal -qt4 branding dbus |
68 | probably at least want <c>USE="-gnome -kde -minimal -qt4 branding dbus |
| 69 | hal jpeg lock session startup-notification thunar X"</c>. |
69 | jpeg lock session startup-notification thunar udev X"</c>. |
| 70 | </p> |
|
|
| 71 | |
|
|
| 72 | <p> |
70 | </p> |
| 73 | There's also another variable you can set in <path>/etc/make.conf</path> called |
71 | |
| 74 | XFCE_PLUGINS. This variable controls additional Xfce plugins for the panel. You |
|
|
| 75 | can enable all of the plugins by adding <c>XFCE_PLUGINS="brightness menu |
|
|
| 76 | trash</c> to <path>/etc/make.conf</path>. Here's a brief summary of the |
|
|
| 77 | plugins: |
|
|
| 78 | </p> |
72 | <p> |
| 79 | |
|
|
| 80 | <dl> |
|
|
| 81 | <dt>brightness</dt> |
|
|
| 82 | <dd> |
|
|
| 83 | Lets you add a screen brightness applet to your panel, once you have |
|
|
| 84 | installed <c>xfce4-power-manager</c> |
|
|
| 85 | </dd> |
|
|
| 86 | <dt>menu</dt> |
|
|
| 87 | <dd>Lets you add a program menu to your panel</dd> |
|
|
| 88 | <dt>trash</dt> |
|
|
| 89 | <dd> |
|
|
| 90 | Lets you add a Trash can to the panel. The Trash allows you to quickly |
|
|
| 91 | delete files or recover them. |
|
|
| 92 | </dd> |
|
|
| 93 | </dl> |
|
|
| 94 | |
|
|
| 95 | <p> |
|
|
| 96 | Now that you've set your <c>USE</c> and <c>XFCE_PLUGINS</c> variables in |
73 | Now that you've set your <c>USE</c> variables in |
| 97 | <path>/etc/make.conf</path>, it's time to install Xfce. |
74 | <path>/etc/make.conf</path>, it's time to install Xfce. |
| 98 | </p> |
75 | </p> |
| 99 | |
76 | |
| 100 | <pre caption="Installing Xfce"> |
77 | <pre caption="Installing Xfce"> |
| 101 | # <i>emerge -avt xfce4-meta</i> |
78 | # <i>emerge -avt xfce4-meta</i> |
| 102 | </pre> |
79 | </pre> |
| 103 | |
80 | |
| 104 | <p> |
81 | <p> |
| 105 | Next, add your regular user(s) to the <c>plugdev</c>, <c>cdrom</c>, <c>cdrw</c>, |
82 | Next, add your regular user(s) to the <c>plugdev</c>, <c>cdrom</c>, <c>cdrw</c>, |
| 106 | and <c>usb</c> groups, so that they can take full advantage of <c>hal</c> and be |
83 | and <c>usb</c> groups, so that they can mount and use devices such as cameras, |
| 107 | able to mount and use devices such as cameras, optical drives, and USB sticks. |
84 | optical drives, and USB sticks. |
| 108 | </p> |
85 | </p> |
| 109 | |
86 | |
| 110 | <pre caption="Adding users to the hardware groups"> |
87 | <pre caption="Adding users to the hardware groups"> |
| 111 | <comment>(Replace username with your actual user)</comment> |
88 | <comment>(Replace username with your actual user)</comment> |
| 112 | # <i>for x in plugdev cdrom cdrw usb ; do gpasswd -a username $x ; done</i> |
89 | # <i>for x in plugdev cdrom cdrw usb ; do gpasswd -a username $x ; done</i> |
| … | |
… | |
| 116 | Next, update your environment variables: |
93 | Next, update your environment variables: |
| 117 | </p> |
94 | </p> |
| 118 | |
95 | |
| 119 | <pre caption="Updating environment variables"> |
96 | <pre caption="Updating environment variables"> |
| 120 | # <i>env-update && source /etc/profile</i> |
97 | # <i>env-update && source /etc/profile</i> |
| 121 | </pre> |
|
|
| 122 | |
|
|
| 123 | <p> |
|
|
| 124 | Now start up <c>hald</c> and add it to the default runlevel: |
|
|
| 125 | </p> |
|
|
| 126 | |
|
|
| 127 | <pre caption="Starting hald"> |
|
|
| 128 | # <i>/etc/init.d/hald start</i> |
|
|
| 129 | # <i>rc-update add hald default</i> |
|
|
| 130 | </pre> |
98 | </pre> |
| 131 | |
99 | |
| 132 | <p> |
100 | <p> |
| 133 | You'll also need a graphical terminal so that you can continue working with your |
101 | You'll also need a graphical terminal so that you can continue working with your |
| 134 | new desktop environment. <c>x11-terms/terminal</c> is a good choice, as it's |
102 | new desktop environment. <c>x11-terms/terminal</c> is a good choice, as it's |
| … | |
… | |
| 288 | <title>Useful programs</title> |
256 | <title>Useful programs</title> |
| 289 | <body> |
257 | <body> |
| 290 | |
258 | |
| 291 | <p> |
259 | <p> |
| 292 | We should now <c>emerge</c> some useful applications and utilities: |
260 | We should now <c>emerge</c> some useful applications and utilities: |
| 293 | <c>xfce4-mixer</c>, <c>xfprint</c>, <c>xfce4-taskmanager</c>, |
261 | <c>xfce4-mixer</c>, <c>xfce4-taskmanager</c>, <c>xfwm4-themes</c>, <c>orage</c>, |
| 294 | <c>xfwm4-themes</c>, <c>orage</c>, <c>mousepad</c>, <c>xfce4-power-manager</c>, |
262 | <c>leafpad</c>, <c>xfce4-power-manager</c>, <c>x11-terms/terminal</c>, and |
| 295 | <c>x11-terms/terminal</c>, and <c>thunar</c>. |
263 | <c>thunar</c>. |
| 296 | </p> |
264 | </p> |
| 297 | |
265 | |
| 298 | <p> |
266 | <p> |
| 299 | <c>xfce4-mixer</c> is a volume control for your sound card. It can also be run |
267 | <c>xfce4-mixer</c> is a volume control for your sound card. It can also be run |
| 300 | as a panel applet, giving you fast access to playback volume. <c>xfprint</c> |
268 | as a panel applet, giving you fast access to playback volume. |
| 301 | provides easy printer management and job control; it's a must if you intend to |
269 | <c>xfce4-taskmanager</c> displays a list of all running programs, and the CPU |
| 302 | do any printing from your desktop. <c>xfce4-taskmanager</c> displays a list of |
270 | and memory consumption each one takes up. By right-clicking an item, you can |
| 303 | all running programs, and the CPU and memory consumption each one takes up. By |
271 | kill a misbehaving application, pause and restart it, or even alter its runtime |
| 304 | right-clicking an item, you can kill a misbehaving application, pause and |
272 | priority, which lets you fine-tune how much of a demand it puts on your system's |
| 305 | restart it, or even alter its runtime priority, which lets you fine-tune how |
273 | resources. |
| 306 | much of a demand it puts on your system's resources. |
|
|
| 307 | </p> |
274 | </p> |
| 308 | |
275 | |
| 309 | <p> |
276 | <p> |
| 310 | <c>xfwm4-themes</c> adds several window manager themes. You may want to add a |
277 | <c>xfwm4-themes</c> adds several window manager themes. You may want to add a |
| 311 | more full-coverage icon theme such as <c>tango-icon-theme</c> just to round out |
278 | more full-coverage icon theme such as <c>tango-icon-theme</c> just to round out |
| 312 | your desktop. |
279 | your desktop. |
| 313 | </p> |
280 | </p> |
| 314 | |
281 | |
| 315 | <p> |
282 | <p> |
| 316 | <c>orage</c> is a simple, handy calendar. <c>mousepad</c> is a barebones text |
283 | <c>orage</c> is a simple, handy calendar. <c>leafpad</c> is a barebones text |
| 317 | editor that starts up extremely quickly. |
284 | editor that starts up extremely quickly. |
| 318 | </p> |
285 | </p> |
| 319 | |
286 | |
| 320 | <p> |
287 | <p> |
| 321 | <c>xfce4-power-manager</c> is an application to monitor and manage power usage. |
288 | <c>xfce4-power-manager</c> is an application to monitor and manage power usage. |
| … | |
… | |
| 352 | link="http://www.foo-projects.org/~benny/projects/thunar-archive-plugin">front-end</uri> |
319 | link="http://www.foo-projects.org/~benny/projects/thunar-archive-plugin">front-end</uri> |
| 353 | for graphical archiving applications such as <c>xarchiver</c>, |
320 | for graphical archiving applications such as <c>xarchiver</c>, |
| 354 | <c>squeeze</c>, and <c>file-roller</c>. |
321 | <c>squeeze</c>, and <c>file-roller</c>. |
| 355 | </li> |
322 | </li> |
| 356 | <li> |
323 | <li> |
| 357 | <c>thunar-media-tags-plugin</c> lets you intelligently rename multiple media |
324 | <c>tumbler</c> lets you preview certain types of files from within Thunar, |
| 358 | files at once, and lets you <uri |
325 | such as images and fonts. |
| 359 | link="http://thunar.xfce.org/pwiki/projects/thunar-media-tags-plugin">edit</uri> |
|
|
| 360 | their information tags, such as id3 and ogg tags. |
|
|
| 361 | </li> |
|
|
| 362 | <li> |
|
|
| 363 | <c>thunar-thumbnailers</c> lets you <uri |
|
|
| 364 | link="http://goodies.xfce.org/projects/thunar-plugins/thunar-thumbnailers">preview</uri> |
|
|
| 365 | certain types of files from within Thunar, such as images and fonts. |
|
|
| 366 | </li> |
326 | </li> |
| 367 | <li> |
327 | <li> |
| 368 | <c>thunar-volman</c> automatically <uri |
328 | <c>thunar-volman</c> automatically <uri |
| 369 | link="http://foo-projects.org/~benny/projects/thunar-volman/">manages</uri> |
329 | link="http://foo-projects.org/~benny/projects/thunar-volman/">manages</uri> |
| 370 | removable media and drives. |
330 | removable media and drives. |
| … | |
… | |
| 375 | Next, let's see about adding some useful but lightweight desktop applications, |
335 | Next, let's see about adding some useful but lightweight desktop applications, |
| 376 | in keeping with Xfce's philosophy. |
336 | in keeping with Xfce's philosophy. |
| 377 | </p> |
337 | </p> |
| 378 | |
338 | |
| 379 | <p> |
339 | <p> |
| 380 | Though <c>mousepad</c> is nice enough as a basic text editor, if you need a |
340 | Though <c>leafpad</c> is nice enough as a basic text editor, if you need a |
| 381 | full-featured word processor but don't want the bloat of OpenOffice, try |
341 | full-featured word processor but don't want the bloat of OpenOffice, try |
| 382 | emerging <c>abiword</c>. <uri link="http://www.abisource.com">AbiWord</uri> is |
342 | emerging <c>abiword</c>. <uri link="http://www.abisource.com">AbiWord</uri> is |
| 383 | lighter, faster, and is completely interoperable with industry-standard document |
343 | lighter, faster, and is completely interoperable with industry-standard document |
| 384 | types. It can also be further extended with <c>abiword-plugins</c>. |
344 | types. It can also be further extended with <c>abiword-plugins</c>. |
| 385 | </p> |
345 | </p> |
| … | |
… | |
| 403 | </p> |
363 | </p> |
| 404 | |
364 | |
| 405 | <p> |
365 | <p> |
| 406 | Finally, you'll need a webbrowser. Nearly all graphical webbrowsers require more |
366 | Finally, you'll need a webbrowser. Nearly all graphical webbrowsers require more |
| 407 | resources than most of your other desktop applications. Still, <c>firefox</c> |
367 | resources than most of your other desktop applications. Still, <c>firefox</c> |
| 408 | (or <c>firefox-bin</c>) is always a good choice. Alternatively, you may find |
368 | and <c>midori</c> are always good choices. Alternatively, you may find |
| 409 | <c>opera</c> to be quite fast. However, <c>opera</c> is not available on as many |
369 | <c>opera</c> to be quite fast. However, <c>opera</c> is not available on as many |
| 410 | processor architectures as <c>firefox</c>, and it has more dependencies unless |
370 | processor architectures as <c>firefox</c>, and it has more dependencies unless |
| 411 | you override them with a few USE flags. |
371 | you override them with a few USE flags. |
| 412 | </p> |
372 | </p> |
| 413 | |
373 | |
| 414 | <pre caption="Adding a webbrowser"> |
374 | <pre caption="Adding a webbrowser"> |
| 415 | <comment>(Installing Mozilla Firefox)</comment> |
375 | <comment>(Installing Mozilla Firefox)</comment> |
| 416 | # <i>emerge firefox</i> |
376 | # <i>emerge firefox</i> |
|
|
377 | <comment>(Installing Midori)</comment> |
|
|
378 | # <i>emerge midori</i> |
| 417 | <comment>(Installing Opera)</comment> |
379 | <comment>(Installing Opera)</comment> |
| 418 | # <i>echo "www-client/opera gtk -kde" >> /etc/portage/package.use</i> |
380 | # <i>echo "www-client/opera gtk -kde" >> /etc/portage/package.use</i> |
| 419 | # <i>emerge opera</i> |
381 | # <i>emerge opera</i> |
| 420 | </pre> |
382 | </pre> |
| 421 | |
383 | |