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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.17 - (show annotations) (download) (as text)
Mon Jan 8 21:05:06 2007 UTC (7 years, 7 months ago) by nightmorph
Branch: MAIN
Changes since 1.16: +12 -3 lines
File MIME type: application/xml
added a blurb on branding gnome to get the lovely gentoo splashscreen

1 <?xml version='1.0' encoding='UTF-8'?>
2
3 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.16 2006/12/23 04:40:54 nightmorph Exp $ -->
4
5 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
6
7 <guide link="/doc/en/gnome-config.xml">
8
9 <title>The GNOME Configuration HOWTO</title>
10
11 <author title="Author">
12 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13 </author>
14 <author title="Editor">
15 <mail link="lars@strojny.net">Lars Strojny</mail>
16 </author>
17
18 <abstract>
19 A frequently used environment is GNOME. This HOWTO tries to describe
20 all aspects of GNOME, including installation, configuration, usage, ...
21 </abstract>
22
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25 <license/>
26
27 <version>1.14</version>
28 <date>2007-01-08</date>
29
30 <chapter>
31 <title>What is GNOME?</title>
32 <section>
33 <title>The Project</title>
34 <body>
35
36 <p>
37 The <uri link="http://www.gnome.org">GNOME</uri> project is a free software
38 project dedicated to the development of GNOME, a Unix/Linux desktop suite and
39 development platform. The <uri link="http://foundation.gnome.org">GNOME
40 Foundation</uri> coordinates the development and other aspects of the GNOME
41 Project.
42 </p>
43
44 </body>
45 </section>
46 <section>
47 <title>The Software</title>
48 <body>
49
50 <p>
51 GNOME is a desktop environment and a development platform. This piece of free
52 software is the desktop of choice for several industry leaders. It is
53 interesting both for business users, home users as well as developers.
54 </p>
55
56 </body>
57 </section>
58 <section>
59 <title>The Community</title>
60 <body>
61
62 <p>
63 Like with any big free software project, GNOME has an extensive user- and
64 development base. <uri link="http://www.gnomedesktop.org">Footnotes</uri>
65 contains GNOME Desktop news for users; <uri
66 link="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
68 GNOME developers.
69 </p>
70
71 </body>
72 </section>
73 </chapter>
74 <chapter>
75 <title>Installing GNOME</title>
76 <section>
77 <title>What do you need?</title>
78 <body>
79
80 <p>
81 Before you start installing GNOME, you might want to edit your USE variables.
82 Make sure that <c>gtk</c> and <c>gnome</c> are in your USE variable listed in
83 <path>/etc/make.conf</path>. If you want support for <c>hald</c>, the hardware
84 abstraction layer daemon add <c>hal</c> to your USE flags. USE variable
85 <c>avahi</c> brings DNS-detection to GNOME (similiar to Rendevouz under Mac OS
86 X). If you don't want KDE support (the other big desktop environment), remove
87 <c>qt*</c>, <c>arts</c> and <c>kde</c>.
88 </p>
89
90 <pre caption="Example USE in /etc/make.conf">
91 USE="-qt3 -qt4 -arts -kde gtk gnome hal avahi"
92 </pre>
93
94 <p>
95 You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
96 splashscreen instead of the default Gnome splashscreen:
97 </p>
98
99 <pre caption="Enabling Gentoo branding">
100 # <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
101 </pre>
102
103 <p>
104 Once done, start installing GNOME by emerging <c>gnome</c> and
105 <c>gnome-screensaver</c>:
106 </p>
107
108 <pre caption="Installing GNOME">
109 # <i>emerge gnome gnome-screensaver</i>
110 </pre>
111
112 <p>
113 You can also opt for a minimal Gnome installation using <c>gnome-light</c>:
114 </p>
115
116 <pre caption="Installing a minimal GNOME environment">
117 # <i>emerge gnome-light</i>
118 </pre>
119
120 <p>
121 This will take a while, so you might want to start reading all those books your
122 mother bought you but you never opened. Done? Great, now update your
123 environment variables:
124 </p>
125
126 <pre caption="Updating environment variables">
127 # <i>env-update &amp;&amp; source /etc/profile</i>
128 </pre>
129
130 <p>
131 If you paid attention to the output of your previous <c>emerge</c> command,
132 you'll notice that it suggests using <c>gamin</c> to have nautilus and
133 gnome-vfs monitor file changes:
134 </p>
135
136 <pre caption="Installing gamin, a file alteration monitor">
137 # <i>emerge gamin</i>
138 </pre>
139
140 <impo>
141 If you are switching from <c>fam</c> (the old, deprecated file monitor) to
142 <c>gamin</c>, you will need to remove <c>famd</c> from all runlevels and then
143 unmerge it:
144 </impo>
145
146 <pre caption="Optional: switching to gamin from fam">
147 # <i>rc-update del famd default</i>
148 # <i>emerge --unmerge app-admin/fam</i>
149 </pre>
150
151 <p>
152 Next we'll clean up the remaining runlevels.
153 </p>
154
155 <pre caption="Adding hald and avahi-dnsconfd to the default runlevel">
156 # <i>/etc/init.d/hald start</i>
157 # <i>rc-update add hald default</i>
158
159 # <i>/etc/init.d/avahi-dnsconfd start</i>
160 # <i>rc-update add avahi-dnsconfd default</i>
161 </pre>
162
163 </body>
164 </section>
165 <section>
166 <title>First Impressions</title>
167 <body>
168
169 <p>
170 Let us first take a look at what we just built. Exit your root shell and log on
171 as a regular user. We will configure our session to run GNOME when we issue the
172 <c>startx</c> command (see also
173 <uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
174 <uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
175 </p>
176
177 <pre caption="Having GNOME as default desktop environment">
178 $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
179 </pre>
180
181 <p>
182 Now start your graphical environment by running <c>startx</c>:
183 </p>
184
185 <pre caption="Starting GNOME">
186 $ <i>startx</i>
187 </pre>
188
189 <p>
190 If all goes well, you should be greeted by GNOME. Congratulations. Now let us
191 take a look at how you can configure GNOME to suit your needs.
192 </p>
193
194 </body>
195 </section>
196 </chapter>
197 <chapter>
198 <title>Configuring GNOME</title>
199 <section>
200 <title>GNOME's Graphical Login Manager</title>
201 <body>
202
203 <p>
204 If you want the GNOME Display Manager (GDM) to run automatically when you boot
205 (so you can log on graphically), you must add the <c>xdm</c> init script to the
206 default runlevel:
207 </p>
208
209 <pre caption="Adding xdm to the default runlevel">
210 # <i>rc-update add xdm default</i>
211 </pre>
212
213 <p>
214 Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
215 </p>
216
217 <pre caption="Editing /etc/conf.d/xdm">
218 DISPLAYMANAGER="gdm"
219 </pre>
220
221 <p>
222 If you reboot now, the GNOME Display Manager will prompt you for your username
223 and password and will default to using GNOME as Desktop Environment (even though
224 you will have the option of selecting a different one of course, choosing from
225 those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
226 you don't need to edit <path>~/.xinitrc</path>.
227 </p>
228
229 <p>
230 To use the functionality of <c>hald</c> just start <c>gnome-volume-manager</c>
231 and edit its preferences. Also, you'll need to add your user to the
232 <c>plugdev</c> group.
233 </p>
234
235 </body>
236 </section>
237 </chapter>
238 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20