Line 3: |
Line 3: |
| [[Category:Live USB]] | | [[Category:Live USB]] |
| [[Category:Sugar on a Stick]] | | [[Category:Sugar on a Stick]] |
− | </noinclude>
| |
| | | |
− | == What is Sugar on a Stick? == | + | {{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}__NOTOC__</noinclude> |
| + | |
| + | ==What is Sugar on a Stick?== |
| + | {{:Sugar on a Stick/Downloads}} |
| + | === What's new in Sugar on a Stick? === |
| + | * Sugar [[0.118]], see the [[0.118/Notes|release notes for 0.118]], |
| + | * several updated activities, |
| + | * based on Fedora 35, see the [[fedoradocs:fedora/f34/release-notes/|release notes for Fedora 35]] |
| + | : |
| + | |
| + | ==== Known bugs ==== |
| + | |
| + | * See also [[fedora:Common_F34_bugs|Common Fedora 35 bugs]]. |
| + | |
| + | == Sugar on a Stick installation instructions == |
| + | === MS Windows === |
| | | |
| {| | | {| |
| |- | | |- |
− | | style="border: 0; border-width: 0; width: 350px;" | [[File:SugaronastickMirabelle.png |300px|left|link=http://spins.fedoraproject.org/soas]] | + | |width="160px" valign="top"|[[File:Windows.gif|left|link=Sugar on a Stick/Windows]] |
− | | style="border: 0; border-width: 0;" | '''[[Sugar on a Stick]]''' is a [http://fedoraproject.org Fedora-based] [[wikipedia:Live USB|Live USB]] operating system featuring the award-winning [[What is Sugar?|Sugar Learning Platform]] and designed to fit on an ordinary USB thumbdrive ("stick"). Learn more about [http://spins.fedoraproject.org/soas/#home the project] and the [http://spins.fedoraproject.org/soas/#about principles] behind it at our [http://spins.fedoraproject.org/soas Spin webpage]. The most recent version is version 3, code-named '''[[Sugar on a Stick/Mirabelle|Mirabelle]]''' and was released on '''May 25, 2010.'''
| + | <br><br><br> |
| + | <span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span> |
| + | [[File:USB flash drive.jpg|left|156px|link=Sugar on a Stick/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''' the latest [[Sugar on a Stick/Downloads | Sugar on a Stick]] .iso file.<br><br> |
| + | # '''Load''': Insert a USB flash drive (or SD Card) with 2 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. |
| + | |} |
| | | |
− | '''Turn your computer into a Sugar on a Stick Creation Station:''' A related project is the [[Sugar Creation Kit]], a downloadable DVD which includes the materials you need to create Mirabelle sticks and install additional Activities on it, along with documentation and previous versions of Sugar on a Stick.
| + | Detailed [[Sugar on a Stick/Windows|installation instructions for Windows]] and [[Sugar on a Stick/Boot|booting instructions]] are available. There is also a [[Getting Started/Explore|guide to exploring Sugar]]. |
| + | ---- |
| + | === GNU/Linux === |
| + | {|style="width: 800px;" |
| + | |- |
| + | |width="160px" valign=top|<br><span class="linkgroup">[[File:Gnulinux.png|link=Sugar on a Stick/Linux]] |
| + | <br> |
| + | [[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span> |
| + | [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] |
| + | |valign=top| |
| + | {{:Sugar on a Stick/Linux/Installation}} |
| |} | | |} |
| | | |
− | __TOC__
| + | 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 [[Getting Started/Explore|guide to exploring Sugar]]. |
| + | GNU/Linux users may also want to install the [[#Do_you_use_GNU.2FLinux.3F|Sugar packages]] on their favorite distro, apart from Sugar on a Stick. |
| + | ---- |
| | | |
− | === Want to use Sugar on a Stick? === | + | === Apple Mac OS X === |
| + | {| |
| + | |- |
| + | |width="160px" valign="top"|[[File:Apple.gif|link=Macintosh]] |
| + | <br> |
| + | <span class="linkgroup">[[File:Download Mirabell.png|left|link=Sugar on a Stick/Downloads]]</span> |
| + | [[File:USB flash drive.jpg|156px|link=Sugar on a Stick/Downloads]] |
| + | |valign=top| |
| + | The instructions below are based on the Ubuntu Web page at <http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx>. |
| + | # '''Prepare''': These instructions are for '''32-bit''' and '''64-bit''' processors.<br><br> |
| + | # '''Download''' the latest [[Sugar on a Stick/Downloads|Sugar on a Stick]] .iso file.<br><br> |
| + | # '''Load''': <br>Here is a simple way to load a bootable USB on a Mac.<br> |
| + | ## Enter the Terminal: <code>/Applications/Utilities/Terminal</code>. |
| + | ## Type <code>diskutil list</code>. You should see all the disk drives you have inserted into your computer. |
| + | ## Insert the disk drive to which you want to write Sugar on a Stick. |
| + | ## Type <code>diskutil list</code> again. You should see that your USB drive has been added to the list. If not, wait a while and repeat. |
| + | ## Type <code>hdiutil convert -format UDRW -o <<i>Sugar on a Stick image file</i>>.img <<i>Sugar on a Stick image file</i>></code> to convert the image into a bootable format. |
| + | ## Type <code>sudo diskutil unmountDisk <<i>device name</i>></code> to unmount the disk (it will not be ejected). |
| + | ## Type <code>sudo dd if=<<i>Sugar on a Stick image file</i>>.img.dmg of=<<i>device name</i>> bs=1m</code>. <code>sudo</code> will ask for your password, and then <code>dd</code> will start writing the disk file. |
| + | ## When <code>dd</code> finishes writing the disk file, type <code>sudo diskutil eject <<i>device name</i>></code>. |
| + | # '''Boot''': Insert the USB stick into a USB port on your computer, then reboot and press and hold the Option key while rebooting. You should see a list of all the EFI-recognizable USB drives that can be bootstrapped. If Sugar on a Stick is not one such drive, it cannot be bootstrapped: you need rEFInd (a fork of rEFIt).<br> |
| + | <br> |
| + | :* Have a MacBook? Consider these options: |
| + | ::[[File:Usb1.png|50px]] [[Testing/Reports/Sugar on a Stick#MacBook Persistent SoaS v5 USB EFI Boot|'''MacBook Persistent SoaS v5 USB EFI Boot''']] |
| + | :: [[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]] |
| + | ::[[File:Apple.gif|30px]] [[Tutorials/Installation/Burn_a_CD.iso_on_a_Mac|'''Burning a CD from an .iso file on a Mac''']] |
| + | |} |
| + | |
| + | Alternative [[Macintosh|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 [[Getting Started/Explore|guide to exploring Sugar]]. |
| + | ---- |
| + | |
| + | ===Advanced users=== |
| + | ==Do you have an OLPC XO?== |
| | | |
| {| | | {| |
| |- | | |- |
− | | rowspan="3" style="border: 0; border-width: 0; width: 350px;" | [[File:Cici-maze.jpg |300px|left|link=http://spins.fedoraproject.org/soas]] | + | |width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]] |
− | |- | + | |valign=top| |
− | | | + | * '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]). |
− | |style="border: 0; border-width: 0;" align="center" | [[File:Download Mirabell.png|center|link=http://spins.fedoraproject.org/soas/#downloads]]
| |
− | |-
| |
− | |
| |
− | |If you'd like to try out Sugar on a Stick, check out the [http://spins.fedoraproject.org/soas Sugar on a Stick Spin Page] - it's where our software downloads, installation and usage instructions, and support information lives.
| |
| | | |
− | After you've tried out Sugar on a Stick, we hope you'll come back here and join our community of contributors to help us make the next release even better.
| + | * '''Experiment''' with [[Sugar_on_a_Stick/Installation/OLPC|Updating XOs]] to the latest ''Sugar on a Stick'' release. |
| |} | | |} |
| + | |
| + | <br/><br/> |
| + | ==Some alternate installations== |
| + | * Once you download, and then burn or load a Sugar on a Stick (SoaS) .iso file, and boot it, the running Fedora 34 SoaS Live CD/USB may be used to install Fedora with Sugar to a hard disk or a 4 GB USB stick [[Tutorials/Installation/Install with liveinst|with the '''{{Code|liveinst}} command''']]. |
| + | :- You start with a SoaS LiveOS image, and then load an uncompressed version onto the hard disk or USB stick. |
| | | |
| === Want to contribute to Sugar on a Stick? === | | === Want to contribute to Sugar on a Stick? === |
− |
| |
| {| | | {| |
| |- | | |- |
Line 43: |
Line 110: |
| == New contributors start here! == | | == New contributors start here! == |
| | | |
− | Welcome! We're excited that you want to help us bring the Sugar Learning Platform to children around the world. No prior experience with computers or educational technology is required - in fact, we actively encourage a diversity of backgrounds, ages, and perspectives. See the [[Joining Sugar on a Stick]] page for instructions on how to get started. You may also want to check out the [http://openhatch.org/+projects/Sugar%20on%20a%20Stick Sugar on a Stick project page] on [http://openhatch.org OpenHatch], or attend one of our [[Sugar on a Stick meetings]]. | + | Welcome! We're excited that you want to help us bring the Sugar Learning Platform to children around the world. No prior experience with computers or educational technology is required - in fact, we actively encourage a diversity of backgrounds, ages, and perspectives. See the [[Joining Sugar on a Stick]] page for instructions on how to get started. |
| | | |
| == What can you do? == | | == What can you do? == |
Line 61: |
Line 128: |
| * [http://bugs.sugarlabs.org Fix a bug or add a feature] to an existing Activity, to [[Development Team|sugar-core itself]], or to [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=SoaS&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component Sugar on a Stick]. See [[How to fix an Activity bug]] and [[How to fix a sugar-core bug]] to get started. ''Basic Python programming skills - or the desire to learn - are all that's needed.'' | | * [http://bugs.sugarlabs.org Fix a bug or add a feature] to an existing Activity, to [[Development Team|sugar-core itself]], or to [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=SoaS&order=priority&col=id&col=summary&col=status&col=type&col=priority&col=milestone&col=component Sugar on a Stick]. See [[How to fix an Activity bug]] and [[How to fix a sugar-core bug]] to get started. ''Basic Python programming skills - or the desire to learn - are all that's needed.'' |
| * [https://fedoraproject.org/wiki/Sugar_Activities Package Sugar Activities for Fedora]. ''If you're a [https://fedoraproject.org/wiki/PackageMaintainers/Join Fedora Packager] or want to become one, help in this area is something we desperately need - it's a trickier thing to learn, but rewarding once you get the hang of it.'' | | * [https://fedoraproject.org/wiki/Sugar_Activities Package Sugar Activities for Fedora]. ''If you're a [https://fedoraproject.org/wiki/PackageMaintainers/Join Fedora Packager] or want to become one, help in this area is something we desperately need - it's a trickier thing to learn, but rewarding once you get the hang of it.'' |
− | * [[Sugar on a Stick release process#Review|Review Activities for inclusion in the build]] - check submitted Activities against our [[SoaS Activity Criteria]] and help us choose what gets included in the next release! ''No prior experience needed - we do reviews during our [[Sugar on a Stick meetings|weekly meetings]] and will teach you how.'' | + | * [[Sugar on a Stick release process#Review|Review Activities for inclusion in the build]] - check submitted Activities against our [[Sugar on a Stick/Activity Criteria]] and help us choose what gets included in the next release! ''No prior experience needed.'' |
| * Have an idea for a technical feature that isn't an Activity? Check out our [[Sugar on a Stick release process#Feature process|feature process]]. | | * Have an idea for a technical feature that isn't an Activity? Check out our [[Sugar on a Stick release process#Feature process|feature process]]. |
| | | |
Line 104: |
Line 171: |
| | | |
| == What's happening? == | | == What's happening? == |
| + | ===[[Sugar on a Stick/Beta]]=== |
| | | |
− | === Meetings === | + | === Contributor stories === |
| | | |
− | We have weekly meetings on IRC - see [[Sugar on a Stick meetings]] for more information, including logs from past meetings. Attending a meeting is a great way for newcomers to get started.
| + | To find out what other contributors are doing, check out [http://planet.sugarlabs.org Planet Sugar Labs], where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also [[Sysadmin/Planet syndication request|add your own blog to the Planet]]. |
− | | |
− | === Release schedule ===
| |
| | | |
− | Our release schedule is based on the [[fedora:Releases/Schedule | Fedora release schedule]]. The most recent release was v.3, code-named [[Mirabelle]], shipped on '''May 25, 2010''' and based on the Fedora 13 release schedule. The next Sugar on a Stick version will be based on the [[fedora:Releases/14/Schedule | Fedora 14 release schedule]].
| + | === <s>Meetings</s> === |
| | | |
− | {|border="1" cellspacing="0" width="100%"
| + | Communication through the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] has replaced regular meetings. |
− | |-
| + | :We once had weekly meetings on IRC - see [[Sugar on a Stick meetings]] for more information, including logs from past meetings. |
− | |rowspan="2"| 2010-05-25 || Sugar on a Stick v.3.0 Mirabelle released
| |
− | |-
| |
− | | Planning & Development Begins
| |
− | |-
| |
− | | 2010-07-27 || Feature Freeze (all features have to be ''approved'' and in a satisfying state.)
| |
− | |-
| |
− | | 2010-08-03 || Alpha Change deadline (all changes will have to be ''pushed'' by this time. pending submissions are insufficient.)
| |
− | |-
| |
− | | 2010-08-17 || Alpha Release
| |
− | |-
| |
− | | 2010-09-07 || Beta Change deadline (all changes will have to be ''pushed'' by this time. pending submissions are insufficient.)
| |
− | |-
| |
− | | 2010-09-21 || Beta Release
| |
− | |-
| |
− | | 2010-10-12 || Final Freeze (all changes have to be ''pushed''. no further changes permitted.)
| |
− | |-
| |
− | | 2010-10-14 || Compose Release Candidate
| |
− | |-
| |
− | | 2010-10-26 || Sugar on a Stick v.4.0 Final Release
| |
− | |-
| |
− | |}
| |
− | | |
− | === Contributor stories ===
| |
− | | |
− | To find out what other contributors are doing, check out [http://planet.sugarlabs.org Planet Sugar Labs], where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also [[Sysadmin/Planet syndication request|add your own blog to the Planet]].
| |
| | | |
| == Related work == | | == Related work == |
Line 145: |
Line 186: |
| While the projects listed below are not part of Sugar on a Stick, we watch them closely and try to work with them when possible (or at least we're trying to learn!) | | While the projects listed below are not part of Sugar on a Stick, we watch them closely and try to work with them when possible (or at least we're trying to learn!) |
| | | |
− | * '''Introduction_to_Soas-v3_Mirabelle:'''[http://wiki.sugarlabs.org/go/Talk:Sugar_Creation_Kit#Introduction_to_Soas-v3_Mirabelle] | + | * For deployments lacking easy Internet access, one can turn a computer into a '''Sugar on a Stick Creation Station'''. The [[Sugar Creation Kit]] includes the materials you need to create Live USB sticks sticks and to install additional Activities, along with documentation and previous versions of Sugar on a Stick. |
− | * [[Sugar_on_a_Stick/Installation/Variations#SugarCreationKit_DVD|SugarCreationKit DVD]] - Complete DVD containing all the resources required to create all 3 versions of Sugar-on-a-Stick without requiring Internet access
| + | * Older [[:Category:Live USB|portable Sugar distributions]] based on other Linux distributions . |
− | * Other [[:Category:Live USB|portable Sugar distributions]] - Live USB work based on other Linux distributions. | |
| * [[The undiscoverable]] is an unofficial FAQ for tips, tricks, and solutions to common problems that may otherwise be tricky to find. These are being considered for inclusion in the official SoaS documentation. | | * [[The undiscoverable]] is an unofficial FAQ for tips, tricks, and solutions to common problems that may otherwise be tricky to find. These are being considered for inclusion in the official SoaS documentation. |
| | | |
− | == Previous versions and subpage index == | + | == Previous versions and other subpages index == |
− | {{Show|Earlier versions of Sugar on a Stick can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick}}}} | + | {{Show|Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick/}}}} |