/[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.10 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.10 2007/09/23 03:28:08 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.8</version> 21<version>1.12</version>
25<date>2007-09-22</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
405</pre> 372</pre>
406 373
407<p> 374<p>
408We 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
409appropriate variable. Though there are a few choices available in Portage, for 376appropriate variable. Though there are a few choices available in Portage, for
410this 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
411<c>gdm</c>. 378Simple Login Manager.
412</p>
413
414<p> 379</p>
415<c>xdm</c> is speedy and lightweight, but it isn't pretty, and isn't really 380
416customizable. If you'd like to use it, first <c>emerge</c> it:
417</p> 381<p>
382<c>slim</c> is speedy and lightweight, with minimal dependencies. Perfect for
383Xfce!
384</p>
418 385
419<pre caption="Installing XDM"> 386<pre caption="Installing SLiM">
420# <i>emerge -avt xdm</i> 387# <i>emerge -avt slim</i>
421</pre> 388</pre>
422 389
423<p> 390<p>
424Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>: 391Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>:
425</p> 392</p>
426 393
427<pre caption="Editing /etc/conf.d/xdm"> 394<pre caption="Editing /etc/conf.d/xdm">
428DISPLAYMANAGER="xdm" 395DISPLAYMANAGER="slim"
429</pre> 396</pre>
430 397
431<p>
432<c>xdm</c> can automatically start your Xfce session if you add XSESSION="Xfce4"
433to <path>/etc/rc.conf</path>.
434</p> 398<p>
435 399SLiM can automatically start your Xfce session if you add
400<c>XSESSION="Xfce4"</c> to <path>/etc/rc.conf</path>.
436<p> 401</p>
437While you can choose to stick with (the rather ugly) <c>xdm</c>, why not try
438<c>gdm</c> instead? It's far more configurable, and much, much prettier. First,
439let's <c>emerge</c> it. Note that though it has a few dependencies, they're
440small, and they're not as nearly as numerous as other display managers.
441</p>
442
443<pre caption="Installing GDM">
444# <i>emerge -avt gdm</i>
445</pre>
446
447<p>
448Next, change the DISPLAYMANAGER variable to use <c>gdm</c> instead of
449<c>xdm</c>:
450</p>
451
452<pre caption="Editing /etc/conf.d/xdm">
453DISPLAYMANAGER="gdm"
454</pre>
455 402
456</body> 403</body>
457</section> 404</section>
458<section> 405<section>
459<title>Beautifying your desktop</title> 406<title>Beautifying your desktop</title>
479to 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
480and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>. 427and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>.
481</p> 428</p>
482 429
483<p> 430<p>
484If 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
485available 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
486them, you can either unpack and move them to 433<uri link="http://slim.berlios.de/themes01.php">themes page</uri> for more
487<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
488<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>.
489There are some <uri
490link="http://gnome-look.org/content/show.php?content=45575">very nice</uri>
491Gentoo <uri
492link="http://gnome-look.org/content/show.php?content=20071">themes</uri>
493available.
494</p> 436</p>
495 437
496<p> 438<p>
497Finally, Xfce has its own built-in compositor to manage window transparency. 439Finally, Xfce has its own built-in compositor to manage window transparency.
498This option can be found in Menu --> Settings --> Window Manager. For best 440This option can be found in Menu --> Settings --> Window Manager. For best
519 461
520</body> 462</body>
521</section> 463</section>
522</chapter> 464</chapter>
523 465
524<chapter id="upgrade">
525<title>Upgrading</title>
526<section>
527<title>Upgrading from 4.2 to 4.4</title>
528<body>
529
530<p>
531Upgrading from Xfce 4.2 to 4.4 isn't hard, but neither is it as simple as most
532upgrades. With the release of 4.4, many older packages are either deprecated, or
533their functionality has been included into the desktop in some other manner.
534</p>
535
536<p>
537First, update your Portage tree (<c>emerge --sync</c>), then see what Xfce
538updates are available (<c>emerge -pvtuD world</c>).
539</p>
540
541<p>
542You'll notice that there will be a list of packages that block upgrading, as
543most 4.2 packages cannot coexist with 4.4 packages. Here, the solution is pretty
544straightforward: just unmerge the blocking packages, as described in the <uri
545link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">Portage
546Handbook</uri> and <c>man emerge</c>, then continue with the update.
547</p>
548
549<p>
550Next, you may need to rebuild certain packages, such as applications linked
551against <c>dbus</c>. You'll need to first install <c>gentoolkit</c> for this.
552Then, once <c>gentoolkit</c> is installed, run:
553</p>
554
555<pre caption="Rebuilding packages">
556# <i>revdep-rebuild -p</i>
557<comment>(If you see any output about broken packages, run this next command)</comment>
558# <i>revdep-rebuild</i>
559</pre>
560
561<note>
562For more information, please read <c>man revdep-rebuild</c> and our <uri
563link="/doc/en/gentoolkit.xml">Gentoolkit Guide</uri>.
564</note>
565
566<p>
567Once the rebuild has finished, run <c>revdep-rebuild -p</c> again, just to make
568sure you have a clean and consistent world. If anything still shows up, keep
569repeating <c>revdep-rebuild -p</c> and <c>revdep-rebuild</c> until there's no
570more output about broken packages. Most Xfce update problems stem from
571<c>dbus</c> issues, as Xfce uses <c>dbus</c> quite extensively.
572</p>
573
574<p>
575Next, restart <c>dbus</c> and/or <c>hal</c>.
576</p>
577
578<pre caption="Restarting dbus and hal">
579# <i>/etc/init.d/dbus restart</i>
580# <i>/etc/init.d/hald restart</i>
581</pre>
582
583<p>
584Finally, give yourself a fresh environment.
585</p>
586
587<pre caption="Updating the environment variables">
588# <i>env-update &amp;&amp; source /etc/profile</i>
589</pre>
590
591</body>
592</section>
593<section>
594<title>Settings</title>
595<body>
596
597<p>
598Make sure you familiarize yourself with all the new options available in the new
599Settings Manager. Of interest are the options in the Desktop screen; Xfce can
600now manage your desktop and place icons on it.
601</p>
602
603<p>
604There's also a Window Manager Tweaks screen, in which you can adjust the
605behavior of windows, workspaces, and transparency (if enabled). Xfce 4.4 has
606slightly changed the default behavior of workspaces and active window focus. If
607you find that clicking a hyperlink in one workspace switches your browser to
608that workspace from another one (or similar annoying window focus behavior), try
609Settings --> Window Manager Tweaks --> Focus --> Activate Focus Stealing
610Prevention.
611</p>
612
613<p>
614Be sure to read the <uri link="http://www.xfce.org/documentation/">Xfce
615Documentation</uri> and take the <uri link="http://www.xfce.org/about/tour">Xfce
616Tour</uri> to learn more about 4.4 and how to configure it.
617</p>
618
619</body>
620</section>
621</chapter>
622
623<chapter> 466<chapter>
624<title>Summary</title> 467<title>Summary</title>
625<section> 468<section>
626<body> 469<body>
627 470

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

  ViewVC Help
Powered by ViewVC 1.1.20