|
|
| (79 intermediate revisions by 9 users not shown) |
| Line 1: |
Line 1: |
| − | <noinclude>{{ Translations | [[Downloads|english]] | [[Downloads/lang-es|español]] | [[Downloads/lang-fr|français]] | [[Downloads/lang-no|norsk]] }}__NOEDITSECTION__</noinclude>
| + | me{{ Translations | [[Downloads|english]] | [[Downloads/lang-es|español]] | [[Downloads/lang-fr|français]] | [[Downloads/lang-no|norsk]] }}__NOEDITSECTION__</noinclude> |
| − | {{:Downloads/Landing_page}}
| |
| − | __NOTOC__
| |
| | | | |
| − | <br/><br/>
| |
| | ==Are you new to Sugar?== | | ==Are you new to Sugar?== |
| | + | There are two Live Systems that run Sugar from a USB stick or bootable DVD: |
| | + | * '''[[Sugar on a Stick]]''' based on Fedora, runs on 64-bit PCs and OS/X Macintoshes, OLPC XO and Raspberry Pi, in English only |
| | + | * '''[[Trisquel On A Sugar Toast]]''', runs on 32- and 64-bit PCs and has more Activities and world language support |
| | | | |
| − | The easiest way to get started is to use [[Sugar on a Stick]]. Basic instructions are found below. A more detailed [http://download.sugarlabs.org/soas/docs/creation-kit/ Sugar-on-a-Stick Creation Guide] is also available. (If you already use GNU/Linux, you may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] available from your distro.)
| + | If you have a high-speed Internet connection, '''Fedora with the Sugar graphical learning environment''' may be installed to a hard disk or a a 4 GB USB stick with a [[Tutorials/Installation/Install with netinstall|'''Netinstall CD''']] |
| − | ----
| |
| − | === MS Windows ===
| |
| | | | |
| − | {|
| + | ==Do you use GNU/Linux?== |
| − | |-
| + | {{:Supported distributions}} |
| − | |width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]]
| |
| − | <br><br><br>
| |
| − | <span class="linkgroup">[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]</span>
| |
| − | [[File:USB flash drive.jpg|left|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
| − | |valign=top|
| |
| − | # '''Prepare''': [http://fedorahosted.org/liveusb-creator/#Download Download] the Fedora Live USB Creator from [http://fedorahosted.org/liveusb-creator/#Download FedoraHosted]<br><br>
| |
| − | # '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso.<br><br>
| |
| − | # '''Load''': Insert a USB flash drive (or SD Card) with 1 GB or more of free space into your computer and launch Fedora Live USB Creator to create a Sugar-on-a-Stick bootable image.<br/>'''Note''': Be sure to set the ''persistent storage'' slider to a non-zero value.<br><br>
| |
| − | # '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
| |
| − | |}
| |
| − | | |
| − | Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Explore|guide to exploring Sugar on a Stick]].
| |
| − | ----
| |
| − | === GNU/Linux ===
| |
| − | GNU/Linux users may want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick.
| |
| − | | |
| − | {| | |
| − | |-
| |
| − | |width="160px"|<span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]]
| |
| − | <br>
| |
| − | [[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]</span>
| |
| − | [[File:USB flash drive.jpg|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
| − | |valign=top|
| |
| − | # '''Prepare''': Use this script http://bit.ly/livecd-iso-to-disk to create a bootable image.<br>(You may need to run {{Code|chmod +x tools_livecd-iso-to-disk.sh}} after you download the script to make it executable.) <br>You should have the isomd5sum package installed so that the script can verify the download.<br><br>
| |
| − | # '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick .iso file.<br><br>
| |
| − | # '''Load''': Insert a USB stick of 1 GB or greater capacity. Execute, as the '''root''' user, in the directory where you downloaded the script, in <u>one</u> command with arguments, the following:
| |
| − | #:{{Code|./tools_livecd-iso-to-disk.sh --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home '''/path/to/source'''.iso /dev/sd'''?'''1}}
| |
| − | #: where '{{Code|'''?'''}}' in the final parameter represents the target bootable device node, such as {{Code|sdb1}} or {{Code|sdc1}}, etc. and /path/to/source is the location and name of the .iso file. You can use the {{Code|blkid}} or {{Code|df}} command to get the device node name.<br><br>
| |
| − | # '''Boot''': Insert the USB stick into a USB port on your computer. Set the option to "boot from USB" in your computer's <abbr title="Basic Input/Output System">BIOS</abbr> setup, and then start up the computer.
| |
| − | #* Subsequent USB or SD devices may be installed from a running ''Sugar on a Stick'' image that was installed with the livecd-iso-to-disk script downloaded after 15 February 2011 (but not those installed by other methods) by running this command from a root user Terminal window:
| |
| − | #*:{{Code|/LiveOS/livecd-iso-to-disk --reset-mbr --overlay-size-mb 300 --home-size-mb 175 --delete-home --unencrypted-home /dev/sr0 /dev/sd?1}}
| |
| − | |}
| |
| | | | |
| − | Detailed [[Sugar on a Stick/Linux|installation instructions for GNU/Linux]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Sugar on a Stick/Explore|guide to exploring Sugar on a Stick]].
| + | ===Are you a developer?=== |
| − | ----
| |
| − | === Apple Mac OS X === | |
| − | '''DRAFT''': These instructions are incomplete. Please help with testing and documentation. In the meantime, we recommend the '''[[#Virtual Machines on all platforms|Virtual Machines instructions]]''' below.
| |
| | {| | | {| |
| | |- | | |- |
| − | |width="160px" valign="top"|[[File:Apple.gif|link=Sugar_on_a_Stick/Mac]] | + | |width="174px" valign=top|[[File:Gear.png|link=Development Team]] |
| − | <br>
| + | |Please see this [http://developer.sugarlabs.org/ developer documentation website] for the sugar-build development environment. |
| − | <span class="linkgroup">[[File:Download Mirabell.png|left|link=http://spins.fedoraproject.org/soas/#downloads]]</span>
| |
| − | [[File:USB flash drive.jpg|156px|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
| − | |valign=top| | |
| − | # '''Prepare''': These instructions are only for '''64-bit''' processor machines. (To identify the processor type, choose Apple menu > About This Mac. A small window will appear titled ''About This Mac''. The processor type is displayed in this window. Sugar on a Stick is for the Intel processor only.)<br><br>
| |
| − | # '''Download''': [http://spins.fedoraproject.org/soas/#downloads Download] the Sugar-on-a-Stick iso. Be sure to download a '''64-bit''' image.<br><br>
| |
| − | # '''Load''': <span style="background-color:#f9f6b7; border: 1px solid #c4c295; padding: 10px; padding-left: 5px;">[[File:question.png|link=|middle]] '''Help: Does someone have a simple way to load a Live USB on a Mac?'''</span><br>Here is a simple way to recognize a bootable USB on a Mac.<br>Go to rEFIt (http://refit.sourceforge.net/) and make a bootable cd. There is no need to install rEFIt on your mac. In fact installing rEFIt may make it impossible to upgrade the Mac OS to a newer version later on (personal experience, I had to do a clean install). Put the rEFIt CD in and hold the option key after turning the computer on. The Mac will recognize the CD because it uses EFI and then the CD will recognize the bootable USB.<br>
| |
| − | #* [http://refit.sourceforge.net/doc/c1s5_burning.html How to Burn a rEFIt CD]
| |
| − | #: You can rename the .cdr file to .iso for use in GNU/Linux.
| |
| − | #* [[Sugar_Creation_Kit#Building_a_bootable_Mac_USB|Building and Booting a Live USB on a Mac]]<br><br>
| |
| − | # '''Boot''': Insert the USB stick into a USB port on your computer. '''Is this correct?''': During the startup sound, press and hold the '''c''' key. If the Apple logo appears, Sugar is not booting. Restart and try again.
| |
| − | #* the '''c''' key must be pressed during the startup sound and you must continue to hold it down.
| |
| − | #* you may release the '''c''' key once the Sugar logo appears.<br>
| |
| − | <br>
| |
| − | :* Have a MacBook? Consider these options:
| |
| − | :: [[Community/Distributions/Fedora#Bootable_f15_gnome3_CD_on_MacBook_Pro| Bootable F15 Gnome3 CD on MacBook Pro]]
| |
| − | :: [[Talk:Downloads#Bootable_DVD_of_f14_for_MacBook_Air|Bootable DVD of F14 for MacBook Air]]
| |
| − | :: [[Talk:Downloads#Bootable_CD_of_Trisquel_4.5_for_MacBook_Air|Bootable CD of Trisquel 4.5 for MacBook Air]]
| |
| − | :: See other installation variations at [[Sugar Creation Kit]]
| |
| − | | |
| − | :* Have an iBook or PowerPC Mac?
| |
| − | :: See [[Community/Distributions/Ubuntu/PPC]].
| |
| − | |}
| |
| | | | |
| − | Alternative [[Sugar on a Stick/Mac|installation instructions for Mac OS X]]. Also, [[Sugar_on_a_Stick/Blueberry#For_Mac_OS_X_Users|these older installation instructions]] and [[Sugar on a Stick/Boot|booting instructions]] may be consulted.<br>There is also a [[Sugar on a Stick/Explore|guide to exploring Sugar on a Stick]].
| |
| − | ----
| |
| − | === Advanced users ===
| |
| | | | |
| − | {|
| + | Some additional references you may find useful: |
| − | |-
| + | * See https://github.com/sugarlabs/, |
| − | |width="174px"|[[File:Sugar Creation Kit.png|link=Sugar Creation Kit]]
| + | * [http://git.sugarlabs.org Gitorious source code repository], |
| − | |valign=top|
| + | * The [[Supported systems]] page, |
| − | * '''Explore''' the [[Sugar Creation Kit]]
| + | * [[Platform_Team/Guide/Sweets Usage|Sweets]], to launch Sugar using the Sugar Package Management System, |
| − | | + | * [[Emulator image files|Virtual machine or emulator image files]], |
| − | | + | * Adding Sugar to your [[Sweets_Distribution/Supported_platforms|favorite distro...]] |
| − | * '''Try''' [[Sugar_on_a_Stick/Installation/Variations|customizing]] Sugar on a Stick;
| |
| − | | |
| − | | |
| − | * '''Read''' the [http://download.sugarlabs.org/soas/docs/customization-guide/ detailed Customization Guide]; and | |
| − | | |
| − | | |
| − | * '''Read''' additional instructions for using [[VirtualBox]] and other virtual machines. | |
| − | |}
| |
| − | | |
| − | <br/><br/>
| |
| − | ==Do you have an OLPC XO?==
| |
| − | | |
| − | {|
| |
| − | |-
| |
| − | |width="174px"|[[File:OLPCXO.png|middle|link=Dextrose]]
| |
| − | |valign=top|
| |
| − | * '''Upgrade''' to the latest ''[[olpc:OS_images#Stable_builds|stable OS release]]'' from OLPC (includes Sugar [[0.84]] and GNOME 2.26)
| |
| − | | |
| − | * '''Upgrade''' to ''[[Dextrose |Dextrose Sugar 0.88 with Fedora 11 and GNOME]]'' (requires a [[olpc:Activation_and_developer_keys|developer key]]) | |
| − | | |
| − | * '''Load ''' another one of the [[OLPC:OS images]]
| |
| − | | |
| − | * '''Test''' Sugar 0.92 on Fedora 14 [[OLPC:11.2.0]] | |
| − | *: See this [http://www.mail-archive.com/devel@lists.laptop.org/msg26133.html discussion thread].
| |
| − | | |
| − | * '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release.
| |
| | |} | | |} |
| | | | |
| | <br/><br/> | | <br/><br/> |
| | | | |
| − | ==Do you use GNU/Linux?==
| |
| − |
| |
| − | {|
| |
| − | |-
| |
| − | |width="178px" valign="top"|Select your favorite distribution<br><br><span class="linkgroup">[[File:Gnulinux.png|link=Community/Distributions]]</span>||
| |
| − | {|
| |
| − | |-
| |
| − | |[[Image:Fedora-small.jpg|link=Community/Distributions/Fedora]]<br/>[[Community/Distributions/Fedora|Fedora]]
| |
| − | |-
| |
| − | |[[Image:Debian-small.jpg|link=Community/Distributions/Debian]]<br/>[[Community/Distributions/Debian|Debian]]
| |
| − | |<span class="linkgroup">[[File:Trisquel_icon.png|link=Community/Distributions/Trisquel]]</span><br/>[[Community/Distributions/Trisquel|Trisquel]]
| |
| − | |[[Image:Ubuntu-small.jpg|link=Community/Distributions/Ubuntu]]<br/>[[Community/Distributions/Ubuntu|Ubuntu]]
| |
| − | |-
| |
| − | |align="center"|<span class="linkgroup">[[Image:Mandriva-small.png|link=Community/Distributions/Mandriva]]</span><br/>[[Community/Distributions/Mandriva|Mandriva]]
| |
| − | |align="center"|[[Image:Caixa_M%C3%A1gica-small.jpg|link=Community/Distributions/Magalhães]]<br/>[[Community/Distributions/Magalhães|Caixa Mágica]]
| |
| − | |-
| |
| − | |align="center"|[[Image:Suse-small.jpg|link=Community/Distributions/OpenSUSE]]<br/>[[Community/Distributions/OpenSUSE| openSUSE]]
| |
| − | |[[Image:Suse-small.jpg|link=http://en.opensuse.org/Sugar]]<br/>[http://en.opensuse.org/Sugar openSUSE]||
| |
| − | |-
| |
| − | |align="center"|[[Image:Arch-logo.png|link=http://wiki.archlinux.org/index.php/Sugar]]<br/> [http://wiki.archlinux.org/index.php/Sugar Archlinux]||
| |
| − | |-
| |
| − | |align="center"|[[File:LMD-small.png|link=Community/Distributions/Linux_Mint_Debian]]<br/>[[Community/Distributions/Linux_Mint_Debian|Linux Mint Debian]]
| |
| − | |-
| |
| − | |<span class="linkgroup">[[Image:Altlinux-small.png|link=Community/Distributions/ALTLinux]]</span><br/>[[Community/Distributions/ALTLinux|AltLinux]]
| |
| − | |}
| |
| − | |-
| |
| − | |width="180px" valign="top"|Or try a Live USB version of Sugar
| |
| − | |[[File:Soas-mango-lassi.png|middle|200px|link=Sugar on a Stick/Mango Lassi]], Mango Lassi with Sugar 0.90.3 and Fedora 14 (Laughlin)<br/>or, for brave pioneers, [[Sugar_on_a_Stick/Beta | v6 alpha with Sugar 0.92.2 and Fedora 16 (Verne)]]<br/><span class="linkgroup">[[File:Trisquel_icon.png|link=Trisquel On A Sugar Toast]]</span> Trisquel on a Sugar Toast (Trisquel 3.0 ''Dwyn'')<br/>[[File:Suse-small.jpg|link=http://en.opensuse.org/Education/Live|Education/Live]] OpenSuse Live USB
| |
| − | |}
| |
| − |
| |
| − | <br/><br/>
| |
| | == Virtual Machines on all platforms == | | == Virtual Machines on all platforms == |
| | | | |
| | {| | | {| |
| | |- | | |- |
| − | |width="160px"|[[File:VirtualBox.png|100px|left|link=Sugar Creation Kit/VirtualBox]] | + | |width="160px"|[[File:VirtualBox.png|100px|left|link=Sugar_on_a_Stick/Virtual_machines]] |
| | |valign=top| | | |valign=top| |
| − | ===[[Sugar Creation Kit/VirtualBox|VirtualBox Appliances]] ← recommended === | + | ===[[Sugar Creation Kit/VirtualBox|VirtualBox Appliances]] === |
| | | | |
| | |- | | |- |
| Line 171: |
Line 52: |
| | If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help. | | If you run into problems, you may want to consult the [[Talk:VirtualBox]] page for help. |
| | <br/><br/> | | <br/><br/> |
| − | ==Are you a developer?==
| |
| | | | |
| − | {|
| |
| − | |-
| |
| − | |width="174px" valign=top|[[File:Gear.png|link=Supported_systems]]
| |
| − | |Learn how to get setup on the [[Supported systems]] page.
| |
| − |
| |
| − | Some additional references you may find useful:
| |
| − | * [[Development Team/Jhbuild | jhbuild]]
| |
| − | * [[Platform_Team/Guide/Sweets Usage|sweet build]]
| |
| − | * [http://git.sugarlabs.org Gitorious source code repository]
| |
| − | * [[Emulator image files|Virtual machine or emulator image files]]
| |
| − | * Adding Sugar to your [[Supported systems|favorite distro...]]
| |
| − | |}
| |
| − |
| |
| − | <br/><br/>
| |
| | ==Are you preparing a deployment without Internet access?== | | ==Are you preparing a deployment without Internet access?== |
| | | | |
| Line 194: |
Line 60: |
| | |valign="top"|See [[Sugar Creation Kit]] | | |valign="top"|See [[Sugar Creation Kit]] |
| | |} | | |} |
| − |
| |
| − | <br/><br/>
| |
| | | | |
| | ==Are you looking for Sugar Activities?== | | ==Are you looking for Sugar Activities?== |
