/[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.4 - (show annotations) (download) (as text)
Thu Mar 17 07:27:31 2005 UTC (9 years, 5 months ago) by swift
Branch: MAIN
Changes since 1.3: +11 -3 lines
File MIME type: application/xml
Mention gnome-light

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">
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/1.0 -->
25 <license/>
26
27 <version>1.4</version>
28 <date>2005-03-17</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>howl</c> brings DNS-detection to GNOME (similiar to Rendevouz under Mac OS X).
86 If you don't want KDE support (the other big desktop environment), remove
87 <c>qt</c> and <c>kde</c>.
88 </p>
89
90 <pre caption="Example USE in /etc/make.conf">
91 USE="-qt -kde gtk gnome hal howl"
92 </pre>
93
94 <p>
95 Once done, start installing GNOME by emerging <c>gnome</c> and
96 <c>xscreensaver</c>:
97 </p>
98
99 <pre caption="Installing GNOME">
100 # <i>emerge gnome xscreensaver</i>
101 </pre>
102
103 <p>
104 You can also opt for a minimal Gnome installation using <c>gnome-light</c>:
105 </p>
106
107 <pre caption="Installing a minimal GNOME environment">
108 # <i>emerge gnome-light</i>
109 </pre>
110
111 <p>
112 This will take a while, so you might want to start reading all those books your
113 mother bought you but you never opened. Done? Great, now update your
114 environment variables:
115 </p>
116
117 <pre caption="Updating environment variables">
118 # <i>env-update &amp;&amp; source /etc/profile</i>
119 </pre>
120
121 <p>
122 If you paid attention to the output of your previous <c>emerge</c> command,
123 you'll notice that it suggests adding <c>famd</c> to the default runlevel to
124 have nautilus and gnome-vfs monitor file changes:
125 </p>
126
127 <pre caption="Adding famd, hald and mDNSResponder to the default runlevel">
128 # <i>/etc/init.d/famd start</i>
129 # <i>rc-update add famd default</i>
130
131 # <i>/etc/init.d/hald start</i>
132 # <i>rc-update add hald default</i>
133
134 # <i>/etc/init.d/mDNSResponder start</i>
135 # <i>rc-update add mDNSResponder default</i>
136 </pre>
137
138 </body>
139 </section>
140 <section>
141 <title>First Impressions</title>
142 <body>
143
144 <p>
145 Let us first take a look at what we just built. Exit your root shell and log on
146 as a regular user. We will configure our session to run GNOME when we issue the
147 <c>startx</c> command:
148 </p>
149
150 <pre caption="Having GNOME as default desktop environment">
151 $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
152 </pre>
153
154 <p>
155 Now start your graphical environment by running <c>startx</c>:
156 </p>
157
158 <pre caption="Starting GNOME">
159 $ <i>startx</i>
160 </pre>
161
162 <p>
163 If all goes well, you should be greeted by GNOME. Congratulations. Now let us
164 take a look at how you can configure GNOME to suit your needs.
165 </p>
166
167 </body>
168 </section>
169 </chapter>
170 <chapter>
171 <title>Configuring GNOME</title>
172 <section>
173 <title>GNOME's Graphical Login Manager</title>
174 <body>
175
176 <p>
177 If you want the GNOME Display Manager (GDM) to run automatically when you boot
178 (so you can log on graphically), you must add the <c>xdm</c> init script to the
179 default runlevel:
180 </p>
181
182 <pre caption="Adding xdm to the default runlevel">
183 # <i>rc-update add xdm default</i>
184 </pre>
185
186 <p>
187 Now check the contents of the <path>/usr/share/xsessions</path>:
188 </p>
189
190 <pre caption="Checking the contents of /usr/share/xsessions">
191 # <i>ls /usr/share/xsessions</i>
192 fluxbox.desktop gnome.desktop
193 </pre>
194
195 <p>
196 As you can see, there is a session called <c>gnome</c> available. Now edit
197 <path>/etc/rc.conf</path> and alter two variables: DISPLAYMANAGER (which should
198 be set to <c>gdm</c>) and XSESSION (which should be set to <c>Gnome</c>):
199 </p>
200
201 <pre caption="Editing /etc/rc.conf">
202 DISPLAYMANAGER="gdm"
203 XSESSION="gnome"
204 </pre>
205
206 <p>
207 If you reboot now, the GNOME Display Manager will prompt you for your username
208 and password and will default to using GNOME as Desktop Environment (even though
209 you will have the option of selecting a different one of course).
210 </p>
211
212 <p>
213 To use the functionality of <c>hald</c> just start <c>gnome-volume-manager</c>
214 and edit its preferences.
215 </p>
216
217 </body>
218 </section>
219 </chapter>
220 </guide>

  ViewVC Help
Powered by ViewVC 1.1.20