/[gentoo]/xml/htdocs/doc/en/xfce-config.xml
Gentoo

Diff of /xml/htdocs/doc/en/xfce-config.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.8 Revision 1.16
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.8 2007/07/21 18:27:42 nightmorph Exp $ -->
4
5<!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.16 2008/02/24 08:36:44 nightmorph Exp $ -->
6 4
7<guide link="/doc/en/xfce-config.xml"> 5<guide link="/doc/en/xfce-config.xml">
8
9<title>The Xfce Configuration Guide</title> 6<title>The Xfce Configuration Guide</title>
10 7
11<author title="Author"> 8<author title="Author">
12 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> 9 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
13</author> 10</author>
19 16
20<!-- 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 -->
21<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 18<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
22<license/> 19<license/>
23 20
24<version>1.6</version> 21<version>1.12</version>
25<date>2007-07-21</date> 22<date>2008-02-24</date>
26 23
27<chapter> 24<chapter>
28<title>Introduction</title> 25<title>Introduction</title>
29<section> 26<section>
30<title>The Xfce desktop environment</title> 27<title>The Xfce desktop environment</title>
48This guide will not only show you how to install and configure a minimal Xfce 45This guide will not only show you how to install and configure a minimal Xfce
49environment, but will also explore options to create a full-featured desktop in 46environment, but will also explore options to create a full-featured desktop in
50keeping with the Xfce philosophy: light, fast, and modular. 47keeping with the Xfce philosophy: light, fast, and modular.
51</p> 48</p>
52 49
53<p>
54Additionally, this guide will show you how to <uri link="#upgrade">upgrade</uri>
55from version 4.2 to 4.4.
56</p>
57
58</body> 50</body>
59</section> 51</section>
60</chapter> 52</chapter>
61 53
62<chapter> 54<chapter>
69First, make sure you've setup Xorg as shown in the <uri 61First, make sure you've setup Xorg as shown in the <uri
70link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>. 62link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>.
71</p> 63</p>
72 64
73<p> 65<p>
74Before we install our fully-functional yet minimal desktop, let's take a moment 66Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll
75to review the basic packages we'll be emerging. 67probably at least want <c>USE="-gnome -kde -qt3 -qt4 X dbus hal startup-notification xscreensaver"</c>.
76</p>
77
78<table>
79<tr>
80 <th>Name</th>
81 <th>Description</th>
82</tr>
83<tr>
84 <ti>xfce4</ti>
85 <ti>The base Xfce desktop environment</ti>
86</tr>
87<tr>
88 <ti>xscreensaver</ti>
89 <ti>
90 A screensaver with powersaving features and the ability to lock the screen
91 for security
92 </ti>
93</tr>
94</table>
95
96<p>
97You're free to install any other packages you wish, but for now, we'll stick
98with these suggestions for a fast, minimal working environment. Double check
99your USE flags in <path>/etc/make.conf</path>; you'll probably at least want
100<c>USE="dbus -gnome hal startup-notification"</c>.
101</p> 68</p>
102 69
103<p> 70<p>
104Now, let's install Xfce. 71Now, let's install Xfce.
105</p> 72</p>
106 73
107<pre caption="Installing Xfce"> 74<pre caption="Installing Xfce">
108# <i>emerge -avt xfce4 xscreensaver</i> 75# <i>emerge -avt xfce4</i>
109</pre> 76</pre>
110 77
111<p> 78<p>
112Next, add your regular user(s) to the <c>plugdev</c>, <c>cdrom</c>, <c>cdrw</c>, 79Next, add your regular user(s) to the <c>plugdev</c>, <c>cdrom</c>, <c>cdrw</c>,
113and <c>usb</c> groups, so that they can take full advantage of <c>hal</c> and be 80and <c>usb</c> groups, so that they can take full advantage of <c>hal</c> and be
342# <i>emerge -avt abiword</i> 309# <i>emerge -avt abiword</i>
343</pre> 310</pre>
344 311
345<p> 312<p>
346Need a nice email client/newsreader that isn't as demanding as 313Need a nice email client/newsreader that isn't as demanding as
347<c>mozilla-thunderbird</c> or <c>evolution</c>? Try emerging 314<c>mozilla-thunderbird</c> or <c>evolution</c>? Try emerging <c>claws-mail</c>.
348<c>sylpheed-claws</c> or <c>claws-mail</c>.
349</p> 315</p>
350 316
351<p> 317<p>
352For your internet chat needs, <c>irssi</c> is an excellent, tiny, incredibly 318For your internet chat needs, <c>irssi</c> is an excellent, tiny, incredibly
353configurable IRC client that runs in your terminal. If you prefer a compact 319configurable IRC client that runs in your terminal. If you prefer a compact
354all-in-one client that handles nearly all chat protocols, you may want to 320all-in-one client that handles nearly all chat protocols, you may want to
355<c>emerge gaim</c>. 321<c>emerge pidgin</c>.
356</p> 322</p>
357 323
358<p> 324<p>
359If you need movie and music players, look no further than <c>mplayer</c> and 325If you need movie and music players, look no further than <c>mplayer</c> and
360<c>audacious</c>. They can play most every media format available quite nicely, 326<c>audacious</c>. They can play most every media format available quite nicely,
406</pre> 372</pre>
407 373
408<p> 374<p>
409We aren't quite finished yet. We have to pick a display manager and set the 375We aren't quite finished yet. We have to pick a display manager and set the
410appropriate variable. Though there are a few choices available in Portage, for 376appropriate variable. Though there are a few choices available in Portage, for
411this guide, we'll stick with two display manager options: <c>xdm</c> and 377this guide, we'll stick with <uri link="http://slim.berlios.de">SLiM</uri>, the
412<c>gdm</c>. 378Simple Login Manager.
413</p>
414
415<p> 379</p>
416<c>xdm</c> is speedy and lightweight, but it isn't pretty, and isn't really 380
417customizable. If you'd like to use it, first <c>emerge</c> it:
418</p> 381<p>
382<c>slim</c> is speedy and lightweight, with minimal dependencies. Perfect for
383Xfce!
384</p>
419 385
420<pre caption="Installing XDM"> 386<pre caption="Installing SLiM">
421# <i>emerge -avt xdm</i> 387# <i>emerge -avt slim</i>
422</pre> 388</pre>
423 389
424<p> 390<p>
425Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>: 391Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>:
426</p> 392</p>
427 393
428<pre caption="Editing /etc/conf.d/xdm"> 394<pre caption="Editing /etc/conf.d/xdm">
429DISPLAYMANAGER="xdm" 395DISPLAYMANAGER="slim"
430</pre> 396</pre>
431 397
432<p>
433<c>xdm</c> can automatically start your Xfce session if you add XSESSION="Xfce4"
434to <path>/etc/rc.conf</path>.
435</p> 398<p>
436 399SLiM can automatically start your Xfce session if you add
400<c>XSESSION="Xfce4"</c> to <path>/etc/rc.conf</path>.
437<p> 401</p>
438While you can choose to stick with (the rather ugly) <c>xdm</c>, why not try
439<c>gdm</c> instead? It's far more configurable, and much, much prettier. First,
440let's <c>emerge</c> it. Note that though it has a few dependencies, they're
441small, and they're not as nearly as numerous as other display managers.
442</p>
443
444<pre caption="Installing GDM">
445# <i>emerge -avt gdm</i>
446</pre>
447
448<p>
449Next, change the DISPLAYMANAGER variable to use <c>gdm</c> instead of
450<c>xdm</c>:
451</p>
452
453<pre caption="Editing /etc/conf.d/xdm">
454DISPLAYMANAGER="gdm"
455</pre>
456 402
457</body> 403</body>
458</section> 404</section>
459<section> 405<section>
460<title>Beautifying your desktop</title> 406<title>Beautifying your desktop</title>
480to be able to access themes and icon sets. Individual users can install themes 426to be able to access themes and icon sets. Individual users can install themes
481and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>. 427and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>.
482</p> 428</p>
483 429
484<p> 430<p>
485If you installed GDM as your display manager, take a look at the many GDM themes 431If you installed SLiM as your display manager, there are lots of themes in the
486available on <uri link="http://www.gnome-look.org">Gnome-Look</uri>. To install 432<c>slim-themes</c> package available in Portage. Also, be sure to check the SLiM
487them, you can either unpack and move them to 433<uri link="http://slim.berlios.de/themes01.php">themes page</uri> for more
488<path>/usr/share/gdm/themes/</path> on the command line, or you can run 434themes. Creating your own SLiM theme is fairly easy; just read the <uri
489<c>gdmsetup</c> as <b>root</b> and drag'n'drop the archive into the GDM window. 435link="http://slim.berlios.de/themes_howto.php">Themes HowTo</uri>.
490There are some <uri
491link="http://gnome-look.org/content/show.php?content=45575">very nice</uri>
492Gentoo <uri
493link="http://gnome-look.org/content/show.php?content=20071">themes</uri>
494available.
495</p> 436</p>
496 437
497<p> 438<p>
498Finally, Xfce has its own built-in compositor to manage window transparency. 439Finally, Xfce has its own built-in compositor to manage window transparency.
499This option can be found in Menu --> Settings --> Window Manager. For best 440This option can be found in Menu --> Settings --> Window Manager. For best
520 461
521</body> 462</body>
522</section> 463</section>
523</chapter> 464</chapter>
524 465
525<chapter id="upgrade">
526<title>Upgrading</title>
527<section>
528<title>Upgrading from 4.2 to 4.4</title>
529<body>
530
531<p>
532Upgrading from Xfce 4.2 to 4.4 isn't hard, but neither is it as simple as most
533upgrades. With the release of 4.4, many older packages are either deprecated, or
534their functionality has been included into the desktop in some other manner.
535</p>
536
537<p>
538First, update your Portage tree (<c>emerge --sync</c>), then see what Xfce
539updates are available (<c>emerge -pvtuD world</c>).
540</p>
541
542<p>
543You'll notice that there will be a list of packages that block upgrading, as
544most 4.2 packages cannot coexist with 4.4 packages. Here, the solution is pretty
545straightforward: just unmerge the blocking packages, as described in the <uri
546link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">Portage
547Handbook</uri> and <c>man emerge</c>, then continue with the update.
548</p>
549
550<p>
551Next, you may need to rebuild certain packages, such as applications linked
552against <c>dbus</c>. You'll need to first install <c>gentoolkit</c> for this.
553Then, once <c>gentoolkit</c> is installed, run:
554</p>
555
556<pre caption="Rebuilding packages">
557# <i>revdep-rebuild -p</i>
558<comment>(If you see any output about broken packages, run this next command)</comment>
559# <i>revdep-rebuild</i>
560</pre>
561
562<note>
563For more information, please read <c>man revdep-rebuild</c> and our <uri
564link="/doc/en/gentoolkit.xml">Gentoolkit Guide</uri>.
565</note>
566
567<p>
568Once the rebuild has finished, run <c>revdep-rebuild -p</c> again, just to make
569sure you have a clean and consistent world. If anything still shows up, keep
570repeating <c>revdep-rebuild -p</c> and <c>revdep-rebuild</c> until there's no
571more output about broken packages. Most Xfce update problems stem from
572<c>dbus</c> issues, as Xfce uses <c>dbus</c> quite extensively.
573</p>
574
575<p>
576Next, restart <c>dbus</c> and/or <c>hal</c>.
577</p>
578
579<pre caption="Restarting dbus and hal">
580# <i>/etc/init.d/dbus restart</i>
581# <i>/etc/init.d/hald restart</i>
582</pre>
583
584<p>
585Finally, give yourself a fresh environment.
586</p>
587
588<pre caption="Updating the environment variables">
589# <i>env-update &amp;&amp; source /etc/profile</i>
590</pre>
591
592</body>
593</section>
594<section>
595<title>Settings</title>
596<body>
597
598<p>
599Make sure you familiarize yourself with all the new options available in the new
600Settings Manager. Of interest are the options in the Desktop screen; Xfce can
601now manage your desktop and place icons on it.
602</p>
603
604<p>
605There's also a Window Manager Tweaks screen, in which you can adjust the
606behavior of windows, workspaces, and transparency (if enabled). Xfce 4.4 has
607slightly changed the default behavior of workspaces and active window focus. If
608you find that clicking a hyperlink in one workspace switches your browser to
609that workspace from another one (or similar annoying window focus behavior), try
610Settings --> Window Manager Tweaks --> Focus --> Activate Focus Stealing
611Prevention.
612</p>
613
614<p>
615Be sure to read the <uri link="http://www.xfce.org/documentation/">Xfce
616Documentation</uri> and take the <uri link="http://www.xfce.org/about/tour">Xfce
617Tour</uri> to learn more about 4.4 and how to configure it.
618</p>
619
620</body>
621</section>
622</chapter>
623
624<chapter> 466<chapter>
625<title>Summary</title> 467<title>Summary</title>
626<section> 468<section>
627<body> 469<body>
628 470

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.16

  ViewVC Help
Powered by ViewVC 1.1.20