/[gentoo]/xml/htdocs/doc/en/gnome-config.xml
Gentoo

Diff of /xml/htdocs/doc/en/gnome-config.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.3 Revision 1.37
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.3 2005/02/14 00:36:50 dertobi123 Exp $ -->
4
5<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.37 2012/12/09 20:04:22 swift Exp $ -->
6 4
7<guide link="/doc/en/gnome-config.xml"> 5<guide>
8
9<title>The GNOME Configuration HOWTO</title> 6<title>The GNOME Configuration HOWTO</title>
10 7
11<author title="Author"> 8<author title="Author">
12 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 9 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13</author> 10</author>
14<author title="Editor"> 11<author title="Editor">
15 <mail link="lars@strojny.net">Lars Strojny</mail> 12 <mail link="lars@strojny.net">Lars Strojny</mail>
16</author> 13</author>
14<author title="Editor">
15 <mail link="nightmorph"/>
16</author>
17 17
18<abstract> 18<abstract>
19A frequently used environment is GNOME. This HOWTO tries to describe 19A frequently used environment is GNOME. This HOWTO tries to describe
20all aspects of GNOME, including installation, configuration, usage, ... 20all aspects of GNOME, including installation, configuration, usage, ...
21</abstract> 21</abstract>
22 22
23<!-- The content of this document is licensed under the CC-BY-SA license --> 23<!-- The content of this document is licensed under the CC-BY-SA license -->
24<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 24<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25<license/> 25<license/>
26 26
27<version>1.3</version> 27<version>6</version>
28<date>2005-02-14</date> 28<date>2012-12-09</date>
29 29
30<chapter> 30<chapter>
31<title>What is GNOME?</title> 31<title>What is GNOME?</title>
32<section> 32<section>
33<title>The Project</title> 33<title>The Project</title>
34<body> 34<body>
35 35
36<p> 36<p>
37The <uri link="http://www.gnome.org">GNOME</uri> project is a free software 37The <uri link="http://www.gnome.org">GNOME</uri> project is a free software
38project dedicated to the development of GNOME, a Unix/Linux desktop suite and 38project dedicated to the development of GNOME, a Unix/Linux desktop suite and
39development platform. The <uri link="http://foundation.gnome.org">GNOME 39development platform. The <uri link="http://foundation.gnome.org">GNOME
40Foundation</uri> coordinates the development and other aspects of the GNOME 40Foundation</uri> coordinates the development and other aspects of the GNOME
41Project. 41Project.
42</p> 42</p>
43 43
44</body> 44</body>
45</section> 45</section>
59<title>The Community</title> 59<title>The Community</title>
60<body> 60<body>
61 61
62<p> 62<p>
63Like with any big free software project, GNOME has an extensive user- and 63Like with any big free software project, GNOME has an extensive user- and
64development base. <uri link="http://www.gnomedesktop.org">Footnotes</uri> 64development base. <uri link="http://planet.gnome.org">GnomePlanet</uri> is
65contains GNOME Desktop news for users; <uri 65a popular blog aggregator for GNOME hackers and contributors whereas <uri
66link="http://planet.gnome.org">GnomePlanet</uri> is for hackers/contributors and
67<uri link="http://developer.gnome.org">Developer.Gnome.Org</uri> is for the 66link="http://developer.gnome.org">Developer.Gnome.Org</uri> is for the GNOME
68GNOME developers. 67developers. <uri link="http://library.gnome.org/users/">GNOME Library</uri>
68contains a huge list of GNOME resources for end users.
69</p> 69</p>
70 70
71</body> 71</body>
72</section> 72</section>
73</chapter> 73</chapter>
75<title>Installing GNOME</title> 75<title>Installing GNOME</title>
76<section> 76<section>
77<title>What do you need?</title> 77<title>What do you need?</title>
78<body> 78<body>
79 79
80<impo>
81First read and follow the instructions in the <uri
82link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri> to setup your
83X environment.
84</impo>
85
80<p> 86<p>
81Before you start installing GNOME, you might want to edit your USE variables. 87Before you start installing GNOME, you might want to edit your USE variables.
82Make sure that <c>gtk</c> and <c>gnome</c> are in your USE variable listed in 88Make sure that <c>X</c>, <c>gtk</c>, and <c>gnome</c> are in your USE variable
83<path>/etc/make.conf</path>. If you want support for <c>hald</c>, the hardware 89listed in <path>/etc/portage/make.conf</path>. If you want support for <c>dbus</c>, a
84abstraction layer daemon add <c>hal</c> to your USE flags. USE variable 90system message bus Gnome uses extensively, add it to your USE flags. If you
85<c>howl</c> brings DNS-detection to GNOME (similiar to Rendevouz under Mac OS X).
86If you don't want KDE support (the other big desktop environment), remove 91don't want KDE support (the other big desktop environment), remove <c>qt4</c>
87<c>qt</c> and <c>kde</c>. 92and <c>kde</c>.
88</p> 93</p>
89 94
90<pre caption="Example USE in /etc/make.conf"> 95<pre caption="Example USE in /etc/portage/make.conf">
91USE="-qt -kde gtk gnome hal howl" 96USE="-qt4 -kde X dbus gtk gnome"
92</pre> 97</pre>
93 98
99<p>
100You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
101splashscreen instead of the default Gnome splashscreen:
94<p> 102</p>
103
104<pre caption="Enabling Gentoo branding">
105# <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
106</pre>
107
108<note>
109If you use the <c>desktop</c> profile, these USE flags will be set for you. You
110can check your profile by running <c>eselect profile list</c> and <c>eselect
111profile set &lt;profile-name&gt;</c> as root.
112</note>
113
114<p>
95Once done, start installing GNOME by emerging <c>gnome</c> and 115Once done, start installing GNOME by emerging <c>gnome</c>:
96<c>xscreensaver</c>:
97</p> 116</p>
98 117
99<pre caption="Installing GNOME"> 118<pre caption="Installing GNOME">
100# <i>emerge gnome xscreensaver</i> 119# <i>emerge gnome</i>
120</pre>
121
122<p>
123You can also opt for a minimal Gnome installation using <c>gnome-light</c>.
124If you do so, you will have a lightweight Gnome installation without
125the additional tools that a full Gnome installation provides so you might need
126to install additional packages afterwards.
127</p>
128
129<pre caption="Installing a minimal GNOME environment">
130# <i>emerge gnome-light</i>
101</pre> 131</pre>
102 132
103<p> 133<p>
104This will take a while, so you might want to start reading all those books your 134This will take a while, so you might want to start reading all those books your
105mother bought you but you never opened. Done? Great, now update your 135mother bought you but you never opened. Done? Great, now update your
106environment variables: 136environment variables:
107</p> 137</p>
108 138
109<pre caption="Updating environment variables"> 139<pre caption="Updating environment variables">
110# <i>env-update &amp;&amp; source /etc/profile</i> 140# <i>env-update &amp;&amp; source /etc/profile</i>
111</pre> 141</pre>
112 142
113<p> 143<p>
114If you paid attention to the output of your previous <c>emerge</c> command, 144Next we'll clean up the remaining services and user groups.
115you'll notice that it suggests adding <c>famd</c> to the default runlevel to
116have nautilus and gnome-vfs monitor file changes:
117</p> 145</p>
118 146
119<pre caption="Adding famd, hald and mDNSResponder to the default runlevel"> 147<pre caption="Setting up the DBUS service">
120# <i>/etc/init.d/famd start</i> 148# <i>/etc/init.d/dbus start</i>
121# <i>rc-update add famd default</i> 149# <i>rc-update add dbus default</i>
150</pre>
122 151
123# <i>/etc/init.d/hald start</i> 152<p>
124# <i>rc-update add hald default</i> 153Check if the <e>plugdev</e> group exists. If it does, it is adviseable to make
154yourself member of that group, but this is optional (the group is not that
155common anymore).
156</p>
125 157
126# <i>/etc/init.d/mDNSResponder start</i> 158<pre caption="Checking and adding users to plugdev">
127# <i>rc-update add mDNSResponder default</i> 159~# <i>getent group plugdev</i>
160plugdev:x:104:
161
162<comment># Substitute yourUserName with your user name ;-)</comment>
163~# <i>gpasswd -a yourUserName plugdev</i>
128</pre> 164</pre>
129 165
130</body> 166</body>
131</section> 167</section>
132<section> 168<section>
134<body> 170<body>
135 171
136<p> 172<p>
137Let us first take a look at what we just built. Exit your root shell and log on 173Let us first take a look at what we just built. Exit your root shell and log on
138as a regular user. We will configure our session to run GNOME when we issue the 174as a regular user. We will configure our session to run GNOME when we issue the
139<c>startx</c> command: 175<c>startx</c> command (see also
176<uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
177<uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
140</p> 178</p>
141 179
142<pre caption="Having GNOME as default desktop environment"> 180<pre caption="Setting GNOME as the default desktop environment">
143$ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i> 181$ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
182</pre>
183
184<p>
185Starting with <c>gnome-base/gnome-session-2.26.2</c>, you will need to prepend
186the XDG_MENU_PREFIX variable to get the Gnome menus if you're using the
187<path>~/.xinitrc</path> method to start your desktop. (If you're not using
188<path>~/.xinitrc</path>, it will be handled automatically for you; no additional
189configuration is needed.)
190</p>
191
192<pre caption="Prepending XDG_MENU_PREFIX to ~/.xinitrc">
193$ <i>sed -i '1i\export XDG_MENU_PREFIX=gnome-' ~/.xinitrc</i>
144</pre> 194</pre>
145 195
146<p> 196<p>
147Now start your graphical environment by running <c>startx</c>: 197Now start your graphical environment by running <c>startx</c>:
148</p> 198</p>
174<pre caption="Adding xdm to the default runlevel"> 224<pre caption="Adding xdm to the default runlevel">
175# <i>rc-update add xdm default</i> 225# <i>rc-update add xdm default</i>
176</pre> 226</pre>
177 227
178<p> 228<p>
179Now check the contents of the <path>/usr/share/xsessions</path>: 229Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
180</p>
181
182<pre caption="Checking the contents of /usr/share/xsessions">
183# <i>ls /usr/share/xsessions</i>
184fluxbox.desktop gnome.desktop
185</pre>
186
187<p> 230</p>
188As you can see, there is a session called <c>gnome</c> available. Now edit
189<path>/etc/rc.conf</path> and alter two variables: DISPLAYMANAGER (which should
190be set to <c>gdm</c>) and XSESSION (which should be set to <c>Gnome</c>):
191</p>
192 231
193<pre caption="Editing /etc/rc.conf"> 232<pre caption="Editing /etc/conf.d/xdm">
194DISPLAYMANAGER="gdm" 233DISPLAYMANAGER="gdm"
195XSESSION="gnome" 234</pre>
235
236<p>
237If you installed Gnome using the <c>gnome-light</c> package, you will need to
238install <c>gdm</c> too (as it is not defined as part of the <c>gnome-light</c>
239package).
240</p>
241
242<pre caption="Installing the gdm application">
243# <i>emerge gdm</i>
196</pre> 244</pre>
197 245
198<p> 246<p>
199If you reboot now, the GNOME Display Manager will prompt you for your username 247If you reboot now, the GNOME Display Manager will prompt you for your username
200and password and will default to using GNOME as Desktop Environment (even though 248and password and will default to using GNOME as Desktop Environment (even though
201you will have the option of selecting a different one of course). 249you will have the option of selecting a different one of course, choosing from
202</p> 250those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
203 251you don't need to edit <path>~/.xinitrc</path>.
204<p>
205To use the functionality of <c>hald</c> just start <c>gnome-volume-manager</c>
206and edit its preferences.
207</p> 252</p>
208 253
209</body> 254</body>
210</section> 255</section>
211</chapter> 256</chapter>

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

  ViewVC Help
Powered by ViewVC 1.1.20