/[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.27 - (show annotations) (download) (as text)
Tue Sep 1 23:58:43 2009 UTC (5 years, 3 months ago) by nightmorph
Branch: MAIN
Changes since 1.26: +20 -27 lines
File MIME type: application/xml
Update the guide for pending 2.26 stuff, bug 281423

1 <?xml version='1.0' encoding='UTF-8'?>
2 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.26 2008/05/23 20:00:57 swift Exp $ -->
4
5 <guide link="/doc/en/gnome-config.xml">
6 <title>The GNOME Configuration HOWTO</title>
7
8 <author title="Author">
9 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
10 </author>
11 <author title="Editor">
12 <mail link="lars@strojny.net">Lars Strojny</mail>
13 </author>
14 <author title="Editor">
15 <mail link="nightmorph"/>
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.20</version>
28 <date>2009-09-01</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>X</c>, <c>gtk</c>, and <c>gnome</c> are in your USE variable
83 listed in <path>/etc/make.conf</path>. If you want support for <c>hald</c>, the
84 hardware abstraction layer daemon add <c>hal</c> to your USE flags. The same
85 goes for <c>dbus</c>, a system message bus Gnome uses extensively. The
86 <c>avahi</c> USE flag brings DNS detection to GNOME (similiar to Rendezvous
87 under Mac OS X). If you don't want KDE support (the other big desktop
88 environment), remove <c>qt3</c>, <c>qt4</c>, <c>arts</c>, and <c>kde</c>.
89 </p>
90
91 <pre caption="Example USE in /etc/make.conf">
92 USE="-qt3 -qt4 -arts -kde X dbus gtk gnome hal avahi"
93 </pre>
94
95 <p>
96 You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
97 splashscreen instead of the default Gnome splashscreen:
98 </p>
99
100 <pre caption="Enabling Gentoo branding">
101 # <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
102 </pre>
103
104 <p>
105 Once done, start installing GNOME by emerging <c>gnome</c>:
106 </p>
107
108 <pre caption="Installing GNOME">
109 # <i>emerge gnome</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 Next we'll clean up the remaining services.
132 </p>
133
134 <pre caption="Adding hald and avahi-dnsconfd to the default runlevel">
135 # <i>/etc/init.d/hald start</i>
136 # <i>rc-update add hald default</i>
137
138 # <i>/etc/init.d/dbus start</i>
139 # <i>rc-update add dbus default</i>
140
141 # <i>/etc/init.d/avahi-dnsconfd start</i>
142 # <i>rc-update add avahi-dnsconfd default</i>
143 </pre>
144
145 </body>
146 </section>
147 <section>
148 <title>First Impressions</title>
149 <body>
150
151 <p>
152 Let us first take a look at what we just built. Exit your root shell and log on
153 as a regular user. We will configure our session to run GNOME when we issue the
154 <c>startx</c> command (see also
155 <uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
156 <uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
157 </p>
158
159 <pre caption="Having GNOME as default desktop environment">
160 $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
161 </pre>
162
163 <p>
164 Starting with <c>gnome-base/gnome-session-2.26.2</c>, you will need to prepend
165 the XDG_MENU_PREFIX variable to get the Gnome menus if you're using the
166 <path>~/.xinitrc</path> method to start your desktop. (If you're not using
167 <path>~/.xinitrc</path>, it will be handled automatically for you; no additional
168 configuration is needed.)
169 </p>
170
171 <pre caption="Prepending XDG_MENU_PREFIX to ~/.xinitrc">
172 $ <i>sed '1i\export XDG_MENU_PREFIX=gnome-' ~/.xinitrc</i>
173 </pre>
174
175 <p>
176 Now start your graphical environment by running <c>startx</c>:
177 </p>
178
179 <pre caption="Starting GNOME">
180 $ <i>startx</i>
181 </pre>
182
183 <p>
184 If all goes well, you should be greeted by GNOME. Congratulations. Now let us
185 take a look at how you can configure GNOME to suit your needs.
186 </p>
187
188 </body>
189 </section>
190 </chapter>
191 <chapter>
192 <title>Configuring GNOME</title>
193 <section>
194 <title>GNOME's Graphical Login Manager</title>
195 <body>
196
197 <p>
198 If you want the GNOME Display Manager (GDM) to run automatically when you boot
199 (so you can log on graphically), you must add the <c>xdm</c> init script to the
200 default runlevel:
201 </p>
202
203 <pre caption="Adding xdm to the default runlevel">
204 # <i>rc-update add xdm default</i>
205 </pre>
206
207 <p>
208 Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
209 </p>
210
211 <pre caption="Editing /etc/conf.d/xdm">
212 DISPLAYMANAGER="gdm"
213 </pre>
214
215 <p>
216 If you reboot now, the GNOME Display Manager will prompt you for your username
217 and password and will default to using GNOME as Desktop Environment (even though
218 you will have the option of selecting a different one of course, choosing from
219 those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
220 you don't need to edit <path>~/.xinitrc</path>.
221 </p>
222
223 <p>
224 To use the functionality of <c>hald</c> you need to add your user to the
225 <c>plugdev</c> group. If you want support for devices not handled by the
226 <c>nautilus</c> file manager, or if you're not using <c>nautilus</c> at all, you
227 might want to make sure that <c>gnome-volume-manager</c> is built with the
228 <c>automount</c> USE flag, and that it's started every time you login.
229 </p>
230
231 </body>
232 </section>
233 </chapter>
234 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20