233
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + − </noinclude> − + + + + + + + + + + + + + + + + − + − | style="border: 0; border-width: 0;" | '''[[Sugar_on_a_Stick | Sugar on a Stick]]''' is [[What is Sugar?|Sugar]] packaged in a [http://fedoraproject.org/ Fedora-based] [[wikipedia:Live USB|Live USB]] operating system. It features the award-winning [http://sugarlabs.org Sugar Learning Platform] and is designed to fit on an ordinary USB thumbdrive ("stick"). The [http://spins.fedoraproject.org/about Fedora Spins group] is hosting the build, maintenance, and download environment for Sugar on a Stick. Learn more about [http://spins.fedoraproject.org/soas/#home the project], and the [http://spins.fedoraproject.org/soas/#about principles] behind it, at Fedora's [http://spins.fedoraproject.org/soas main, learner-facing, Spin webpage]. Version 3, the most recent, is code-named '''[[Sugar on a Stick/Mirabelle|Mirabelle]]''' and was released on '''25 May 2010.'''+ + + + + + + + − + + + + + + + + + + + + + + + + + − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − + − |style="border: 0; border-width: 0;" align="center" | [[File:Download Mirabell.png|center|link=http://spins.fedoraproject.org/soas/#downloads]]+ − {{Iframe||http://spins.fedoraproject.org/soas/#downloads|980|600|1}}+ − |- − | − |If you'd like to try out Sugar on a Stick, check out the main [http://spins.fedoraproject.org/soas Sugar on a Stick Spin Page] - it's where our software downloads, usage instructions, and support information lives. [[Sugar on a Stick/Installation |Abbreviated installation instructions]] are available at [[Sugar on a Stick/Installation]], and we welcome your suggestions and contributions for simplifying and clarifying the instructions with visual aids. − 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.+ + + + + + − Line 40:
Line 110: − + Line 56:
Line 126: − + − + + Line 73:
Line 144: − + − + Line 94:
Line 165: − + Line 100:
Line 171: + − + − 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.+ − + − 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]].+ + − '''The schedule below is a draft and has not yet been approved. It will be discussed after the Mirabelle release.'''+ − − {|border="1" cellspacing="0" width="100%" − |- − |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 == − There are other [[:Category:Live USB|portable Sugar distributions]] that have similar goals that you may be interested in checking out. While these projects 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!)+ + + − + − +
→What is Sugar on a Stick?
<noinclude>{{TOCright}}<!--{{ Translations | [[Sugar_on_a_Stick|english]] | [[Sugar_on_a_Stick/lang-es|español]] | [[Sugar_on_a_Stick/lang-fr|français]]}}-->
<noinclude><!--{{ Translations | [[Sugar_on_a_Stick|english]] | [[Sugar_on_a_Stick/lang-es|español]] | [[Sugar_on_a_Stick/lang-fr|français]]}}-->
[[Category:Project]]
[[Category:Project]]
[[Category:Live USB]]
[[Category:Live USB]]
[[Category:Sugar on a Stick]]
[[Category:Sugar on a Stick]]
== 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=Sugar_on_a_Stick/Mirabelle]]
|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=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.
|}
|}
=== Want to use 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}}
|}
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.
----
=== Apple Mac OS X ===
{|
{|
|-
|-
| rowspan="3" style="border: 0; border-width: 0; width: 350px;" | [[File:Cici-maze.jpg |300px|left|link=http://spins.fedoraproject.org/soas]]
|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?==
{|
|-
|-
|
|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]]).
* '''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? ===
{|
{|
|-
|-
== New contributors start here! ==
== New contributors start here! ==
Welcome! We're excited that you want to help us bring the Sugar Learning Platform to chlidren 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? ==
* [[Sugar on a Stick QA|Test Sugar on a Stick]] and help us find bugs and think of ways the project could be better. When you find a bug or think of an enhancement, [[How to file a ticket|file a ticket!]] ''No technical experience required.''
* [[Sugar on a Stick QA|Test Sugar on a Stick]] and help us find bugs and think of ways the project could be better. When you find a bug or think of an enhancement, [[How to file a ticket|file a ticket!]] ''No technical experience required.''
* Help make it easier for others to test Sugar on a Stick by writing [[Sugar on a Stick QA#Test cases|test cases]]. ''If you've run a test case, you can write a test case.''
* Help make it easier for others to test Sugar on a Stick by writing [[Sugar on a Stick QA#Test cases|test cases]]. ''If you've run a test case, you can write a test case.''
* [http://bugs.sugarlabs.org Fix a bug or add a feature] to an existing Activity, or to [[Development Team|sugar-core itself]]. 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]].
| style="border: 0; border-width: 0; width: 150px;" |[[Image:SoaS-netbook-1.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-2.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-3.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]]
| style="border: 0; border-width: 0; width: 150px;" |[[Image:SoaS-netbook-1.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-2.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]][[Image:SoaS-netbook-3.jpg|150px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick_release_process]]
Some things you can do to help:
Some things you can do to help:
* ''"It's a wiki: Edit away!"'' is often said in open source communities. Almost nothing is set in stone and can't be undone. So if you've got ideas how to make instructions clearer and more accessible to our users, just go for it!
* ''"It's a wiki: Edit away!"'' is often said in open source communities. Almost nothing is set in stone and can't be undone. So if you've got ideas how to make instructions clearer and more accessible, just go for it!
* We produce official documentation such as the [http://download.sugarlabs.org/soas/docs/creation-kit/ Creation Kit] or the [http://download.sugarlabs.org/soas/docs/customization-guide/ Customization Guide]. If you've an idea how to make them better, why don't you jump in and create a patch? Creating these nifty text files is simple - instructions live in the [[Sugar_on_a_Stick/Documentation_SOP|Documentation SOP]].
* We produce official documentation such as the [http://download.sugarlabs.org/soas/docs/creation-kit/ Creation Kit] or the [http://download.sugarlabs.org/soas/docs/customization-guide/ Customization Guide]. If you've an idea how to make them better, why don't you jump in and create a patch? Creating these nifty text files is simple - instructions live in the [[Sugar_on_a_Stick/Documentation_SOP|Documentation SOP]].
* A quick, but less pristine, method of customizing a Sugar on a Stick build is available at [[Sugar on a Stick/Sugar Clone]]. More testing and Sugarizing is needed.
* Unofficial documentation for unsupported workarounds for [[Sugar on a Stick/Installation|installation]] and [[Sugar on a Stick/Sugar Clone|customization]] need to be edited, tested, and submitted for approval for official support. Check them out and leave comments and improvements; just jump in and edit the page.
* Interested in starting a deployment or helping a specific one (with anything from pedagogical design to technical support to funding logistics)? Introduce yourself on the deployment lists for [http://lists.sugarlabs.org/ Sugar Labs] and [http://lists.laptop.org/listinfo/ One Laptop Per Child] and we'll get you connected with some teachers on the ground.
* Interested in starting a deployment or helping a specific one (with anything from pedagogical design to technical support to funding logistics)? Introduce yourself on the deployment lists for [http://lists.sugarlabs.org/ Sugar Labs] and [http://lists.laptop.org/listinfo/ One Laptop Per Child] and we'll get you connected with some teachers on the ground.
* We're looking for some people to help us assemble tools for our support team to use. Email the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] if you're interested.
* We're looking for some people to help us assemble tools for our support team to use. Email the [http://lists.sugarlabs.org/listinfo/soas Sugar on a Stick mailing list] if you're interested.
* [http://openhatch.org/+projects/Sugar%20on%20a%20Stick Point out starter tasks on OpenHatch] - fill in questions and ideas for beginner jobs, and point newcomers towards them.
* [http://openhatch.org/+projects/Sugar%20on%20a%20Stick Point out starter tasks on OpenHatch] - fill in questions and ideas for beginner jobs, and point newcomers towards them.
* [http://lists.sugarlabs.org/listinfo/soas Watch for introductions on the mailing list], and send welcome emails to new contributors (copy the list, so we can see what advice a newcomer has gotten so far).
* [http://lists.sugarlabs.org/listinfo/soas Watch for introductions on the mailing list], and send welcome emails to new contributors (copy the list, so we can see what advice a newcomer has gotten so far).
* Hang out with us on IRC: [http://webchat.freenode.net?channels=sugar #sugar]. This is the place where users join when using [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC Activity]. Help them past initial trouble and provide instant help!
* Hang out with us on IRC: [http://webchat.freenode.net?channels=sugar #sugar]. This is where the [http://activities.sugarlabs.org/en-US/sugar/addon/4029 IRC Activity] starts off. Help new joiners past initial questions and provide instant help!
| style="border: 0; border-width: 0; width: 200px;" |[[Image:Cici-netbook.jpg|200px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick]]
| style="border: 0; border-width: 0; width: 200px;" |[[Image:Cici-netbook.jpg|200px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick]]
== What's happening? ==
== What's happening? ==
===[[Sugar on a Stick/Beta]]===
=== Meetings ===
=== 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]].
=== Release schedule ===
=== <s>Meetings</s> ===
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.
== Related work ==
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!)
* 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.
* Older [[:Category:Live USB|portable Sugar distributions]] 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.
== 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/}}}}