Difference between pages "Welcome" and "GNOME First Steps"

(Difference between pages)
(add mention of metro and keychain to main page)
 
(GNOME 3.14 from a clean install)
 
Line 1: Line 1:
<div class="container" style="font-family: Open Sans; font-size: 14px; line-height: 20px;"><div class="row"><div class="col-xs-12 col-md-8 col-lg-8">
+
=== What is GNOME? ===
{{Slideshow}}
+
Want to submit a screenshot? [http://forums.funtoo.org/index.php?/topic/180-screenshots/ See here.]
+
</div><div class="col-xs-12 col-md-4 col-lg-4">
+
'''Funtoo Linux''' is a Linux-based operating system that is a variant of [http://www.gentoo.org Gentoo Linux], led by [[User:Drobbins|Daniel Robbins]], the creator and former Chief Architect of [http://en.wikipedia.org/wiki/Gentoo_Linux Gentoo Linux], who serves as benevolent dictator for life (BDFL) of the project. ''Funtoo Linux is optimized for the best possible performance, supporting Intel Core i7, AMD FX Processors, and others.''  [[Subarches|See what we support.]] See [[#Distinctives|Distinctives]], below, for more information about what makes Funtoo Linux special.
+
  
'''Other Funtoo Projects include''':
+
"GNOME 3 is an easy and elegant way to use your computer. It is designed to put you in control and bring freedom to everybody. GNOME 3 is developed by the GNOME community, a diverse, international group of contributors that is supported by an independent, non-profit foundation." — [http://gnome.org GNOME]
*  [[Keychain]], an SSH/GPG agent front-end.
+
* [[Metro]], automated Funtoo build engine.
+
<div class="bs-callout bs-callout-warning">
+
[[Support Funtoo]] to help us grow! '''Donate $15 per month and get a free [[Funtoo Hosting|Funtoo Virtual Container]].'''
+
</div>
+
=== News ===
+
{{NewsList|1}}
+
[[News|View More News...]]
+
</div>
+
</div><div class="row">
+
<div class="col-xs-12 col-md-4 col-lg-4">
+
=== Resources ===
+
'''View the [[Funtoo Linux FAQ]] for answers to common questions.'''
+
  
{{#ask: [[Category:People]] [[Gravatar MD5::+]]
+
=== Prerequisites ===
| limit=22
+
 
| order=random
+
==== From a Clean Install ====
| format=template
+
 
| template=GravatarDisplay
+
Ensure that the [[X Window System]] is installed.
| link=none
+
 
| searchlabel=
+
=== Preparing to emerge ===
 +
 
 +
To get your system ready to emerge gnome, first set your system flavor to desktop, and enable the gnome profile mix-in. To accomplish this, do the following:
 +
{{console|recipe=setup,setup-light|desc=Set profile|body=
 +
# ##i##eselect profile set-flavor funtoo/1.0/linux-gnu/flavor/desktop
 +
# ##i##eselect profile add funtoo/1.0/linux-gnu/mix-ins/gnome
 
}}
 
}}
  
Join us - {{CreateAccount}}, and then add yourself to our [[Usermap]]!
+
By enabling the gnome mix-in, various USE and other settings will be optimized to provide you with a pain-free GNOME installation experience.
  
'''Our resources:''' -- also see the <code>Go</code> menu:
+
=== Emerging ===
* '''{{CreateAccount}}''' ([[Funtoo Authentication FAQ|Auth FAQ]])
+
* '''[http://forums.funtoo.org forums.funtoo.org]''' - our new forums!
+
* '''[http://bugs.funtoo.org bugs.funtoo.org]''', our bug tracker ([[Reporting Bugs|Instructions]]).
+
* [http://larrythecow.org larrythecow.org], Gentoo blog service.
+
* [http://kernel-seeds.org kernel-seeds.org], kernel build help.
+
* [http://git.funtoo.org git.funtoo.org], our cgit repository browser.
+
* '''[[Support Funtoo]]''' to help our project grow.
+
* '''[[Funtoo Hosting|Get a Funtoo Virtual Container]]'''.
+
  
'''Ebuild pages recently updated:''' {{#ask: [[Category:Ebuilds]]
+
You are provided with two packages that will pull in this desktop environment:
| order=descending
+
 
| sort=Modification date
+
* ''gnome''
| format=list
+
 
| limit=10
+
{{fancynote|This is the "whole shabang" - pulls in a range of applications made for the gnome desktop environment including a few games, an archive manager, a system monitor, a web browser, a terminal, etc.}}
| searchlabel=more...
+
 
 +
* ''gnome-light''
 +
 
 +
{{fancynote|As the name implies, this pulls in the base minimal you need to get a functioning GNOME Desktop Environment.}}
 +
 
 +
==== GNOME 3.14 from a clean install ====
 +
 
 +
===== gnome =====
 +
 
 +
To emerge ''gnome'' run the following command
 +
 
 +
{{console|desc=Emerging GNOME|body=
 +
# ##i## emerge gnome
 
}}
 
}}
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
 
=== Getting Started ===
 
  
We encourage you to '''[[Funtoo Linux Installation|install Funtoo Linux]]''', and get involved in our user community. Get to know fellow Funtoo Linux users on our '''[http://forums.funtoo.org forums]'''. If you have any improvements or find any bugs in Funtoo Linux, you are strongly encouraged to report them on our '''[http://bugs.funtoo.org bug tracker]'''. We take all bugs seriously, and all work performed on Funtoo Linux is tracked on our bug tracker, for purposes of transparency.
+
===== gnome-light =====
  
Funtoo Linux has a very active [http://en.wikipedia.org/wiki/IRC IRC] community on Freenode, in the <code>#funtoo</code> channel, and you are encouraged to hang out online with us.
+
To emerge ''gnome-light'' run the following command
  
=== Expand the wiki! ===
+
{{console|recipe=setup-light|desc=Emerging a minimal GNOME environment (alternative)|body=
 +
# ##i## emerge gnome-light
 +
}}
  
The [[:Help:Funtoo_Editing_Guidelines | How to 'wiki']] will help get you started on wiki editing. Have a look at [[Requested-Documents]] and [[:Category:Needs_Updates | pages that need to be updated.]]
+
==== Upgrading from GNOME 3.12 ====
  
See [[:Category:Ebuilds|Ebuilds]] for a list of all ebuild pages, and [[Adding an Ebuild to the Wiki]] for information on how to add one.
+
To update either ''gnome'' or ''gnome-light'' run the following command:
  
</div><div class="col-sm-12 col-xs-12 col-md-4 col-lg-4">
+
{{console|body=
=== Distinctives ===
+
# ##i## emerge -vauDN world
 +
}}
 +
=== Subsystems ===
  
Funtoo Linux is a meta-distribution, which means it is built (fully automatically) with the functionality and optimizations that ''you'' want, not what some distro maintainer thought was best for you. Funtoo Linux packages are installed directly from source code, thanks to the [http://en.wikipedia.org/wiki/Portage_(software) Portage ports system], inspired by the FreeBSD ports system, written in Python and with full advanced package management functionality.
+
==== Bluetooth ====
  
''Benefits for desktops'': leaner, optimized, faster system. ''Additional benefits for servers'': enable only what you actually need to reduce attack surface, thus improving security.
+
For bluetooth support, ensure that:
  
We use [http://en.wikipedia.org/wiki/Git_(software) Git] for all our development, and we also use Git to deliver our ports tree to you.
+
# Bluetooth support is enabled in your kernel (using modules is fine).
 +
# Your bluetooth hardware is turned on.
 +
# Add the <code>bluetooth</code> startup script to the default runlevel, and start it.
  
In contrast to Gentoo Linux, we offer a number of innovations, including our extensive use of git, [[Funtoo 1.0 Profile|our profile system]], [[Package:Boot-Update|boot-update]] boot management tool, our incredibly flexible [[Funtoo Linux Networking|template-based networking scripts]], [[Metro Quick Start Tutorial|Metro]] distribution build system, support of Debian, RHEL and other kernels, [[Creating_Python-related_Ebuilds|enhanced Python support]], Portage mini-manifests, user-centric distribution model, and a large number of community infrastructure improvements.
+
This can be done as follows:
</div></div></div>
+
  
__NOTITLE__
+
<console>
__NOEDITSECTION__
+
# ##i##rc-update add bluetooth default
{{#subobject:|slideIndex=0|slideCaption=
+
# ##i##rc
<h4> [[User:Drobbins|drobbins]] </h4>
+
</console>
  
[[GNOME First Steps|GNOME 3.12]]
+
Once this is done, you should now be able to navigate to ''Settings'' -> ''Bluetooth'' and turn bluetooth on. The icon next to devices should now animate and you should be able to discover and add devices such as keyboards.
([[Funtoo_Linux_FAQ#Do_you_support_systemd.3F|without systemd]], because that's how we roll.)
+
  
Note: Badgers optional.
+
{{Note|1=
|slideImage=File:gnome3122.jpg|slideLink=GNOME First Steps}}
+
Additional kernel drivers may need to be enabled for certain input devices. For example, for the bluetooth Apple Magic Trackpad, the following option must be enabled in your kernel:
{{#subobject:|slideIndex=1|slideCaption=
+
<h4>[[User:Anak1n|anak1n]] </h4>
+
  
flux box
+
{{kernelop|title=Device Drivers,HID support,HID bus support,Special HID drivers|desc=
|slideImage=File:fluxbox-09.02.14.jpg}}
+
<M> Apple Magic Mouse/Trackpad multi-touch support
{{#subobject:|slideIndex=2|slideCaption=
+
}}}}
<h4>spectromas</h4>
+
  
[[Package:Awesome_(Window_Manager)|Awesome WM]]
+
==== Printing ====
|slideImage=File:awesome.jpg|slideLink=Package:Awesome (Window Manager)}}
+
{{#subobject:|slideIndex=3|slideCaption=
+
<h4> [[User:Anak1n|anak1n]] </h4>
+
  
KDE
+
To enable printing support, add <code>cupsd</code> to the default runlevel:
|slideImage=File:anak1n-kde.jpg}}
+
 
{{#seo:
+
<console>
|title=Funtoo Linux
+
# ##i##rc-update add cupsd default
|keywords=funtoo,linux,gentoo,Daniel Robbins
+
# ##i##rc
|description=Funtoo Linux is a Gentoo-based Linux distribution that uses Portage
+
</console>
 +
 
 +
You should now be able to navigate to ''Settings'' -> ''Printers'' and add printers to your system, and print.
 +
 
 +
==== Scanning ====
 +
 
 +
To enable scanning support, add your user account to the <code>lp</code> group. This will allow your user to access the USB scanner.
 +
 
 +
Then, <code>emerge xsane</code>, and run it. It should be able to access your scanner.
 +
 
 +
=== Finishing Touches ===
 +
 
 +
==== X ====
 +
 
 +
===== Setting up xdm (GUI log-in) =====
 +
 
 +
Typically, you will want to use <code>gdm</code>, the GNOME display manager, to log in to GNOME. This will allow you to log in graphically, rather than using the text console.
 +
 
 +
To enable gdm, edit <code>/etc/conf.d/xdm</code> and set <code>DISPLAYMANAGER</code> to <code>gdm</code> instead of <code>xdm</code>. Then, perform the following steps to add <code>xdm</code> to the default runlevel, and have it start automatically from now on when your system starts:
 +
 
 +
{{Note|Funtoo's <code>/etc/init.d/xdm</code> initscript has been modified to start the requisite services <code>dbus</code>, <code>openrc-settingsd</code> and <code>consolekit</code> prior to starting <code>gdm</code>.}}
 +
 
 +
{{console|recipe=setup|desc=Enable the GNOME display manager|body=
 +
# ##i## rc-update add xdm default
 
}}
 
}}
 +
 +
Then, if you want to start it now do:
 +
 +
{{console|body=
 +
# ##i##rc
 +
}}
 +
 +
But you should reboot to avoid having an open login terminal.
 +
 +
===== Setting up xinitrc (text log-in) =====
 +
 +
Adding the following to your <code>~/.xinitrc</code> file is sufficient:
 +
 +
<pre>
 +
# Fix Missing Applications in Gnome
 +
export XDG_MENU_PREFIX=gnome-
 +
 +
# Properly Launch the Desired X Session
 +
exec ck-launch-session gnome-session
 +
</pre>
 +
 +
Additionaly, if you need support for different input sources, there is no longer a need to configure IBus or SCIM in your <code>.xinitrc</code> file as GNOME uses IBus natively. Simply configure it in the Control Center under Region & Language.
 +
 +
=== Automatically Starting Applications at Login ===
 +
 +
When using an old-fashioned <code>.xinitrc</code>, starting up applications when X starts is relatively easy. When using GDM, this can still be accomplished, by using the <code>~/.xprofile</code> file. Here's my sample <code>.xprofile</code> to start <code>xflux</code> to dim the screen at night:
 +
 +
<pre>
 +
xflux -z 87107
 +
</pre>
 +
 +
{{Note|Remember to add a <code>&</code> at the end of any command that doesn't return to the shell prompt after running.}}
 +
 +
=== games ===
 +
Gnome has several games that can be added on to your install.  By default most games are not included in gnome's emerge.
 +
 +
Users wishing to play games need to be added to the games group:
 +
{{console|body=###i## gpasswd -a $USER games}}
 +
 +
game list:
 +
;gnome-sudoku
 +
;gnome-mastermind
 +
;gnome-nibbles
 +
;gnome-robots
 +
;gnome-chess
 +
;gnome-hearts
 +
;gnome-mahjongg
 +
;gnome-mines
 +
;gnome-klotski
 +
;gnome-tetravex
 +
 +
game system emulators:
 +
 +
;gnomeboyadvance
 +
;gnome-mud
 +
 +
=== Significant Known Issues (Workarounds Available) ===
 +
 +
[https://bugs.funtoo.org/browse/FL-1678 FL-1678]: Bluetooth interface gives wrong pairing key
 +
 +
[https://bugs.funtoo.org/browse/FL-1687 FL-1687]: Wallpaper corruption when resuming from suspend
 +
 +
[[Category:Desktop]]
 +
[[Category:First Steps]]
 +
[[Category:Official Documentation]]

Revision as of 17:45, February 22, 2015

What is GNOME?

"GNOME 3 is an easy and elegant way to use your computer. It is designed to put you in control and bring freedom to everybody. GNOME 3 is developed by the GNOME community, a diverse, international group of contributors that is supported by an independent, non-profit foundation." — GNOME

Prerequisites

From a Clean Install

Ensure that the X Window System is installed.

Preparing to emerge

To get your system ready to emerge gnome, first set your system flavor to desktop, and enable the gnome profile mix-in. To accomplish this, do the following:

# eselect profile set-flavor funtoo/1.0/linux-gnu/flavor/desktop
# eselect profile add funtoo/1.0/linux-gnu/mix-ins/gnome

Console: Set profile{{#subobject:|step=|stepCount=1|In recipe=setup,setup-light|+sep=,|action=runcmd|body=# ##i##eselect profile set-flavor funtoo/1.0/linux-gnu/flavor/desktop

  1. ##i##eselect profile add funtoo/1.0/linux-gnu/mix-ins/gnome}}

By enabling the gnome mix-in, various USE and other settings will be optimized to provide you with a pain-free GNOME installation experience.

Emerging

You are provided with two packages that will pull in this desktop environment:

  • gnome
Note

This is the "whole shabang" - pulls in a range of applications made for the gnome desktop environment including a few games, an archive manager, a system monitor, a web browser, a terminal, etc.

  • gnome-light
Note

As the name implies, this pulls in the base minimal you need to get a functioning GNOME Desktop Environment.

GNOME 3.14 from a clean install

gnome

To emerge gnome run the following command

#  emerge gnome

Console: Emerging GNOME

gnome-light

To emerge gnome-light run the following command

#  emerge gnome-light

Console: Emerging a minimal GNOME environment (alternative){{#subobject:|step=|stepCount=2|In recipe=setup-light|+sep=,|action=runcmd|body=# ##i## emerge gnome-light}}

Upgrading from GNOME 3.12

To update either gnome or gnome-light run the following command:

#  emerge -vauDN world

Subsystems

Bluetooth

For bluetooth support, ensure that:

  1. Bluetooth support is enabled in your kernel (using modules is fine).
  2. Your bluetooth hardware is turned on.
  3. Add the bluetooth startup script to the default runlevel, and start it.

This can be done as follows:

# rc-update add bluetooth default
# rc

Once this is done, you should now be able to navigate to Settings -> Bluetooth and turn bluetooth on. The icon next to devices should now animate and you should be able to discover and add devices such as keyboards.

Note

Additional kernel drivers may need to be enabled for certain input devices. For example, for the bluetooth Apple Magic Trackpad, the following option must be enabled in your kernel:

Under Device Drivers-->HID support-->HID bus support-->Special HID drivers:

<M> Apple Magic Mouse/Trackpad multi-touch support

Printing

To enable printing support, add cupsd to the default runlevel:

# rc-update add cupsd default
# rc

You should now be able to navigate to Settings -> Printers and add printers to your system, and print.

Scanning

To enable scanning support, add your user account to the lp group. This will allow your user to access the USB scanner.

Then, emerge xsane, and run it. It should be able to access your scanner.

Finishing Touches

X

Setting up xdm (GUI log-in)

Typically, you will want to use gdm, the GNOME display manager, to log in to GNOME. This will allow you to log in graphically, rather than using the text console.

To enable gdm, edit /etc/conf.d/xdm and set DISPLAYMANAGER to gdm instead of xdm. Then, perform the following steps to add xdm to the default runlevel, and have it start automatically from now on when your system starts:

Note

Funtoo's /etc/init.d/xdm initscript has been modified to start the requisite services dbus, openrc-settingsd and consolekit prior to starting gdm.

#  rc-update add xdm default

Console: Enable the GNOME display manager{{#subobject:|step=|stepCount=3|In recipe=setup|+sep=,|action=runcmd|body=# ##i## rc-update add xdm default}}

Then, if you want to start it now do:

# rc


But you should reboot to avoid having an open login terminal.

Setting up xinitrc (text log-in)

Adding the following to your ~/.xinitrc file is sufficient:

# Fix Missing Applications in Gnome
export XDG_MENU_PREFIX=gnome-

# Properly Launch the Desired X Session
exec ck-launch-session gnome-session

Additionaly, if you need support for different input sources, there is no longer a need to configure IBus or SCIM in your .xinitrc file as GNOME uses IBus natively. Simply configure it in the Control Center under Region & Language.

Automatically Starting Applications at Login

When using an old-fashioned .xinitrc, starting up applications when X starts is relatively easy. When using GDM, this can still be accomplished, by using the ~/.xprofile file. Here's my sample .xprofile to start xflux to dim the screen at night:

xflux -z 87107
Note

Remember to add a & at the end of any command that doesn't return to the shell prompt after running.

games

Gnome has several games that can be added on to your install. By default most games are not included in gnome's emerge.

Users wishing to play games need to be added to the games group:

# gpasswd -a $USER games


game list:

gnome-sudoku
gnome-mastermind
gnome-nibbles
gnome-robots
gnome-chess
gnome-hearts
gnome-mahjongg
gnome-mines
gnome-klotski
gnome-tetravex

game system emulators:

gnomeboyadvance
gnome-mud

Significant Known Issues (Workarounds Available)

FL-1678: Bluetooth interface gives wrong pairing key

FL-1687: Wallpaper corruption when resuming from suspend