Changes

Jump to navigation Jump to search
8,992 bytes added ,  13:08, 16 February 2022
Line 1: Line 1: −
<noinclude>{{GoogleTrans-en | es =show | bg =show | zh-CN =show | zh-TW =show | hr =show | cs =show | da =show | nl =show | fi =show | fr =show | de =show | el =show | hi =show | it =show | ja =show | ko =show | no =show | pl =show | pt =show | ro =show | ru =show | sv =show }}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}
+
<noinclude><!--{{ Translations | [[Sugar_on_a_Stick|english]] &#124; [[Sugar_on_a_Stick/lang-es|español]] &#124; [[Sugar_on_a_Stick/lang-fr|français]]}}-->
{{TOCright}}
+
[[Category:Project]]
[[Image:Soas.jpg|thumb]] [[Image:Soas-1.png|thumb]]
+
[[Category:Live USB]]
 +
[[Category:Sugar on a Stick]]
   −
== Introduction ==
+
{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792}}__NOTOC__</noinclude>
   −
Sugar offers ubiquitous access for students in a new way, on a USB (Universal Serial Bus) memory stick. The Sugar on a Stick project (still in Beta) gives children access to ''their'' Sugar on any computer in their environment with just a USB memory stick. Taking advantage of the Fedora LiveUSB, it's possible to store everything you need to run Sugar on a single USB memory stick (minimum size 1GB). This small USB device can boot into the Sugar learning platform on different computers at home, at school, or at an after school program, bypassing the software on the those computers. In fact, Sugar on a Stick will work even if the computer does not have a hard-drive. With Sugar on a Stick, the learning experience is the same on any computer: at school, at home, at the library, or an after-school center.
+
==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]]
 +
:
   −
You can learn more from [http://www.xconomy.com/boston/2009/02/05/sugar-beyond-the-xo-laptop-walter-bender-on-olpc-sucrose-084-and-sugar-on-a-stick/ Walter Bender's interview with Xconomy], [http://www.olpcnews.com/software/sugar/sugar_on_a_stick_netbooks.html Wayan Vota's video] and [http://www.flickr.com/photos/curiouslee/sets/72157613785006745/ Mike Lee's pictures].
+
==== Known bugs ====
   −
== Project Goals ==
+
* See also [[fedora:Common_F34_bugs|Common Fedora 35 bugs]].
   −
* Sugar on a Stick as 1 to 1 computing in an elementary school
+
== Sugar on a Stick installation instructions ==
* Sugar on a Stick to empower middle and high school students to help test
+
=== MS Windows ===
* Sugar on a Stick for conferences to let people try Sugar and collaborate with other conference participants
     −
== Get Sugar on a Stick ==
+
{|
 +
|-
 +
|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.
 +
|}
   −
We are currently working towards the first SoaS release, with a hard launch date of April 10th, 2009 where Caroline Meeks and Walter Bender will premiere and distribute SoaS at [http://www.ncose.org/node/47 FOSSVT]. What this means is that the current snapshots are still unstable and in testing, and that if you download and try out this software, ''it might not work yet.'' Please download, test, and give feedback - we need your help to make our launch date - please follow the instructions below to grab your copy of it!
+
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}}
 +
|}
   −
=== Downloads ===
+
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.
 +
----
   −
Depending on what you want to do with your SoaS copy, we've several options available for testing.
+
=== 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 &lt;http://www.ubuntu.com/download/desktop/create-a-usb-stick-on-mac-osx&gt;.
 +
# '''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 &lt;<i>Sugar on a Stick image file</i>&gt;.img &lt;<i>Sugar on a Stick image file</i>&gt;</code> to convert the image into a bootable format.
 +
## Type <code>sudo diskutil unmountDisk &lt;<i>device name</i>&gt;</code> to unmount the disk (it will not be ejected).
 +
## Type <code>sudo dd if=&lt;<i>Sugar on a Stick image file</i>&gt;.img.dmg of=&lt;<i>device name</i>&gt; 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 &lt;<i>device name</i>&gt;</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''']]
 +
|}
   −
{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
+
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]].
|-style="background:#787878; color: white;"
+
----
| '''available solution''' || '''current state''' || '''download location'''
+
 
 +
===Advanced users===
 +
==Do you have an OLPC XO?==
 +
 
 +
{|
 
|-
 
|-
| SoaS-1 ''Image'' || post-beta quality || {{SoaS-1 path}}
+
|width="174px"|[[File:OLPCXO.png|middle|link=olpc:Releases]]
|-
+
|valign=top|
| SoaS-2 ''Image'' || pre-beta quality || {{SoaS-2 path}}
+
* '''Upgrade''' to the latest ''[[olpc:Releases]]'' from OLPC (which may require a [[olpc:Activation_and_developer_keys|developer key]]).
|-
+
 
| SoaS-2 ''Virtual Appliance'' || alpha quality || {{SoaS-2 appliance}}
+
* '''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? ===
 +
{|
 
|-
 
|-
 +
| style="border: 0; border-width: 0; width: 350px;" | [[File:SoaS-contributors.jpg |300px|left|link=Sugar_on_a_Stick]]
 +
| style="border: 0; border-width: 0;" |
 +
You're in the right place! This page is a contributors portal to the project, and contains everything you need to get started in becoming part of the Sugar on a Stick community.
 
|}
 
|}
   −
Previous snapshots are provided in the subsequent directories on http://download.sugarlabs.org/soas/.
+
== New contributors start here! ==
   −
=== Creating your stick ===
+
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.
   −
The basics of creating and using a bootable Sugar on a Stick are:
+
== What can you do? ==
#Download a .iso image file containing Sugar on a Stick. 
  −
#Use a Bootable USB creator program to copy the image file to a USB stick.
  −
#Configure the target computer to boot from USB.
     −
Please see the [[/Installation|installation instructions]] for more information, for example regarding multiple platforms.
+
There are three main ways you can contribute to the Sugar on a Stick community. We work closely with our upstreams, [http://sugarlabs.org Sugar Labs] and [http://fedoraproject.org the Fedora Project].
   −
=== Booting your stick ===
+
=== Get Activities on the Stick ===
   −
Once you have created your USB key, you still need to set your target system to boot from USB.
+
{|
 +
|-
 +
| style="border: 0; border-width: 0;" |
   −
The trick is to set the BIOS to boot from USB.  Unfortunately this is slightly different on each computer.  Explore the setup screen for your system (press Esc or F1 while the computer is booting). If you can't figure it out, search Google for information on your computer model's BIOS.
+
We're always looking for help with all aspects of the [[Sugar on a Stick release process]]. Here are a few things you can do:
   −
If you have an older machine unable to boot from USB, you can burn a "Boot Helper" CD using the .iso below. This will start the boot from the CD, then read files from the USB stick:
+
* [[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.''
*:http://people.sugarlabs.org/garycmartin/boot.iso
+
* 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, 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.''
 +
* [[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]].
   −
Or use the Fedora boot CD image:
+
| 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]]
*:http://download.fedora.redhat.com/pub/fedora/linux/releases/10/Fedora/i386/os/images/boot.iso
+
|}
   −
You can also use the "PLoP Boot Manager" to create a boot floppy for machines without the ability to boot from CD or USB, see:
+
=== Get Sticks into Schools ===
*:http://syslinux.zytor.com/wiki/index.php/No_native_BIOS_support
     −
=== Using your stick ===
+
{|
 +
|-
 +
| style="border: 0; border-width: 0; width: 250px;" | [[File:Cici-stick.jpg |200px|left|link=Sugar_on_a_Stick_deployment_process]]
 +
| style="border: 0; border-width: 0;" |
 +
Deployments all over the world need many different types of help as they work through the [[Sugar on a Stick deployment process]] - we need help building resources for all deployments to use, supporting those deployments, and helping new deployments start, as well as gathering stories and feedback from deployments so that we can make the next version of Sugar on a Stick even better.
   −
Once your stick boot, you'll find yourself in your own Sugar environment, ready to play and learn.
+
Some things you can do to help:
   −
For a guide on how to use Sugar, see the [http://en.flossmanuals.net/sugar FLOSSmanuals Sugar Users Guide]. [[olpc:Keyboard_shortcuts]] lists some of the Sugar keyboard shortcuts on a PC keyboard.
+
* ''"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]].
 +
* 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.
 +
* 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.
 +
|}
   −
==Report Bugs==
+
=== Get Contributors ===
   −
Please keep notes on which version of Sugar on a Stick you have downloaded when reporting issues.
+
{|
 +
|-
 +
| style="border: 0; border-width: 0;" |
   −
* When booting SoaS, you'll see for a short time a screen showing a kind of solar system.
+
Contributors are the lifeblood of the Sugar on a Stick community - we work hard to bring a playful mindset of teaching, learning, and meaningful work to the children we aim to reach, and we aim to keep that mindset in our own work and community as well. Welcoming and teaching new contributors or all types, building the resources they need, and teaching them how to empower others in their turn is one of the most important things you can do; it is ''everyone's'' responsibility to help build our community, one person at a time.
* Press the "Escape" button here and you'll get to the boot menu.
  −
* There, you should find the images name in the following structure: ''Soas[version number}-{date of creation}''
     −
Alternatively, you can also refer to the name of the .iso file, if you still have it around.
+
Some things you can do:
   −
To find out which version of Sugar you are using you can look it up in the 'About my Computer' Section in the Control Panel.  
+
* Edit this page and [[Joining Sugar on a Stick]]. Is there something we could do to make the "getting started" process easier? You don't have to ask permission to edit; just do it!
 +
* Help us fill in our remaining task-starter pages: [[Sugar on a Stick release process]], [[How to fix an Activity bug]], [[How to fix a sugar-core bug]], and [[Sugar on a Stick deployment process]]/
 +
* [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).
 +
* 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!
   −
Report bugs to http://dev.sugarlabs.org/. Use the "SoaS" component when entering new bugs. 
+
| style="border: 0; border-width: 0; width: 200px;" |[[Image:Cici-netbook.jpg|200px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick]]
 +
|}
   −
===Testing===
+
== What's happening? ==
 +
===[[Sugar on a Stick/Beta]]===
   −
For testing SoaS, you might want to follow the Sugar [[Smoke_test| Smoke Test]] procedures!
+
=== Contributor stories ===
   −
===Join the development effort===
+
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]].
   −
We are experimenting with the [http://schools.sugarlabs.org/mod/forum/view.php?id=530 Sugar Labs Moodle system] to help in coordinating work on this project. Please consider also joining the Sugar-Devel [http://lists.sugarlabs.org/listinfo/sugar-devel mailing list]!
+
=== <s>Meetings</s> ===
   −
===Roadmap===
+
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.
   −
Review and contribute to plans and schedules on the [[/Roadmap| Project roadmap page]].
+
== Related work ==
   −
== See Also ==
+
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!)
*[[DeploymentTeam/School_Key]] Information on various Sugar on a Stick deployments.
  −
*[[Sugar on a Stick Ubuntu]] An alternate version of Sugar on a Stick which uses Ubuntu as the base system.
  −
*[[Sugar on a Stick VirtualBox]] Instructions for using a preconfigured VirtualBox disk image with Sugar on a Stick.
      +
* 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.
   −
[[Category:Project]]
+
== Previous versions and other subpages index ==
 +
{{Show|Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages: |{{Special:PrefixIndex/Sugar on a Stick/}}}}

Navigation menu