/[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.1 - (hide annotations) (download) (as text)
Wed May 12 08:26:35 2004 UTC (10 years, 7 months ago) by swift
Branch: MAIN
File MIME type: application/xml
GNOME Configuration HOWTO

1 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2    
3     <!-- $Header$ -->
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    
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     <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
22     <license/>
23    
24     <version>1.1</version>
25     <date>May 12, 2004</date>
26    
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     Make sure that <c>gtk</c> and <c>gnome</c> are in your USE variable listed in
80     <path>/etc/make.conf</path>. If you don't want KDE support (the other big
81     desktop environment), remove <c>qt</c> and <c>kde</c>.
82     </p>
83    
84     <pre caption="Example USE in /etc/make.conf">
85     USE="-qt -kde gtk gnome"
86     </pre>
87    
88     <p>
89     Once done, start installing GNOME by emerging <c>gnome</c> and
90     <c>xscreensaver</c>:
91     </p>
92    
93     <pre caption="Installing GNOME">
94     # <i>emerge gnome xscreensaver</i>
95     </pre>
96    
97     <p>
98     This will take a while, so you might want to start reading all those books your
99     mother bought you but you never opened. Done? Great, now update your
100     environment variables:
101     </p>
102    
103     <pre caption="Updating environment variables">
104     # <i>env-update &amp;&amp; source /etc/profile</i>
105     </pre>
106    
107     <p>
108     If you paid attention to the output of your previous <c>emerge</c> command,
109     you'll notice that it suggests adding <c>famd</c> to the default runlevel to
110     have nautilus and gnome-vfs monitor file changes:
111     </p>
112    
113     <pre caption="Adding famd to the default runlevel">
114     # <i>/etc/init.d/famd start</i>
115     # <i>rc-update add famd default</i>
116     </pre>
117    
118     </body>
119     </section>
120     <section>
121     <title>First Impressions</title>
122     <body>
123    
124     <p>
125     Let us first take a look at what we just built. Exit your root shell and log on
126     as a regular user. We will configure our session to run GNOME when we issue the
127     <c>startx</c> command:
128     </p>
129    
130     <pre caption="Having GNOME as default desktop environment">
131     $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
132     </pre>
133    
134     <p>
135     Now start your graphical environment by running <c>startx</c>:
136     </p>
137    
138     <pre caption="Starting GNOME">
139     $ <i>startx</i>
140     </pre>
141    
142     <p>
143     If all goes well, you should be greeted by GNOME. Congratulations. Now let us
144     take a look at how you can configure GNOME to suit your needs.
145     </p>
146    
147     </body>
148     </section>
149     </chapter>
150     <chapter>
151     <title>Configuring GNOME</title>
152     <section>
153     <title>GNOME's Graphical Login Manager</title>
154     <body>
155    
156     <p>
157     If you want the GNOME Display Manager (GDM) to run automatically when you boot
158     (so you can log on graphically), you must add the <c>xdm</c> init script to the
159     default runlevel:
160     </p>
161    
162     <pre caption="Adding xdm to the default runlevel">
163     # <i>rc-update add xdm default</i>
164     </pre>
165    
166     <p>
167     Now check the contents of the <path>/etc/X11/Sessions</path>:
168     </p>
169    
170     <pre caption="Checking the contents of /etc/X11/Sessions">
171     # <i>ls /etc/X11/Sessions</i>
172     Xsession Gnome
173     </pre>
174    
175     <p>
176     As you can see, there is a session called <c>gnome</c> available. Now edit
177     <path>/etc/rc.conf</path> and alter two variables: DISPLAYMANAGER (which should
178     be set to <c>gdm</c>) and XSESSION (which should be set to <c>Gnome</c>):
179     </p>
180    
181     <pre caption="Editing /etc/rc.conf">
182     DISPLAYMANAGER="gdm"
183     XSESSION="Gnome"
184     </pre>
185    
186     <p>
187     If you reboot now, the GNOME Display Manager will prompt you for your username
188     and password and will default to using GNOME as Desktop Environment (even though
189     you will have the option of selecting a different one of course).
190     </p>
191    
192     </body>
193     </section>
194     </chapter>
195     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20