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

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

  ViewVC Help
Powered by ViewVC 1.1.20