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