/[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.20 - (hide annotations) (download) (as text)
Wed Nov 14 06:30:34 2007 UTC (6 years, 8 months ago) by nightmorph
Branch: MAIN
Changes since 1.19: +1 -4 lines
File MIME type: application/xml
coding style, no content change

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

  ViewVC Help
Powered by ViewVC 1.1.20