/[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.32 Revision 1.37
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.32 2010/08/24 07:24:38 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.37 2011/02/14 20:43:47 nightmorph Exp $ -->
4 4
5<guide> 5<guide>
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.27</version> 21<version>5</version>
22<date>2010-08-23</date> 22<date>2011-02-14</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>
46This guide will not only show you how to install and configure a minimal Xfce 46This 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 47environment, but will also explore options to create a full-featured desktop in
48keeping with the Xfce philosophy: light, fast, and modular. 48keeping with the Xfce philosophy: light, fast, and modular.
49</p> 49</p>
50 50
51<p>
52The last part of this guide lists a few commands to run after upgrading to Xfce
534.8, so be sure to follow them if you are upgrading from an older version.
54</p>
55
51</body> 56</body>
52</section> 57</section>
53</chapter> 58</chapter>
54 59
55<chapter> 60<chapter>
63link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>. 68link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>.
64</p> 69</p>
65 70
66<p> 71<p>
67Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll 72Next, double-check your USE flags in <path>/etc/make.conf</path>; you'll
68probably at least want <c>USE="-gnome -kde -minimal -qt4 branding dbus 73probably at least want <c>USE="-gnome -kde -minimal -qt4 dbus jpeg lock session
69hal jpeg lock session startup-notification thunar X"</c>. 74startup-notification thunar udev X"</c>.
70</p>
71
72<p> 75</p>
73There's also another variable you can set in <path>/etc/make.conf</path> called 76
74XFCE_PLUGINS. This variable controls additional Xfce plugins; some for the
75panel, and some for other applications. You can enable all of the plugins by
76adding <c>XFCE_PLUGINS="brightness menu trash</c> to
77<path>/etc/make.conf</path>. Here's a brief summary of the plugins:
78</p> 77<p>
79
80<dl>
81 <dt>brightness</dt>
82 <dd>
83 Lets you add a screen brightness applet to your panel, once you have
84 installed <c>xfce4-power-manager</c>
85 </dd>
86 <dt>menu</dt>
87 <dd>Lets you add a program menu to your panel</dd>
88 <dt>trash</dt>
89 <dd>
90 Adds Trash functionality to <c>thunar</c>, the file manager. The Trash
91 allows you to recover deleted files.
92 </dd>
93</dl>
94
95<p>
96Now that you've set your <c>USE</c> and <c>XFCE_PLUGINS</c> variables in 78Now that you've set your <c>USE</c> variables in
97<path>/etc/make.conf</path>, it's time to install Xfce. 79<path>/etc/make.conf</path>, it's time to install Xfce.
98</p> 80</p>
99 81
100<pre caption="Installing Xfce"> 82<pre caption="Installing Xfce">
101# <i>emerge -avt xfce4-meta</i> 83# <i>emerge -avt xfce4-meta</i>
102</pre> 84</pre>
103 85
104<p> 86<p>
105Next, add your regular user(s) to the <c>plugdev</c>, <c>cdrom</c>, <c>cdrw</c>, 87Next, add your regular user(s) to the <c>plugdev</c>, <c>cdrom</c>, <c>cdrw</c>,
106and <c>usb</c> groups, so that they can take full advantage of <c>hal</c> and be 88and <c>usb</c> groups, so that they can mount and use devices such as cameras,
107able to mount and use devices such as cameras, optical drives, and USB sticks. 89optical drives, and USB sticks.
108</p> 90</p>
109 91
110<pre caption="Adding users to the hardware groups"> 92<pre caption="Adding users to the hardware groups">
111<comment>(Replace username with your actual user)</comment> 93<comment>(Replace username with your actual user)</comment>
112# <i>for x in plugdev cdrom cdrw usb ; do gpasswd -a username $x ; done</i> 94# <i>for x in plugdev cdrom cdrw usb ; do gpasswd -a username $x ; done</i>
116Next, update your environment variables: 98Next, update your environment variables:
117</p> 99</p>
118 100
119<pre caption="Updating environment variables"> 101<pre caption="Updating environment variables">
120# <i>env-update &amp;&amp; source /etc/profile</i> 102# <i>env-update &amp;&amp; source /etc/profile</i>
121</pre>
122
123<p>
124Now start up <c>hald</c> and add it to the default runlevel:
125</p>
126
127<pre caption="Starting hald">
128# <i>/etc/init.d/hald start</i>
129# <i>rc-update add hald default</i>
130</pre> 103</pre>
131 104
132<p> 105<p>
133You'll also need a graphical terminal so that you can continue working with your 106You'll also need a graphical terminal so that you can continue working with your
134new desktop environment. <c>x11-terms/terminal</c> is a good choice, as it's 107new desktop environment. <c>x11-terms/terminal</c> is a good choice, as it's
288<title>Useful programs</title> 261<title>Useful programs</title>
289<body> 262<body>
290 263
291<p> 264<p>
292We should now <c>emerge</c> some useful applications and utilities: 265We should now <c>emerge</c> some useful applications and utilities:
293<c>xfce4-mixer</c>, <c>xfprint</c>, <c>xfce4-taskmanager</c>, 266<c>xfce4-mixer</c>, <c>xfce4-taskmanager</c>, <c>xfwm4-themes</c>, <c>orage</c>,
294<c>xfwm4-themes</c>, <c>orage</c>, <c>mousepad</c>, <c>xfce4-power-manager</c>, 267<c>leafpad</c>, <c>xfce4-power-manager</c>, <c>x11-terms/terminal</c>, and
295<c>x11-terms/terminal</c>, and <c>thunar</c>. 268<c>thunar</c>.
296</p> 269</p>
297 270
298<p> 271<p>
299<c>xfce4-mixer</c> is a volume control for your sound card. It can also be run 272<c>xfce4-mixer</c> is a volume control for your sound card. It can also be run
300as a panel applet, giving you fast access to playback volume. <c>xfprint</c> 273as a panel applet, giving you fast access to playback volume.
301provides easy printer management and job control; it's a must if you intend to 274<c>xfce4-taskmanager</c> displays a list of all running programs, and the CPU
302do any printing from your desktop. <c>xfce4-taskmanager</c> displays a list of 275and memory consumption each one takes up. By right-clicking an item, you can
303all running programs, and the CPU and memory consumption each one takes up. By 276kill a misbehaving application, pause and restart it, or even alter its runtime
304right-clicking an item, you can kill a misbehaving application, pause and 277priority, which lets you fine-tune how much of a demand it puts on your system's
305restart it, or even alter its runtime priority, which lets you fine-tune how 278resources.
306much of a demand it puts on your system's resources.
307</p> 279</p>
308 280
309<p> 281<p>
310<c>xfwm4-themes</c> adds several window manager themes. You may want to add a 282<c>xfwm4-themes</c> adds several window manager themes. You may want to add a
311more full-coverage icon theme such as <c>tango-icon-theme</c> just to round out 283more full-coverage icon theme such as <c>tango-icon-theme</c> just to round out
312your desktop. 284your desktop.
313</p> 285</p>
314 286
315<p> 287<p>
316<c>orage</c> is a simple, handy calendar. <c>mousepad</c> is a barebones text 288<c>orage</c> is a simple, handy calendar. <c>leafpad</c> is a barebones text
317editor that starts up extremely quickly. 289editor that starts up extremely quickly.
318</p> 290</p>
319 291
320<p> 292<p>
321<c>xfce4-power-manager</c> is an application to monitor and manage power usage. 293<c>xfce4-power-manager</c> is an application to monitor and manage power usage.
352 link="http://www.foo-projects.org/~benny/projects/thunar-archive-plugin">front-end</uri> 324 link="http://www.foo-projects.org/~benny/projects/thunar-archive-plugin">front-end</uri>
353 for graphical archiving applications such as <c>xarchiver</c>, 325 for graphical archiving applications such as <c>xarchiver</c>,
354 <c>squeeze</c>, and <c>file-roller</c>. 326 <c>squeeze</c>, and <c>file-roller</c>.
355 </li> 327 </li>
356 <li> 328 <li>
357 <c>thunar-media-tags-plugin</c> lets you intelligently rename multiple media 329 <c>tumbler</c> lets you preview certain types of files from within Thunar,
358 files at once, and lets you <uri 330 such as images and fonts.
359 link="http://thunar.xfce.org/pwiki/projects/thunar-media-tags-plugin">edit</uri>
360 their information tags, such as id3 and ogg tags.
361 </li>
362 <li>
363 <c>thunar-thumbnailers</c> lets you <uri
364 link="http://goodies.xfce.org/projects/thunar-plugins/thunar-thumbnailers">preview</uri>
365 certain types of files from within Thunar, such as images and fonts.
366 </li> 331 </li>
367 <li> 332 <li>
368 <c>thunar-volman</c> automatically <uri 333 <c>thunar-volman</c> automatically <uri
369 link="http://foo-projects.org/~benny/projects/thunar-volman/">manages</uri> 334 link="http://foo-projects.org/~benny/projects/thunar-volman/">manages</uri>
370 removable media and drives. 335 removable media and drives.
375Next, let's see about adding some useful but lightweight desktop applications, 340Next, let's see about adding some useful but lightweight desktop applications,
376in keeping with Xfce's philosophy. 341in keeping with Xfce's philosophy.
377</p> 342</p>
378 343
379<p> 344<p>
380Though <c>mousepad</c> is nice enough as a basic text editor, if you need a 345Though <c>leafpad</c> is nice enough as a basic text editor, if you need a
381full-featured word processor but don't want the bloat of OpenOffice, try 346full-featured word processor but don't want the bloat of OpenOffice, try
382emerging <c>abiword</c>. <uri link="http://www.abisource.com">AbiWord</uri> is 347emerging <c>abiword</c>. <uri link="http://www.abisource.com">AbiWord</uri> is
383lighter, faster, and is completely interoperable with industry-standard document 348lighter, faster, and is completely interoperable with industry-standard document
384types. It can also be further extended with <c>abiword-plugins</c>. 349types.
385</p> 350</p>
386 351
387<p> 352<p>
388Need a nice email client/newsreader that isn't as demanding as 353Need a nice email client/newsreader that isn't as demanding as
389<c>thunderbird</c> or <c>evolution</c>? Try emerging <c>claws-mail</c>. 354<c>thunderbird</c> or <c>evolution</c>? Try emerging <c>claws-mail</c>.
403</p> 368</p>
404 369
405<p> 370<p>
406Finally, you'll need a webbrowser. Nearly all graphical webbrowsers require more 371Finally, you'll need a webbrowser. Nearly all graphical webbrowsers require more
407resources than most of your other desktop applications. Still, <c>firefox</c> 372resources than most of your other desktop applications. Still, <c>firefox</c>
408(or <c>firefox-bin</c>) is always a good choice. Alternatively, you may find 373and <c>midori</c> are always good choices. Alternatively, you may find
409<c>opera</c> to be quite fast. However, <c>opera</c> is not available on as many 374<c>opera</c> to be quite fast. However, <c>opera</c> is not available on as many
410processor architectures as <c>firefox</c>, and it has more dependencies unless 375processor architectures as <c>firefox</c>, and it has more dependencies unless
411you override them with a few USE flags. 376you override them with a few USE flags.
412</p> 377</p>
413 378
414<pre caption="Adding a webbrowser"> 379<pre caption="Adding a webbrowser">
415<comment>(Installing Mozilla Firefox)</comment> 380<comment>(Installing Mozilla Firefox)</comment>
416# <i>emerge firefox</i> 381# <i>emerge firefox</i>
382<comment>(Installing Midori)</comment>
383# <i>emerge midori</i>
417<comment>(Installing Opera)</comment> 384<comment>(Installing Opera)</comment>
418# <i>echo "www-client/opera gtk -kde" >> /etc/portage/package.use</i> 385# <i>echo "www-client/opera gtk -kde" >> /etc/portage/package.use</i>
419# <i>emerge opera</i> 386# <i>emerge opera</i>
420</pre> 387</pre>
421 388
567</p> 534</p>
568 535
569</body> 536</body>
570</section> 537</section>
571<section> 538<section>
539<title>Upgrading Xfce</title>
540<body>
541
542<p>
543If you're upgrading Xfce from an old version to 4.8 or newer, then you will need
544to remove your old cached sessions. For each of your users, run the following
545commands to remove your old incompatible cached sessions:
546</p>
547
548<pre caption="Deleting old sessions from the cache">
549$ <i>rm -r ~/.cache/sessions</i>
550$ <i>rm -r ~/.config/xfce*</i>
551$ <i>rm -r ~/.config/Thunar</i>
552</pre>
553
554</body>
555</section>
556<section>
572<title>Resources</title> 557<title>Resources</title>
573<body> 558<body>
574 559
575<p> 560<p>
576Need additional help on configuring and using Xfce? Need more lightweight 561Need additional help on configuring and using Xfce? Need more lightweight

Legend:
Removed from v.1.32  
changed lines
  Added in v.1.37

  ViewVC Help
Powered by ViewVC 1.1.20