/[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.37 Revision 1.43
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.37 2011/02/14 20:43:47 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xfce-config.xml,v 1.43 2012/06/12 09:47:06 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>5</version> 21<version>11</version>
22<date>2011-02-14</date> 22<date>2012-06-12</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>
82<pre caption="Installing Xfce"> 82<pre caption="Installing Xfce">
83# <i>emerge -avt xfce4-meta</i> 83# <i>emerge -avt xfce4-meta</i>
84</pre> 84</pre>
85 85
86<p> 86<p>
87Next, 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>cdrom</c>, <c>cdrw</c>,
88and <c>usb</c> groups, so that they can mount and use devices such as cameras, 88and <c>usb</c> groups, so that they can mount and use devices such as cameras,
89optical drives, and USB sticks. 89optical drives, and USB sticks.
90</p> 90</p>
91 91
92<pre caption="Adding users to the hardware groups"> 92<pre caption="Adding users to the hardware groups">
93<comment>(Replace username with your actual user)</comment> 93<comment>(Replace username with your actual user)</comment>
94# <i>for x in plugdev cdrom cdrw usb ; do gpasswd -a username $x ; done</i> 94# <i>for x in cdrom cdrw usb ; do gpasswd -a username $x ; done</i>
95</pre> 95</pre>
96 96
97<p> 97<p>
98Next, update your environment variables: 98Next, update your environment variables:
99</p> 99</p>
132$ <i>echo "exec startxfce4" > ~/.xinitrc</i> 132$ <i>echo "exec startxfce4" > ~/.xinitrc</i>
133</pre> 133</pre>
134 134
135<note> 135<note>
136If you have ConsoleKit installed, your <path>~/.xinitrc</path> should instead 136If you have ConsoleKit installed, your <path>~/.xinitrc</path> should instead
137contain <c>exec ck-launch-session startxfce4</c>. Otherwise, some of your 137contain <c>exec startxfce4 --with-ck-launch</c>. Otherwise, some of your
138applications may stop working. You'll also need to add consolekit to the 138applications may stop working. You'll also need to add consolekit to the
139default runlevel by running the following command as root: <c>rc-update add 139default runlevel by running the following command as root: <c>rc-update add
140consolekit default</c>. 140consolekit default</c>.
141</note> 141</note>
142 142
150 150
151<p> 151<p>
152Congratulations, and welcome to your new Xfce desktop environment. Go ahead, 152Congratulations, and welcome to your new Xfce desktop environment. Go ahead,
153explore it a bit. Then continue reading to learn how you can configure Xfce to 153explore it a bit. Then continue reading to learn how you can configure Xfce to
154suit your needs. 154suit your needs.
155</p>
156
157</body>
158</section>
159<section>
160<title>Program access</title>
161<body>
162
163<p>
164You might notice right-clicking on the desktop shows you the menu of all your
165applications. It's useful, but your desktop can easily be completely obscured by
166open windows, making it hard to to launch a new program. So, one of the first
167things you may wish to do is give yourself a handy application menu on your
168panel. Right click on this panel, and choose "Add New Item". Scroll through the
169list of choices and select "Xfce Menu". You can choose where you want it to be
170displayed on your panel. When clicked, it displays the application/preferences
171menu, providing a nicely categorized list of your installed programs.
172</p> 155</p>
173 156
174</body> 157</body>
175</section> 158</section>
176<section> 159<section>
245 <li> 228 <li>
246 <c>xfce4-sensors-plugin</c> lets you monitor your hardware sensors, such as 229 <c>xfce4-sensors-plugin</c> lets you monitor your hardware sensors, such as
247 CPU temperature, fan RPM, hard drive temp, motherboard voltage, and more 230 CPU temperature, fan RPM, hard drive temp, motherboard voltage, and more
248 </li> 231 </li>
249</ul> 232</ul>
250
251<p>
252If you can't find what you're looking for in the plugins specifically made for
253Xfce, try searching through the list of Gnome panel applets! That's right, by
254first emerging <c>xfce4-xfapplet-plugin</c>, you can install and run any applet
255made for Gnome.
256</p>
257 233
258</body> 234</body>
259</section> 235</section>
260<section> 236<section>
261<title>Useful programs</title> 237<title>Useful programs</title>
319 295
320<ul> 296<ul>
321 <li> 297 <li>
322 <c>thunar-archive-plugin</c> lets you create and extract archive files using 298 <c>thunar-archive-plugin</c> lets you create and extract archive files using
323 the right-click menu. It provides a handy <uri 299 the right-click menu. It provides a handy <uri
324 link="http://www.foo-projects.org/~benny/projects/thunar-archive-plugin">front-end</uri> 300 link="http://goodies.xfce.org/projects/thunar-plugins/thunar-archive-plugin">front-end</uri>
325 for graphical archiving applications such as <c>xarchiver</c>, 301 for graphical archiving applications such as <c>xarchiver</c> and
326 <c>squeeze</c>, and <c>file-roller</c>. 302 <c>file-roller</c>.
327 </li> 303 </li>
328 <li> 304 <li>
329 <c>tumbler</c> lets you preview certain types of files from within Thunar, 305 <c>tumbler</c> lets you preview certain types of files from within Thunar,
330 such as images and fonts. 306 such as images and fonts.
331 </li> 307 </li>
332 <li> 308 <li>
333 <c>thunar-volman</c> automatically <uri 309 <c>thunar-volman</c> automatically <uri
334 link="http://foo-projects.org/~benny/projects/thunar-volman/">manages</uri> 310 link="http://goodies.xfce.org/projects/thunar-plugins/thunar-volman">manages</uri>
335 removable media and drives. 311 removable media and drives.
336 </li> 312 </li>
337</ul> 313</ul>
338 314
339<p> 315<p>
538<section> 514<section>
539<title>Upgrading Xfce</title> 515<title>Upgrading Xfce</title>
540<body> 516<body>
541 517
542<p> 518<p>
543If you're upgrading Xfce from an old version to 4.8 or newer, then you will need 519If you're upgrading Xfce from a pre-4.8 version to 4.8 or newer, then you will
544to remove your old cached sessions. For each of your users, run the following 520need to remove your old cached sessions and profiles as they are incompatible
521with the 4.8 release (and later releases). For each of your users, run the
545commands to remove your old incompatible cached sessions: 522following commands to remove your old incompatible cached sessions and profile:
546</p> 523</p>
547 524
548<pre caption="Deleting old sessions from the cache"> 525<pre caption="Deleting old sessions from the cache">
549$ <i>rm -r ~/.cache/sessions</i> 526$ <i>rm -r ~/.cache/sessions</i>
550$ <i>rm -r ~/.config/xfce*</i> 527$ <i>rm -r ~/.config/xfce*</i>
551$ <i>rm -r ~/.config/Thunar</i> 528$ <i>rm -r ~/.config/Thunar</i>
552</pre> 529</pre>
553 530
531<p>
532Users will be greeted with a new and shiny interface, but will lose many of
533their individual settings. Sadly, no migration of configuration(s) exist that we
534know of.
535</p>
536
554</body> 537</body>
555</section> 538</section>
556<section> 539<section>
557<title>Resources</title> 540<title>Resources</title>
558<body> 541<body>

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

  ViewVC Help
Powered by ViewVC 1.1.20