/[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.4 Revision 1.16
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2
3<!-- $Header $ -->
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.3</version> 21<version>1.12</version>
25<date>2007-03-11</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>
64<section> 56<section>
65<title>The basics</title> 57<title>The basics</title>
66<body> 58<body>
67 59
68<p> 60<p>
69Before we install our fully-functional yet minimal desktop, let's take a moment 61First, make sure you've setup Xorg as shown in the <uri
70to review the basic packages we'll be emerging. 62link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>.
71</p>
72
73<table>
74<tr>
75 <th>Name</th>
76 <th>Description</th>
77</tr>
78<tr>
79 <ti>xfce4</ti>
80 <ti>The base Xfce desktop environment</ti>
81</tr>
82<tr>
83 <ti>xscreensaver</ti>
84 <ti>
85 A screensaver with powersaving features and the ability to lock the screen
86 for security
87 </ti>
88</tr>
89</table>
90
91<p> 63</p>
92You're free to install any other packages you wish, but for now, we'll stick 64
93with these suggestions for a fast, minimal working environment. Double check 65<p>
94your USE flags in <path>/etc/make.conf</path>; you'll probably at least want 66Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll
95<c>USE="dbus -gnome hal startup-notification"</c>. 67probably at least want <c>USE="-gnome -kde -qt3 -qt4 X dbus hal startup-notification xscreensaver"</c>.
96</p> 68</p>
97 69
98<p> 70<p>
99Now, let's install Xfce. 71Now, let's install Xfce.
100</p> 72</p>
101 73
102<pre caption="Installing Xfce"> 74<pre caption="Installing Xfce">
103# <i>emerge -avt xfce4 xscreensaver</i> 75# <i>emerge -avt xfce4</i>
104</pre> 76</pre>
105 77
106<p> 78<p>
107Next, 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>,
108and <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
337# <i>emerge -avt abiword</i> 309# <i>emerge -avt abiword</i>
338</pre> 310</pre>
339 311
340<p> 312<p>
341Need a nice email client/newsreader that isn't as demanding as 313Need a nice email client/newsreader that isn't as demanding as
342<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>.
343<c>sylpheed-claws</c> or <c>claws-mail</c>.
344</p> 315</p>
345 316
346<p> 317<p>
347For 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
348configurable 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
349all-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
350<c>emerge gaim</c>. 321<c>emerge pidgin</c>.
351</p> 322</p>
352 323
353<p> 324<p>
354If 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
355<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,
401</pre> 372</pre>
402 373
403<p> 374<p>
404We 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
405appropriate variable. Though there are a few choices available in Portage, for 376appropriate variable. Though there are a few choices available in Portage, for
406this 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
407<c>gdm</c>. 378Simple Login Manager.
408</p>
409
410<p> 379</p>
411<c>xdm</c> is speedy and lightweight, but it isn't pretty, and isn't really 380
412customizable. If you'd like to use it, first <c>emerge</c> it:
413</p> 381<p>
382<c>slim</c> is speedy and lightweight, with minimal dependencies. Perfect for
383Xfce!
384</p>
414 385
415<pre caption="Installing XDM"> 386<pre caption="Installing SLiM">
416# <i>emerge -avt xdm</i> 387# <i>emerge -avt slim</i>
417</pre> 388</pre>
418 389
419<p> 390<p>
420Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>: 391Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>:
421</p> 392</p>
422 393
423<pre caption="Editing /etc/conf.d/xdm"> 394<pre caption="Editing /etc/conf.d/xdm">
424DISPLAYMANAGER="xdm" 395DISPLAYMANAGER="slim"
425</pre> 396</pre>
426 397
427<p>
428<c>xdm</c> can automatically start your Xfce session if you add XSESSION="Xfce4"
429to <path>/etc/rc.conf</path>.
430</p> 398<p>
431 399SLiM can automatically start your Xfce session if you add
400<c>XSESSION="Xfce4"</c> to <path>/etc/rc.conf</path>.
432<p> 401</p>
433While you can choose to stick with (the rather ugly) <c>xdm</c>, why not try
434<c>gdm</c> instead? It's far more configurable, and much, much prettier. First,
435let's <c>emerge</c> it. Note that though it has a few dependencies, they're
436small, and they're not as nearly as numerous as other display managers.
437</p>
438
439<pre caption="Installing GDM">
440# <i>emerge -avt gdm</i>
441</pre>
442
443<p>
444Next, change the DISPLAYMANAGER variable to use <c>gdm</c> instead of
445<c>xdm</c>:
446</p>
447
448<pre caption="Editing /etc/conf.d/xdm">
449DISPLAYMANAGER="gdm"
450</pre>
451 402
452</body> 403</body>
453</section> 404</section>
454<section> 405<section>
455<title>Beautifying your desktop</title> 406<title>Beautifying your desktop</title>
475to 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
476and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>. 427and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>.
477</p> 428</p>
478 429
479<p> 430<p>
480If 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
481available 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
482them, you can either unpack and move them to 433<uri link="http://slim.berlios.de/themes01.php">themes page</uri> for more
483<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
484<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>.
485There are some <uri
486link="http://gnome-look.org/content/show.php?content=45575">very nice</uri>
487Gentoo <uri
488link="http://gnome-look.org/content/show.php?content=20071">themes</uri>
489available.
490</p> 436</p>
491 437
492<p> 438<p>
493Finally, Xfce has its own built-in compositor to manage window transparency. 439Finally, Xfce has its own built-in compositor to manage window transparency.
494This option can be found in Menu --> Settings --> Window Manager. For best 440This option can be found in Menu --> Settings --> Window Manager. For best
515 461
516</body> 462</body>
517</section> 463</section>
518</chapter> 464</chapter>
519 465
520<chapter id="upgrade">
521<title>Upgrading</title>
522<section>
523<title>Upgrading from 4.2 to 4.4</title>
524<body>
525
526<p>
527Upgrading from Xfce 4.2 to 4.4 isn't hard, but neither is it as simple as most
528upgrades. With the release of 4.4, many older packages are either deprecated, or
529their functionality has been included into the desktop in some other manner.
530</p>
531
532<p>
533First, update your Portage tree (<c>emerge --sync</c>), then see what Xfce
534updates are available (<c>emerge -pvtuD world</c>).
535</p>
536
537<p>
538You'll notice that there will be a list of packages that block upgrading, as
539most 4.2 packages cannot coexist with 4.4 packages. Here, the solution is pretty
540straightforward: just unmerge the blocking packages, as described in the <uri
541link="/doc/en/handbook/handbook-x86.xml?part=2&amp;chap=1">Portage
542Handbook</uri> and <c>man emerge</c>, then continue with the update.
543</p>
544
545<p>
546Next, you may need to rebuild certain packages, such as applications linked
547against <c>dbus</c>. You'll need to first install <c>gentoolkit</c> for this.
548Then, once <c>gentoolkit</c> is installed, run:
549</p>
550
551<pre caption="Rebuilding packages">
552# <i>revdep-rebuild -p</i>
553<comment>(If you see any output about broken packages, run this next command)</comment>
554# <i>revdep-rebuild</i>
555</pre>
556
557<note>
558For more information, please read <c>man revdep-rebuild</c> and our <uri
559link="/doc/en/gentoolkit.xml">Gentoolkit Guide</uri>.
560</note>
561
562<p>
563Once the rebuild has finished, run <c>revdep-rebuild -p</c> again, just to make
564sure you have a clean and consistent world. If anything still shows up, keep
565repeating <c>revdep-rebuild -p</c> and <c>revdep-rebuild</c> until there's no
566more output about broken packages. Most Xfce update problems stem from
567<c>dbus</c> issues, as Xfce uses <c>dbus</c> quite extensively.
568</p>
569
570<p>
571Next, restart <c>dbus</c> and/or <c>hal</c>.
572</p>
573
574<pre caption="Restarting dbus and hal">
575# <i>/etc/init.d/dbus restart</i>
576# <i>/etc/init.d/hald restart</i>
577</pre>
578
579<p>
580Finally, give yourself a fresh environment.
581</p>
582
583<pre caption="Updating the environment variables">
584# <i>env-update &amp;&amp; source /etc/profile</i>
585</pre>
586
587</body>
588</section>
589<section>
590<title>Settings</title>
591<body>
592
593<p>
594Make sure you familiarize yourself with all the new options available in the new
595Settings Manager. Of interest are the options in the Desktop screen; Xfce can
596now manage your desktop and place icons on it.
597</p>
598
599<p>
600There's also a Window Manager Tweaks screen, in which you can adjust the
601behavior of windows, workspaces, and transparency (if enabled).
602</p>
603
604<p>
605Be sure to read the <uri link="http://www.xfce.org/documentation/">Xfce
606Documentation</uri> and take the <uri link="http://www.xfce.org/about/tour">Xfce
607Tour</uri> to learn more about 4.4 and how to configure it.
608</p>
609
610</body>
611</section>
612</chapter>
613
614<chapter> 466<chapter>
615<title>Summary</title> 467<title>Summary</title>
616<section> 468<section>
617<body> 469<body>
618 470
634</p> 486</p>
635 487
636<ul> 488<ul>
637 <li><uri link="http://forums.gentoo.org">The Gentoo forums</uri></li> 489 <li><uri link="http://forums.gentoo.org">The Gentoo forums</uri></li>
638 <li>#xfce on irc.freenode.net</li> 490 <li>#xfce on irc.freenode.net</li>
491 <li>
492 The installed help files and other documentation provided by Xfce:
493 <path>/usr/share/xfce4/doc/C/index.html</path>. Just point your browser at
494 it and start reading. There are even a lot of "hidden" configuration options
495 detailed in the help files.
496 </li>
639 <li><uri link="http://www.xfce.org">Xfce's home page</uri></li> 497 <li><uri link="http://www.xfce.org">Xfce's home page</uri></li>
640</ul> 498</ul>
641 499
642</body> 500</body>
643</section> 501</section>

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

  ViewVC Help
Powered by ViewVC 1.1.20