/[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.23 - (hide annotations) (download) (as text)
Wed Nov 14 07:08:36 2007 UTC (6 years, 8 months ago) by nightmorph
Branch: MAIN
Changes since 1.22: +2 -2 lines
File MIME type: application/xml
typo fix for the previous fix; should be init.d. really, that's the last commit in this series. really. i hope.

1 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 nightmorph 1.23 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.22 2007/11/14 07:04:54 nightmorph 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 nightmorph 1.21 <author title="Editor">
15     <mail link="nightmorph"/>
16     </author>
17 swift 1.1
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 neysx 1.7 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25 swift 1.1 <license/>
26    
27 nightmorph 1.22 <version>1.18</version>
28 nightmorph 1.21 <date>2007-11-13</date>
29 swift 1.1
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 nightmorph 1.21 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 Rendevouz under
87     Mac OS X). If you don't want KDE support (the other big desktop environment),
88     remove <c>qt3</c>, <c>qt4</c>, <c>arts</c>, and <c>kde</c>.
89 swift 1.1 </p>
90    
91     <pre caption="Example USE in /etc/make.conf">
92 nightmorph 1.21 USE="-qt3 -qt4 -arts -kde X dbus gtk gnome hal avahi"
93 swift 1.1 </pre>
94    
95     <p>
96 nightmorph 1.17 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 nightmorph 1.18 Once done, start installing GNOME by emerging <c>gnome</c>:
106 swift 1.1 </p>
107    
108     <pre caption="Installing GNOME">
109 nightmorph 1.18 # <i>emerge gnome</i>
110 swift 1.1 </pre>
111    
112     <p>
113 swift 1.4 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 swift 1.1 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 nightmorph 1.6 you'll notice that it suggests using <c>gamin</c> to have nautilus and
133     gnome-vfs monitor file changes:
134 swift 1.1 </p>
135    
136 nightmorph 1.6 <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 nightmorph 1.15 <pre caption="Optional: switching to gamin from fam">
147 jkt 1.19 # <i>rc-update del famd</i>
148 nightmorph 1.15 # <i>emerge --unmerge app-admin/fam</i>
149 nightmorph 1.6 </pre>
150    
151     <p>
152 jkt 1.19 Next we'll clean up the remaining services.
153 nightmorph 1.6 </p>
154 dertobi123 1.3
155 neysx 1.7 <pre caption="Adding hald and avahi-dnsconfd to the default runlevel">
156 dertobi123 1.3 # <i>/etc/init.d/hald start</i>
157     # <i>rc-update add hald default</i>
158    
159 nightmorph 1.23 # <i>/etc/init.d/dbus start</i>
160 nightmorph 1.22 # <i>rc-update add dbus default</i>
161    
162 neysx 1.7 # <i>/etc/init.d/avahi-dnsconfd start</i>
163     # <i>rc-update add avahi-dnsconfd default</i>
164 swift 1.1 </pre>
165    
166     </body>
167     </section>
168     <section>
169     <title>First Impressions</title>
170     <body>
171    
172     <p>
173     Let us first take a look at what we just built. Exit your root shell and log on
174     as a regular user. We will configure our session to run GNOME when we issue the
175 swift 1.5 <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>):
178 swift 1.1 </p>
179    
180     <pre caption="Having GNOME as default desktop environment">
181     $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
182     </pre>
183    
184     <p>
185     Now start your graphical environment by running <c>startx</c>:
186     </p>
187    
188     <pre caption="Starting GNOME">
189     $ <i>startx</i>
190     </pre>
191    
192     <p>
193     If all goes well, you should be greeted by GNOME. Congratulations. Now let us
194     take a look at how you can configure GNOME to suit your needs.
195     </p>
196    
197     </body>
198     </section>
199     </chapter>
200     <chapter>
201     <title>Configuring GNOME</title>
202     <section>
203     <title>GNOME's Graphical Login Manager</title>
204     <body>
205    
206     <p>
207     If you want the GNOME Display Manager (GDM) to run automatically when you boot
208     (so you can log on graphically), you must add the <c>xdm</c> init script to the
209     default runlevel:
210     </p>
211    
212     <pre caption="Adding xdm to the default runlevel">
213     # <i>rc-update add xdm default</i>
214     </pre>
215    
216     <p>
217 nightmorph 1.16 Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
218 swift 1.1 </p>
219    
220 nightmorph 1.16 <pre caption="Editing /etc/conf.d/xdm">
221 swift 1.1 DISPLAYMANAGER="gdm"
222     </pre>
223    
224     <p>
225     If you reboot now, the GNOME Display Manager will prompt you for your username
226     and password and will default to using GNOME as Desktop Environment (even though
227 swift 1.5 you will have the option of selecting a different one of course, choosing from
228     those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
229     you don't need to edit <path>~/.xinitrc</path>.
230 swift 1.1 </p>
231    
232 dertobi123 1.3 <p>
233     To use the functionality of <c>hald</c> just start <c>gnome-volume-manager</c>
234 nightmorph 1.11 and edit its preferences. Also, you'll need to add your user to the
235     <c>plugdev</c> group.
236 dertobi123 1.3 </p>
237    
238 swift 1.1 </body>
239     </section>
240     </chapter>
241     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20