/[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.38 - (hide annotations) (download) (as text)
Sun Dec 9 20:06:14 2012 UTC (21 months, 1 week ago) by swift
Branch: MAIN
Changes since 1.37: +5 -3 lines
File MIME type: application/xml
Appendix to bug #446646 - Add link to World of GNOME

1 swift 1.1 <?xml version='1.0' encoding='UTF-8'?>
2     <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3 swift 1.38 <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gnome-config.xml,v 1.37 2012/12/09 20:04:22 swift Exp $ -->
4 swift 1.1
5 nightmorph 1.28 <guide>
6 swift 1.1 <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 swift 1.26 A frequently used environment is GNOME. This HOWTO tries to describe
20 swift 1.1 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 swift 1.38 <version>7</version>
28 swift 1.37 <date>2012-12-09</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 swift 1.26 development platform. The <uri link="http://foundation.gnome.org">GNOME
40     Foundation</uri> coordinates the development and other aspects of the GNOME
41 swift 1.1 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 swift 1.37 development base. <uri link="http://planet.gnome.org">GnomePlanet</uri> is
65     a popular blog aggregator for GNOME hackers and contributors whereas <uri
66     link="http://developer.gnome.org">Developer.Gnome.Org</uri> is for the GNOME
67     developers. <uri link="http://library.gnome.org/users/">GNOME Library</uri>
68 swift 1.38 contains a huge list of GNOME resources for end users. The <uri
69     link="http://worldofgnome.org/">World of GNOME</uri> is also a popular
70     aggregator for GNOME-related news.
71 swift 1.1 </p>
72    
73     </body>
74     </section>
75     </chapter>
76     <chapter>
77     <title>Installing GNOME</title>
78     <section>
79     <title>What do you need?</title>
80     <body>
81    
82 nightmorph 1.30 <impo>
83     First read and follow the instructions in the <uri
84 nightmorph 1.31 link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri> to setup your
85 nightmorph 1.30 X environment.
86     </impo>
87    
88 swift 1.1 <p>
89     Before you start installing GNOME, you might want to edit your USE variables.
90 nightmorph 1.21 Make sure that <c>X</c>, <c>gtk</c>, and <c>gnome</c> are in your USE variable
91 swift 1.36 listed in <path>/etc/portage/make.conf</path>. If you want support for <c>dbus</c>, a
92 nightmorph 1.33 system message bus Gnome uses extensively, add it to your USE flags. If you
93     don't want KDE support (the other big desktop environment), remove <c>qt4</c>
94     and <c>kde</c>.
95 swift 1.1 </p>
96    
97 swift 1.36 <pre caption="Example USE in /etc/portage/make.conf">
98 nightmorph 1.33 USE="-qt4 -kde X dbus gtk gnome"
99 swift 1.1 </pre>
100    
101     <p>
102 nightmorph 1.17 You can add the <c>branding</c> USE flag to get a lovely Gentoo-branded
103     splashscreen instead of the default Gnome splashscreen:
104     </p>
105    
106     <pre caption="Enabling Gentoo branding">
107     # <i>echo "gnome-base/gnome-session branding" &gt;&gt; /etc/portage/package.use</i>
108     </pre>
109    
110 nightmorph 1.33 <note>
111     If you use the <c>desktop</c> profile, these USE flags will be set for you. You
112     can check your profile by running <c>eselect profile list</c> and <c>eselect
113     profile set &lt;profile-name&gt;</c> as root.
114     </note>
115    
116 nightmorph 1.17 <p>
117 nightmorph 1.18 Once done, start installing GNOME by emerging <c>gnome</c>:
118 swift 1.1 </p>
119    
120     <pre caption="Installing GNOME">
121 nightmorph 1.18 # <i>emerge gnome</i>
122 swift 1.1 </pre>
123    
124     <p>
125 swift 1.35 You can also opt for a minimal Gnome installation using <c>gnome-light</c>.
126     If you do so, you will have a lightweight Gnome installation without
127     the additional tools that a full Gnome installation provides so you might need
128     to install additional packages afterwards.
129 swift 1.4 </p>
130    
131     <pre caption="Installing a minimal GNOME environment">
132     # <i>emerge gnome-light</i>
133     </pre>
134    
135     <p>
136 swift 1.1 This will take a while, so you might want to start reading all those books your
137 swift 1.26 mother bought you but you never opened. Done? Great, now update your
138 swift 1.1 environment variables:
139     </p>
140    
141     <pre caption="Updating environment variables">
142     # <i>env-update &amp;&amp; source /etc/profile</i>
143     </pre>
144    
145     <p>
146 nightmorph 1.33 Next we'll clean up the remaining services and user groups.
147 nightmorph 1.6 </p>
148 dertobi123 1.3
149 swift 1.34 <pre caption="Setting up the DBUS service">
150 nightmorph 1.23 # <i>/etc/init.d/dbus start</i>
151 nightmorph 1.22 # <i>rc-update add dbus default</i>
152 swift 1.1 </pre>
153    
154 swift 1.34 <p>
155     Check if the <e>plugdev</e> group exists. If it does, it is adviseable to make
156     yourself member of that group, but this is optional (the group is not that
157     common anymore).
158     </p>
159    
160     <pre caption="Checking and adding users to plugdev">
161     ~# <i>getent group plugdev</i>
162     plugdev:x:104:
163    
164     <comment># Substitute yourUserName with your user name ;-)</comment>
165     ~# <i>gpasswd -a yourUserName plugdev</i>
166     </pre>
167    
168 swift 1.1 </body>
169     </section>
170     <section>
171     <title>First Impressions</title>
172     <body>
173    
174     <p>
175     Let us first take a look at what we just built. Exit your root shell and log on
176     as a regular user. We will configure our session to run GNOME when we issue the
177 swift 1.5 <c>startx</c> command (see also
178     <uri link="/doc/en/xorg-config.xml#using_startx">Using startx</uri> in the
179     <uri link="/doc/en/xorg-config.xml">X Server Configuration Howto</uri>):
180 swift 1.1 </p>
181    
182 nightmorph 1.33 <pre caption="Setting GNOME as the default desktop environment">
183 swift 1.1 $ <i>echo "exec gnome-session" &gt; ~/.xinitrc</i>
184     </pre>
185    
186     <p>
187 nightmorph 1.27 Starting with <c>gnome-base/gnome-session-2.26.2</c>, you will need to prepend
188     the XDG_MENU_PREFIX variable to get the Gnome menus if you're using the
189     <path>~/.xinitrc</path> method to start your desktop. (If you're not using
190     <path>~/.xinitrc</path>, it will be handled automatically for you; no additional
191     configuration is needed.)
192     </p>
193    
194     <pre caption="Prepending XDG_MENU_PREFIX to ~/.xinitrc">
195 nightmorph 1.29 $ <i>sed -i '1i\export XDG_MENU_PREFIX=gnome-' ~/.xinitrc</i>
196 nightmorph 1.27 </pre>
197    
198     <p>
199 swift 1.1 Now start your graphical environment by running <c>startx</c>:
200     </p>
201    
202     <pre caption="Starting GNOME">
203     $ <i>startx</i>
204     </pre>
205    
206     <p>
207     If all goes well, you should be greeted by GNOME. Congratulations. Now let us
208     take a look at how you can configure GNOME to suit your needs.
209     </p>
210    
211     </body>
212     </section>
213     </chapter>
214     <chapter>
215     <title>Configuring GNOME</title>
216     <section>
217     <title>GNOME's Graphical Login Manager</title>
218     <body>
219    
220     <p>
221     If you want the GNOME Display Manager (GDM) to run automatically when you boot
222     (so you can log on graphically), you must add the <c>xdm</c> init script to the
223     default runlevel:
224     </p>
225    
226     <pre caption="Adding xdm to the default runlevel">
227     # <i>rc-update add xdm default</i>
228     </pre>
229    
230     <p>
231 nightmorph 1.16 Now edit <path>/etc/conf.d/xdm</path> and alter the DISPLAYMANAGER variable.
232 swift 1.1 </p>
233    
234 nightmorph 1.16 <pre caption="Editing /etc/conf.d/xdm">
235 swift 1.1 DISPLAYMANAGER="gdm"
236     </pre>
237    
238     <p>
239 swift 1.35 If you installed Gnome using the <c>gnome-light</c> package, you will need to
240     install <c>gdm</c> too (as it is not defined as part of the <c>gnome-light</c>
241     package).
242     </p>
243    
244     <pre caption="Installing the gdm application">
245     # <i>emerge gdm</i>
246     </pre>
247    
248     <p>
249 swift 1.1 If you reboot now, the GNOME Display Manager will prompt you for your username
250     and password and will default to using GNOME as Desktop Environment (even though
251 swift 1.5 you will have the option of selecting a different one of course, choosing from
252     those available in <path>/usr/share/xsessions/</path>). Thus, if you use GDM,
253     you don't need to edit <path>~/.xinitrc</path>.
254 swift 1.1 </p>
255    
256     </body>
257     </section>
258     </chapter>
259     </guide>

  ViewVC Help
Powered by ViewVC 1.1.20