| 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.13 2007/10/18 18:32:44 nightmorph Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.16 2008/02/24 08:36:44 nightmorph Exp $ --> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/xfce-config.xml"> |
5 | <guide link="/doc/en/xfce-config.xml"> |
| 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.9</version> |
21 | <version>1.12</version> |
| 22 | <date>2007-10-03</date> |
22 | <date>2008-02-24</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> |
| … | |
… | |
| 45 | This guide will not only show you how to install and configure a minimal Xfce |
45 | This guide will not only show you how to install and configure a minimal Xfce |
| 46 | environment, but will also explore options to create a full-featured desktop in |
46 | environment, but will also explore options to create a full-featured desktop in |
| 47 | keeping with the Xfce philosophy: light, fast, and modular. |
47 | keeping with the Xfce philosophy: light, fast, and modular. |
| 48 | </p> |
48 | </p> |
| 49 | |
49 | |
| 50 | <p> |
|
|
| 51 | Additionally, this guide will show you how to <uri link="#upgrade">upgrade</uri> |
|
|
| 52 | from version 4.2 to 4.4. |
|
|
| 53 | </p> |
|
|
| 54 | |
|
|
| 55 | </body> |
50 | </body> |
| 56 | </section> |
51 | </section> |
| 57 | </chapter> |
52 | </chapter> |
| 58 | |
53 | |
| 59 | <chapter> |
54 | <chapter> |
| … | |
… | |
| 67 | link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>. |
62 | link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>. |
| 68 | </p> |
63 | </p> |
| 69 | |
64 | |
| 70 | <p> |
65 | <p> |
| 71 | Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll |
66 | Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll |
| 72 | probably at least want <c>USE="dbus -gnome hal startup-notification |
67 | probably at least want <c>USE="-gnome -kde -qt3 -qt4 X dbus hal startup-notification xscreensaver"</c>. |
| 73 | xscreensaver"</c>. |
|
|
| 74 | </p> |
68 | </p> |
| 75 | |
69 | |
| 76 | <p> |
70 | <p> |
| 77 | Now, let's install Xfce. |
71 | Now, let's install Xfce. |
| 78 | </p> |
72 | </p> |
| … | |
… | |
| 378 | </pre> |
372 | </pre> |
| 379 | |
373 | |
| 380 | <p> |
374 | <p> |
| 381 | We aren't quite finished yet. We have to pick a display manager and set the |
375 | We aren't quite finished yet. We have to pick a display manager and set the |
| 382 | appropriate variable. Though there are a few choices available in Portage, for |
376 | appropriate variable. Though there are a few choices available in Portage, for |
| 383 | this guide, we'll stick with two display manager options: <c>xdm</c> and |
377 | this guide, we'll stick with <uri link="http://slim.berlios.de">SLiM</uri>, the |
| 384 | <c>gdm</c>. |
378 | Simple Login Manager. |
| 385 | </p> |
|
|
| 386 | |
|
|
| 387 | <p> |
379 | </p> |
| 388 | <c>xdm</c> is speedy and lightweight, but it isn't pretty, and isn't really |
380 | |
| 389 | customizable. If you'd like to use it, first <c>emerge</c> it: |
|
|
| 390 | </p> |
381 | <p> |
|
|
382 | <c>slim</c> is speedy and lightweight, with minimal dependencies. Perfect for |
|
|
383 | Xfce! |
|
|
384 | </p> |
| 391 | |
385 | |
| 392 | <pre caption="Installing XDM"> |
386 | <pre caption="Installing SLiM"> |
| 393 | # <i>emerge -avt xdm</i> |
387 | # <i>emerge -avt slim</i> |
| 394 | </pre> |
388 | </pre> |
| 395 | |
389 | |
| 396 | <p> |
390 | <p> |
| 397 | Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>: |
391 | Then edit the DISPLAYMANAGER variable in <path>/etc/conf.d/xdm</path>: |
| 398 | </p> |
392 | </p> |
| 399 | |
393 | |
| 400 | <pre caption="Editing /etc/conf.d/xdm"> |
394 | <pre caption="Editing /etc/conf.d/xdm"> |
| 401 | DISPLAYMANAGER="xdm" |
395 | DISPLAYMANAGER="slim" |
| 402 | </pre> |
396 | </pre> |
| 403 | |
397 | |
| 404 | <p> |
|
|
| 405 | <c>xdm</c> can automatically start your Xfce session if you add XSESSION="Xfce4" |
|
|
| 406 | to <path>/etc/rc.conf</path>. |
|
|
| 407 | </p> |
398 | <p> |
| 408 | |
399 | SLiM can automatically start your Xfce session if you add |
|
|
400 | <c>XSESSION="Xfce4"</c> to <path>/etc/rc.conf</path>. |
| 409 | <p> |
401 | </p> |
| 410 | While you can choose to stick with (the rather ugly) <c>xdm</c>, why not try |
|
|
| 411 | <c>gdm</c> instead? It's far more configurable, and much, much prettier. First, |
|
|
| 412 | let's <c>emerge</c> it. Note that though it has a few dependencies, they're |
|
|
| 413 | small, and they're not as nearly as numerous as other display managers. |
|
|
| 414 | </p> |
|
|
| 415 | |
|
|
| 416 | <pre caption="Installing GDM"> |
|
|
| 417 | # <i>emerge -avt gdm</i> |
|
|
| 418 | </pre> |
|
|
| 419 | |
|
|
| 420 | <p> |
|
|
| 421 | Next, change the DISPLAYMANAGER variable to use <c>gdm</c> instead of |
|
|
| 422 | <c>xdm</c>: |
|
|
| 423 | </p> |
|
|
| 424 | |
|
|
| 425 | <pre caption="Editing /etc/conf.d/xdm"> |
|
|
| 426 | DISPLAYMANAGER="gdm" |
|
|
| 427 | </pre> |
|
|
| 428 | |
402 | |
| 429 | </body> |
403 | </body> |
| 430 | </section> |
404 | </section> |
| 431 | <section> |
405 | <section> |
| 432 | <title>Beautifying your desktop</title> |
406 | <title>Beautifying your desktop</title> |
| … | |
… | |
| 452 | to be able to access themes and icon sets. Individual users can install themes |
426 | to be able to access themes and icon sets. Individual users can install themes |
| 453 | and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>. |
427 | and icon sets to <path>~/.themes/</path> and <path>~/.icons/</path>. |
| 454 | </p> |
428 | </p> |
| 455 | |
429 | |
| 456 | <p> |
430 | <p> |
| 457 | If you installed GDM as your display manager, take a look at the many GDM themes |
431 | If you installed SLiM as your display manager, there are lots of themes in the |
| 458 | available 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 |
| 459 | them, you can either unpack and move them to |
433 | <uri link="http://slim.berlios.de/themes01.php">themes page</uri> for more |
| 460 | <path>/usr/share/gdm/themes/</path> on the command line, or you can run |
434 | themes. Creating your own SLiM theme is fairly easy; just read the <uri |
| 461 | <c>gdmsetup</c> as <b>root</b> and drag'n'drop the archive into the GDM window. |
435 | link="http://slim.berlios.de/themes_howto.php">Themes HowTo</uri>. |
| 462 | There are some <uri |
|
|
| 463 | link="http://gnome-look.org/content/show.php?content=45575">very nice</uri> |
|
|
| 464 | Gentoo <uri |
|
|
| 465 | link="http://gnome-look.org/content/show.php?content=20071">themes</uri> |
|
|
| 466 | available. |
|
|
| 467 | </p> |
436 | </p> |
| 468 | |
437 | |
| 469 | <p> |
438 | <p> |
| 470 | Finally, Xfce has its own built-in compositor to manage window transparency. |
439 | Finally, Xfce has its own built-in compositor to manage window transparency. |
| 471 | This option can be found in Menu --> Settings --> Window Manager. For best |
440 | This option can be found in Menu --> Settings --> Window Manager. For best |
| … | |
… | |
| 492 | |
461 | |
| 493 | </body> |
462 | </body> |
| 494 | </section> |
463 | </section> |
| 495 | </chapter> |
464 | </chapter> |
| 496 | |
465 | |
| 497 | <chapter id="upgrade"> |
|
|
| 498 | <title>Upgrading</title> |
|
|
| 499 | <section> |
|
|
| 500 | <title>Upgrading from 4.2 to 4.4</title> |
|
|
| 501 | <body> |
|
|
| 502 | |
|
|
| 503 | <p> |
|
|
| 504 | Upgrading from Xfce 4.2 to 4.4 isn't hard, but neither is it as simple as most |
|
|
| 505 | upgrades. With the release of 4.4, many older packages are either deprecated, or |
|
|
| 506 | their functionality has been included into the desktop in some other manner. |
|
|
| 507 | </p> |
|
|
| 508 | |
|
|
| 509 | <p> |
|
|
| 510 | First, update your Portage tree (<c>emerge --sync</c>), then see what Xfce |
|
|
| 511 | updates are available (<c>emerge -pvtuD world</c>). |
|
|
| 512 | </p> |
|
|
| 513 | |
|
|
| 514 | <p> |
|
|
| 515 | You'll notice that there will be a list of packages that block upgrading, as |
|
|
| 516 | most 4.2 packages cannot coexist with 4.4 packages. Here, the solution is pretty |
|
|
| 517 | straightforward: just unmerge the blocking packages, as described in the <uri |
|
|
| 518 | link="/doc/en/handbook/handbook-x86.xml?part=2&chap=1">Portage |
|
|
| 519 | Handbook</uri> and <c>man emerge</c>, then continue with the update. |
|
|
| 520 | </p> |
|
|
| 521 | |
|
|
| 522 | <p> |
|
|
| 523 | Next, you may need to rebuild certain packages, such as applications linked |
|
|
| 524 | against <c>dbus</c>. You'll need to first install <c>gentoolkit</c> for this. |
|
|
| 525 | Then, once <c>gentoolkit</c> is installed, run: |
|
|
| 526 | </p> |
|
|
| 527 | |
|
|
| 528 | <pre caption="Rebuilding packages"> |
|
|
| 529 | # <i>revdep-rebuild -p</i> |
|
|
| 530 | <comment>(If you see any output about broken packages, run this next command)</comment> |
|
|
| 531 | # <i>revdep-rebuild</i> |
|
|
| 532 | </pre> |
|
|
| 533 | |
|
|
| 534 | <note> |
|
|
| 535 | For more information, please read <c>man revdep-rebuild</c> and our <uri |
|
|
| 536 | link="/doc/en/gentoolkit.xml">Gentoolkit Guide</uri>. |
|
|
| 537 | </note> |
|
|
| 538 | |
|
|
| 539 | <p> |
|
|
| 540 | Once the rebuild has finished, run <c>revdep-rebuild -p</c> again, just to make |
|
|
| 541 | sure you have a clean and consistent world. If anything still shows up, keep |
|
|
| 542 | repeating <c>revdep-rebuild -p</c> and <c>revdep-rebuild</c> until there's no |
|
|
| 543 | more output about broken packages. Most Xfce update problems stem from |
|
|
| 544 | <c>dbus</c> issues, as Xfce uses <c>dbus</c> quite extensively. |
|
|
| 545 | </p> |
|
|
| 546 | |
|
|
| 547 | <p> |
|
|
| 548 | Next, restart <c>dbus</c> and/or <c>hal</c>. |
|
|
| 549 | </p> |
|
|
| 550 | |
|
|
| 551 | <pre caption="Restarting dbus and hal"> |
|
|
| 552 | # <i>/etc/init.d/dbus restart</i> |
|
|
| 553 | # <i>/etc/init.d/hald restart</i> |
|
|
| 554 | </pre> |
|
|
| 555 | |
|
|
| 556 | <p> |
|
|
| 557 | Finally, give yourself a fresh environment. |
|
|
| 558 | </p> |
|
|
| 559 | |
|
|
| 560 | <pre caption="Updating the environment variables"> |
|
|
| 561 | # <i>env-update && source /etc/profile</i> |
|
|
| 562 | </pre> |
|
|
| 563 | |
|
|
| 564 | </body> |
|
|
| 565 | </section> |
|
|
| 566 | <section> |
|
|
| 567 | <title>Settings</title> |
|
|
| 568 | <body> |
|
|
| 569 | |
|
|
| 570 | <p> |
|
|
| 571 | Make sure you familiarize yourself with all the new options available in the new |
|
|
| 572 | Settings Manager. Of interest are the options in the Desktop screen; Xfce can |
|
|
| 573 | now manage your desktop and place icons on it. |
|
|
| 574 | </p> |
|
|
| 575 | |
|
|
| 576 | <p> |
|
|
| 577 | There's also a Window Manager Tweaks screen, in which you can adjust the |
|
|
| 578 | behavior of windows, workspaces, and transparency (if enabled). Xfce 4.4 has |
|
|
| 579 | slightly changed the default behavior of workspaces and active window focus. If |
|
|
| 580 | you find that clicking a hyperlink in one workspace switches your browser to |
|
|
| 581 | that workspace from another one (or similar annoying window focus behavior), try |
|
|
| 582 | Settings --> Window Manager Tweaks --> Focus --> Activate Focus Stealing |
|
|
| 583 | Prevention. |
|
|
| 584 | </p> |
|
|
| 585 | |
|
|
| 586 | <p> |
|
|
| 587 | Be sure to read the <uri link="http://www.xfce.org/documentation/">Xfce |
|
|
| 588 | Documentation</uri> and take the <uri link="http://www.xfce.org/about/tour">Xfce |
|
|
| 589 | Tour</uri> to learn more about 4.4 and how to configure it. |
|
|
| 590 | </p> |
|
|
| 591 | |
|
|
| 592 | </body> |
|
|
| 593 | </section> |
|
|
| 594 | </chapter> |
|
|
| 595 | |
|
|
| 596 | <chapter> |
466 | <chapter> |
| 597 | <title>Summary</title> |
467 | <title>Summary</title> |
| 598 | <section> |
468 | <section> |
| 599 | <body> |
469 | <body> |
| 600 | |
470 | |