Difference between revisions of "Sugar on a Stick"

From Sugar Labs
Jump to navigation Jump to search
m (mention download page)
m (Fedora 28 update)
(226 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
<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]]}}{{GoogleTrans-en}}{{TeamHeader|Sugar on a Stick|home=Project Home|xbgColor=ffe792|join_label=Get Involved}}</noinclude>
+
<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]]}}-->
−
{| class="wikitable"
+
[[Category:Project]]
−
|<div style="font-size: 1.5em; background: #ffffff; padding: 10px;" align=center>The v1 Strawberry release of Sugar on a Stick is [[Sugar_on_a_Stick/Strawberry| here]]!</div>
+
[[Category:Live USB]]
−
== Introduction ==
+
[[Category:Sugar on a Stick]]
  
−
Sugar on a Stick (SoaS) is a Linux distribution that enables kids to reclaim computers for themselves in a world of computers made and managed for and by adults. SoaS aims to make it easy for local deployers to provide each student with a thumbdrive (stick), which can be booted into the student's personalized Sugar environment from any machine. Thus, SoaS advances in achieving its goal of giving each child in the world access to its free and open source learning environment to create, explore, reflect, and collaborate on any machine - at school, at home, and elsewhere.
+
{{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 version 0.112.0'''
 +
*: More information about this version at [[0.112/Notes]].
 +
* The current release comes with [[Fedora 28]], though Sugar on a Stick does not package all the software of other desktops.
 +
*: See : [https://docs.fedoraproject.org/f28/release-notes/index.html Fedora 28 Release Notes].
  
−
We dream that Sugar will be a platform that lets people from around the world and from various contexts work together on content, activities, and pedagogy, and learn together how to make computers valued and cost-effective learning tools.
+
==== Known bugs ====
 +
* (pending input from users)
 +
* See [[fedora:Common_F28_bugs|Common Fedora 28 bugs]]
  
−
For general questions, please see the [[/FAQ|Frequently Asked Questions (FAQ) page for Sugar on a Stick]]. 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].
+
=== Want to use Sugar on a Stick? ===
−
|<span class="plainlinks">[{{fullurle:Sugar on a Stick/Strawberry}} {{filepath:SugarLabs3x.jpg}}]</span>
+
{|
 +
|-
 +
| style="border: 0; border-width: 0; width: 350px;" | [[File:Cici-maze.jpg |300px|left|link=Sugar_on_a_Stick/Downloads]]
 +
 
 +
|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.
 
|}
 
|}
−
{| class="wikitable"
+
 
−
|<div align=left><span class="plainlinks">[{{fullurle:Development Team/Release/Releases/Sucrose/0.84}} http://wiki.sugarlabs.org/images/thumb/3/30/Soas-1.png/180px-Soas-1.png]</span>
+
=== Want to contribute to Sugar on a Stick? ===
−
|
+
{|
−
'''What's exactly on the Stick''': Taking advantage of the Fedora LiveUSB technology, it's possible to store everything you need to run Sugar on a single USB memory stick. The files coexist with other files the user may have or put on the disk.  Different types of configurations are being designed to offer the options to run virtualizations or emulations and to use virtual machines on existing computers, saving the Sugar Home folder (the learner's work) on the Stick for use at another workstation. Our [[Sugar on a Stick/Resources| resources page]] contains more information about solutions we are working on.</div>
+
|-
 +
| 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.
 
|}
 
|}
−
{{TOCright}}
 
  
−
== Project Values ==
+
== 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.
  
−
Following the ongoing discussion about its goals and visions, an open letter on the future of the project has been written to the community. You can find this letter, as well as the related discussions, in the mailing list's archives: [http://lists.sugarlabs.org/archive/sugar-devel/2009-September/019311.html]
+
== What can you do? ==
  
−
* ''Customizability'' - Deployments, as well as users, should be able to build their own SoaS easily. It is crucial for the success of SoaS to allow modifications and to make the process of creating derivates as easy as possible.
+
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].
−
* ''Deployability'' - SoaS must be easy to deploy. It should take as little effort as possible to get to a working system, both for individual sticks and for bigger deployments in computer labs.
 
−
* ''Local Support'' - We must encourage and foster the growth of local community support for deployments. If we build things in a way that means deployers can't fix most of their own problems, we're doing something wrong.
 
  
−
'''Would you like to help?''' ...this is entirely a volunteer-run effort. Please [[/Getting Involved| get involved]]!
+
=== Get Activities on the Stick ===
  
−
== Getting Sugar on a Stick ==
+
{|
−
Follow the instructions below to download a copy.
+
|-
 +
| style="border: 0; border-width: 0;" |
  
−
'''Requirements:'''
+
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:
−
: You'll need a USB flash drive, with a size of at least 1 GB to install space for saving your work and changes to the system.
 
  
−
'''Notes:'''
+
* [[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 v1 Strawberry'' was announced for immediate availability on 24 June 2009 and is ready for download below. For more instructions and the latest information, please refer to the [[Sugar_on_a_Stick/Strawberry| release notes]].
+
* 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.''
−
: ''Sugar on a Stick v2 Beta'' was released on 30 August 2009 for a joint test day with the Fedora Project and is available, too.
+
* [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.''
−
::It's image can be downloaded from [http://download.sugarlabs.org/soas/releases/soas-2-beta.iso here], as well as the associated [http://download.sugarlabs.org/soas/releases/soas-2-boot.iso boot helper].
+
* [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/Downloads}}
+
* [[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]]
 +
|}
 +
 
 +
=== Get Sticks into Schools ===
  
−
==== Latest experimental builds ====
+
{|
−
'''Remember:''' These builds are alpha quality; that means unstable and likely to frustrate everyone but developers and development testers. A new image structure is currently in development and will be made available soon.
+
|-
−
* The newest snapshot releases of Sugar on a Stick v2 are available from: http://download.sugarlabs.org/soas/snapshots/2/
+
| style="border: 0; border-width: 0; width: 250px;" | [[File:Cici-stick.jpg |200px|left|link=Sugar_on_a_Stick_deployment_process]]
−
* See [[Sugar on a Stick/Linux#SoaS_v2| the wiki]] for specific boot instructions.
+
| 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.
  
−
==== Other Ways ====
+
Some things you can do to help:
  
−
You might be interested in visiting our ''Get Sugar'' [[Downloads| page]], which provides you with different ways of running Sugar. Please note that these ways are totally unsupported by the Sugar on a Stick project, though!
+
* ''"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.
 +
|}
  
−
== Create Your Stick ==
+
=== Get Contributors ===
−
Please select your operating system below to get further instructions. Those instructions are intended for use with the Strawberry release ''only''!
 
  
−
{| class="wikitable:
+
{|
−
|+ '''Released Version: Strawberry'''
 
 
|-
 
|-
−
|<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Strawberry#Windows_Users}} {{filepath:Windows.gif}}]</span>
+
| style="border: 0; border-width: 0;" |
−
|<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Strawberry#Mac_Users}} {{filepath:Apple.gif}}]</span>
+
 
−
|<span class="plainlinks">[{{fullurl:Sugar_on_a_Stick/Strawberry#Linux_Users}} {{filepath:Penguin.png}}]</span>
+
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.
−
|-
+
 
 +
Some things you can do:
 +
 
 +
* 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!
 +
 
 +
| style="border: 0; border-width: 0; width: 200px;" |[[Image:Cici-netbook.jpg|200px|right|link=http://wiki.sugarlabs.org/go/Sugar_on_a_Stick]]
 
|}
 
|}
  
−
Do you have an '''OLPC XO-1'''? Click here: [{{fullurl:Sugar_on_a_Stick/Installation/OLPC}} {{filepath:OLPCXO.png}}]
+
== What's happening? ==
 +
===[[Sugar on a Stick/Beta]]===
  
−
'''Virtual machines:''' You can also run SoaS in a virtual machine. Sugar Labs volunteers are experimenting with [[VirtualBox]], [[VMware]], and [[QEMU]]. Virtual machines emulate computer hardware resources in software and allow your to install and run disc images from different operating systems on a single computer.
+
===[[Sugar_on_a_Stick/Virtual_machines| Sugar Virtual Box Appliances]]===
 +
* Import into VirtualBox
  
−
=== Boot ===
+
=== Contributor stories ===
−
On most modern computers it's possible to set the target computer's [[wikipedia:BIOS|BIOS]] to boot from a USB device.  Unfortunately this process is slightly different on each computer.  Explore the setup screen for your system (usually by pressing '''Esc''', '''F1''', or '''F12''' key while the computer is booting).  If you can't figure it out, search the Internet for information on your computer model's BIOS.
 
  
−
=== Boot Helper CD ===
+
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]].
−
If you have an older machine, or you just want things to immediately work without fussing with the BIOS, 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: http://download.sugarlabs.org/soas/releases/soas-1-boot.iso
 
  
−
Note that when you use this method your USB stick must have the label FEDORA. Name the stick FEDORA '''before''' running liveusb-creator. In Windows, you can rename a disc in the file manager properties window. This ensures the persistent overlay will be used when booting with the "Boot Helper" CD.
+
=== <s>Meetings</s> ===
  
−
=== Use ===
+
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.
  
−
Once your stick boots, you'll find yourself in your own Sugar environment, ready to play and learn.
+
== Related work ==
−
{| class="wikitable"
 
−
|-
 
−
|<span class="plainlinks"> [http://flossmanuals.net/Sugar http://wiki.sugarlabs.org/images/4/40/Sugarlabs_mainpage_07.png]</span>
 
−
| For a guide on how to use Sugar, see the [http://en.flossmanuals.net/sugar FLOSSmanuals Sugar Learners' Guide].
 
−
[[olpc:Keyboard_shortcuts|Keyboard shortcuts]] also lists some of the Sugar keyboard shortcuts on a PC keyboard.<br>
 
−
'''See also some hard-to-find or hidden features''' -- [[The undiscoverable]].
 
−
|}
 
  
−
Finally, please let us know how it goes. You can always [[Sugar_on_a_Stick/Contacts| get in touch]] with us!
+
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!)
  
−
===[[/Subpages| Subpages]]===
+
* 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]] [[Category:Liveusb]]
+
== 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/}}}}

Revision as of 16:24, 5 May 2018


Project Home   ·   Join   ·   Contacts   ·   Resources   ·   FAQ   ·   Roadmap   ·   To Do   ·   Meetings

What is Sugar on a Stick?

SugaronastickAvocado-320px.png
 Sugar on a Stick is a Fedora® Spin operating system featuring the award-winning Sugar Learning Platform.

Sugar on a Stick will run on

  • any 64-bit Notebook, Laptop, or Desktop computer, with a minimum of 1GB RAM, that can run Linux, Windows or macOS, using a USB thumbdrive or stick, as a Live USB,
  • a 32-bit computer with the TOAST version of Sugar (Trisquel on a Sugar Toast). See Trisquel On A Sugar Toast.
  • a Raspberry Pi 2 or 3, using a microSD card, or;
  • any computer as a virtual machine.

You can use Sugar on a Stick to demo Sugar almost anywhere without disturbing the contents of the computer you use, and if people like what they see, you can install Sugar on a Stick to their hard drives or other sticks from the demo stick.

Download Mirabell.png

x86_64 (64-bit)

Download Mirabell.png armhfp Raspberry Pi 2 or 3, see How to install.


Fedora and the Infinity design logo are trademarks of Red Hat, Inc.

What's new in Sugar on a Stick?

  • Sugar version 0.112.0
    More information about this version at 0.112/Notes.
  • The current release comes with Fedora 28, though Sugar on a Stick does not package all the software of other desktops.
    See : Fedora 28 Release Notes.

Known bugs

Want to use Sugar on a Stick?

Cici-maze.jpg
 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.

Want to contribute to Sugar on a Stick?

SoaS-contributors.jpg

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.

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.

What can you do?

There are three main ways you can contribute to the Sugar on a Stick community. We work closely with our upstreams, Sugar Labs and the Fedora Project.

Get Activities on the Stick

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:

SoaS-netbook-1.jpg
SoaS-netbook-2.jpg
SoaS-netbook-3.jpg

Get Sticks into Schools

Cici-stick.jpg

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.

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, just go for it!
  • We produce official documentation such as the Creation Kit or the 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 Documentation SOP.
  • Unofficial documentation for unsupported workarounds for installation and 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 Sugar Labs and 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 Sugar on a Stick mailing list if you're interested.

Get Contributors

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.

Some things you can do:

Cici-netbook.jpg

What's happening?

Sugar on a Stick/Beta

Sugar Virtual Box Appliances

  • Import into VirtualBox

Contributor stories

To find out what other contributors are doing, check out Planet Sugar Labs, where contributors to Sugar Labs and the Sugar on a Stick project aggregate their blogs. You can also add your own blog to the Planet.

Meetings

Communication through the 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 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 other subpages index

Earlier versions of Sugar on a Stick and other project pages can be reviewed at these pages:
Retrieved from "https://wiki.sugarlabs.org/index.php?title=Sugar_on_a_Stick&oldid=101773"