Difference between revisions of "Getting Started"

From Sugar Labs
Jump to navigation Jump to search
(→‎Sugar on Fedora: Separate install and launch)
m (Added a short Oh Sweet!)
 
(23 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
{{Translations  
 
{{Translations  
 
   |[[Getting Started|english]] &#124; [[Getting Started/lang-de|deutsch]] &#124; [[Getting Started/lang-es|español]] &#124; [[Getting Started/lang-fr|français]] &#124; [[Getting Started/lang-pt|português]] }}</noinclude>
 
   |[[Getting Started|english]] &#124; [[Getting Started/lang-de|deutsch]] &#124; [[Getting Started/lang-es|español]] &#124; [[Getting Started/lang-fr|français]] &#124; [[Getting Started/lang-pt|português]] }}</noinclude>
 +
 +
<center>[[File:Sugar-small.png]]</center>
 +
 +
<center><big><big><big>Oh sweet! The Constructionist Learning Environment</big></big></big></center>
  
 
== About Sugar ==
 
== About Sugar ==
  
Sugar is a desktop environment that is an alternative to the ones typically used in Microsoft Windows, Apple's OS X or other GNU/Linux operating systems. It is conceived as a platform upon which children learn with Sugar [[Activities]]. The platform provides mechanisms for [[Collaboration|collaboration]], [[Activities/Portfolio|reflection]], and [[View Source|exploration]]. Sugar Activities cover a broad range of applications: browsing, drawing, composing, writing, programming, etc. See this [http://www.sugarlabs.org/index.php?template=gallery&page=gallery gallery of screenshots].
+
Sugar is a constructionist learning desktop environment that is an alternative to the ones typically used in Microsoft Windows, Apple's OS X or other GNU/Linux operating systems. It is conceived as a platform upon which children learn with Sugar [[Activities]]. The platform provides mechanisms for [[Collaboration|collaboration]], [[Activities/Portfolio|reflection]], and [[View Source|exploration]]. Sugar Activities cover a broad range of applications: browsing, drawing, composing, writing, programming, etc. See this [http://www.sugarlabs.org/index.php?template=gallery&page=gallery gallery of screenshots].
 +
 
 +
<gallery mode="slideshow">
 +
File:Sugarlabs-home-view.png | Sugar Desktop
 +
File:Musicblocks_1.png | MusicBlocks - A sugar Activity
 +
File:Neighborhood_sugarlabs.png | Collaboration on Sugar
 +
</gallery>
  
 
[[Tutorials/Introduction to the Sugar Interface|Introduction to the Sugar Interface]] describes multiple full-screen views: a Home view, from which Activities are launched; a Neighborhood view, where learners can connect to each other through a [[olpc:Community Jabber Servers|Jabber network]]; a Journal view, which can be used as a ''lab notebook''; and the Activity view, where Sugar Activities are run.
 
[[Tutorials/Introduction to the Sugar Interface|Introduction to the Sugar Interface]] describes multiple full-screen views: a Home view, from which Activities are launched; a Neighborhood view, where learners can connect to each other through a [[olpc:Community Jabber Servers|Jabber network]]; a Journal view, which can be used as a ''lab notebook''; and the Activity view, where Sugar Activities are run.
 
 
  
 
Sugar Activities have no Save menu: everything is saved automatically. While the interface uses very little text, additional information is revealed when the user hovers over icons.
 
Sugar Activities have no Save menu: everything is saved automatically. While the interface uses very little text, additional information is revealed when the user hovers over icons.
Line 16: Line 24:
  
 
For an overview of the components composing a Sugar system see the [[Sugar System Stack]].
 
For an overview of the components composing a Sugar system see the [[Sugar System Stack]].
 +
 +
'''Developers''': Those interested in developing Sugar software should visit our [http://developer.sugarlabs.org/ developer documentation website].
 +
  
 
==Getting Sugar==
 
==Getting Sugar==
  
This section aims to be an introductory walkthrough of some of the methods of installing Sugar covered on the page [[Sugar on a Stick/Installation]].
+
<center> <big><big>Where do you want to install sugar? </big></big> </center>
 
 
===Hardware requirements===
 
  
Before you download, you need to know if you can use the 64-bit version. If your computer says on the box or documentation that it is 64-bit, you may use the 64-bit download version of Sugar called  "x86_64". If you have an Intel MacIntosh, you will need the 64-bit x86_64 version.  It is fairly safe to say that PCs above Pentium 2 (commenced production end 1995) and meeting the specification below can run the "i686" version. Sticks made with the "i686" version may be more transferrable between different PCs.
+
<center>(Jump directly to installation, or read through for step-by-step instruction).</center>
 +
<center> '''Quick Links : ''' [[#Hardware requirements]], [[#Sugar Live CD]], [[#Sugar on a Stick]], [[#Sugar on a Virtual_Machine]] </center>
  
Fedora developers reported these minimum requirements for the Fedora 17 distributions.
+
<center><gallery>
: A 400 MHz or faster processor
+
File:Fedora_flat.png|link=Installation#Fedora
: At least 512 MB memory (RAM), 1 GB recommended for best performance.
+
File:Ubuntu_flat.png|link=Installation#Ubuntu
 +
File:Debian_logo.png|link=Installation#Debian
 +
File:Arch-linux-logo.png|link=Installation#Arch_Linux
 +
File:Windows_new.png|link=Installation#Windows
 +
File:Apple_flat.png|link=Installation#Mac_OS
 +
File:Rpi_logo.png|link=Installation#Raspberry_Pi
 +
</gallery></center>
 +
<center>Or scroll down to explore more on the various possibilities of Sugar OS !</center>
  
However by Fedora 19 specifications have risen ( http://docs.fedoraproject.org/en-US/Fedora/19/html/Release_Notes/sect-Release_Notes-Welcome_to_Fedora_.html#hardware_overview ) to:
+
This section aims to be an introductory walkthrough of some of the methods of installing Sugar covered on the pages [[Sugar on a Stick/Installation]] and [[Supported systems]].  
: A 1GHz or faster processor
 
: 1GB System Memory - RAM
 
  
These higher specifications are probably not critical to Sugar on a Stick made by the Fedora Live USB Creator method. However the LiveCD may not boot on a PC with RAM lower than 768 MB, you may encounter an automated check which  causes the boot to abort if insufficient memory is found. [[Sugar_on_a_Stick/Boot#Low_Memory.2C_RAM.2C_Hardware | Sugar on a Stick/Boot #Troubleshooting #Low Memory, RAM, Hardware]] describes a workaround.
+
===Hardware requirements===
  
Lower memory machines may work, the XO-1 runs with 256 MB, but running Sugar from a USB stick in a PC, (x86), environment with 256 MB RAM will be sub-optimal.
+
* 1 GHz or faster processor
 +
* 64-bit Processor
 +
* 1 GB System Memory (RAM)
 +
* The Sugar .iso file from [[Sugar on a Stick/Downloads]]
 +
* 1 GB USB Drive (2 GB Recommended) or a Compact Disk (any)
 +
* A compatible USB or CD port (any)
 +
* USB Boot allowed on the BIOS (older PCs)
  
You will need to ensure the computer you plan to use is capable of booting from CD or USB.
+
If your system requirements fall below those mentioned here, or you would like to check for alternatives, see [[Hardware_Requirements | Detailed Hardware Requirements]]
:On older machines, you will probably need to make a change in the BIOS (see your computer's hardware documentation). Change ''Boot Order'', so that ''Boot from CD'' or ''Boot from USB'' comes before ''Boot from Hard Drive''. Many newer computers detect the USB device as a hard drive, see http://www.pendrivelinux.com/usb-bios-boot-options/
 
  
For SoaS the recommended minimum size of your USB flash drive is 2 GB, although a 1 GB drive will also work.
+
== Installing Sugar ==
 +
Sugar can be installed as an Operating System installed on a Hard Drive, Live CD, or a USB Drive. Alternatively it supports almost all Debian-based and RHEL based Linux Operating Systems, and can be natively installed as a Desktop Environment.
 +
See any of the OSes in [[#Getting Sugar]].  
  
 
===Sugar Live CD===
 
===Sugar Live CD===
Line 50: Line 72:
 
Produce your LiveCD by downloading the Sugar on a Stick .iso image from [[Sugar on a Stick/Downloads]] and burning it onto a blank CD.
 
Produce your LiveCD by downloading the Sugar on a Stick .iso image from [[Sugar on a Stick/Downloads]] and burning it onto a blank CD.
  
Many computers have built in software which will convert and copy, "burn", an .iso image to a blank CD. Windows 7 contains a built-in Disk Image Burner http://windowsteamblog.com/blogs/windowsexperience/archive/2009/04/13/burn-iso-images-natively-in-windows-7.aspx or use a free utility, like [http://www.imgburn.com/ ImgBurn].
+
Many computers have built in software which will convert and copy, "burn", an .iso image to a blank CD. In Windows 8 from the File Manager, right click the .iso file and select 'Burn disc image' from the context menu, or use a free utility, like [http://www.imgburn.com/ ImgBurn].
  
 
To run Sugar, insert your LiveCD into your computer and reboot into Sugar.
 
To run Sugar, insert your LiveCD into your computer and reboot into Sugar.
  
 
===Sugar on a Stick===
 
===Sugar on a Stick===
====Use Fedora Live USB Creator====
+
Sugar on a Stick (aka SOAS) is the USB implementation of Sugar for its portability and efficiency. There are many methods to create a SOAS. The downloaded sugar .iso from [[Sugar on a Stick/Downloads]] is then flashed (a bootable copying process) to a USB. For people who like GUI, there are Fedora Media Writer (Linux/Windows), UNetBootin (Linux, Mac, Windows), Rufus (Windows), etc. For command line interfaces, see ''livecd-iso-to-disk'' on [[Sugar on a Stick/Installation]]
The page [[Sugar on a Stick/Installation]] describes a number of methods of installing Sugar on a Stick. Here we walk through the first and most simple method.
 
 
 
Only the [https://en.wikipedia.org/wiki/Graphical_user_interface Graphical User Interface] is used. The method is suitable for use with a Windows computer. (Fedora Live USB Creator also works on any Fedora system too.)
 
 
 
Have a look at the Fedora program you will use: https://fedorahosted.org/liveusb-creator/
 
 
 
If you are happy you have covered the above, you are ready to follow the instructions on [[Sugar on a Stick/Installation]]
 
 
 
If all has worked, you will shutdown your PC. With the newly written USB stick in a USB port, restart the PC. See [[Sugar on a Stick/Boot]] for extra information.
 
 
 
This method is covered in this screenshot tutorial: [[Tutorials/Installation/Create a SoaS v7 Live USB in Windows]] and in this [http://www.youtube.com/watch?v=ieIj4aECk88 video] of an earlier version of this process.
 
  
==== livecd-iso-to-disk ====
 
 
This is the second method described on the page [[Sugar on a Stick/Installation#with Microsoft Windows]]
 
 
This is a robust method of making a Sugar on a Stick because you are making your LiveUSB from within Sugar, with a LiveCD you have already tested, and all tools are already on the CD.
 
 
You do not have to be a paid up member of the Windows community. If you already run a Linux distribution, but are not sure to what extent it supports Sugar, the livecd-iso-to-disk tool will work on any PC which will launch the LiveCD.
 
 
You may need to spend a bit of time to become familiar with the Sugar environment using your LiveCD, see [[Getting Started/Explore]]. You need to become familiar with the Terminal Activity and how to gain administrative permissions, that is become root.
 
 
For futher background reading, this paragraph from the Fedora wiki describes the livecd-iso-to-disk tools in some detail. http://fedoraproject.org/wiki/How_to_create_and_use_Live_USB#Command_line_method:_Using_the_livecd-iso-to-disk_tool_.28Fedora_only.29
 
 
 
To proceed with livecd-iso-to-disk, full instructions are here, [[Sugar on a Stick/Installation#with Microsoft Windows]], in Method 2, Burn a CD-ROM disc, boot from it, then run the script, livecd-iso-to-disk
 
  
 
===Sugar on a Virtual Machine===
 
===Sugar on a Virtual Machine===
Line 93: Line 90:
 
All VMs have excellent documentation on how to boot an .iso and again it is covered on this page [[Sugar on a Stick/Installation#SoaS on VirtualBox]] and the method to make a Sugar on a Stick from your VM, is covered here [[Sugar on a Stick/Installation#with Microsoft Windows]] in Method 3, Launch a virtual machine with the Sugar on a Stick .iso file, then run the script, livecd-iso-to-disk
 
All VMs have excellent documentation on how to boot an .iso and again it is covered on this page [[Sugar on a Stick/Installation#SoaS on VirtualBox]] and the method to make a Sugar on a Stick from your VM, is covered here [[Sugar on a Stick/Installation#with Microsoft Windows]] in Method 3, Launch a virtual machine with the Sugar on a Stick .iso file, then run the script, livecd-iso-to-disk
  
===Sugar on Fedora===
+
= Projects =  
 
+
== Sugarizer ==
If you have (or create) a computer running the Fedora operating system, Sugar can be installed and launched as follows.
+
Sugarizer is a free/libre learning platform. The Sugarizer UI use ergonomic principles from The Sugar platform, developed for the One Laptop per Child project and used every day by more than 2 million children around the world.
  
'''Installing Sugar'''
+
Sugarizer runs on every device: from Raspberry Pi computers to Android and iOS phones to tablets and to laptops and desktops.
  
Using GUI, from the Applications Menu, Select Administration, Select Software. Enter '''Sugar''' in the search field.
+
Sugarizer includes a bunch of pedagogic activities thought for children, see here for more.
  
Among all the packaged Activities select,
+
Sugarizer is available as:
  
"The emulator for the Sugar Learning Environment" sugar-emulator.''<sub>version-number</sub>''
+
Application: an installable app for every operating system
 +
Web Application: a web application that runs in modern web browsers
  
and/or "Sugar Desktop Environment" sugar-desktop
+
Sugarizer is not a fork of sugar. To know more or to sugarizer, click [[https://github.com/llaske/sugarizer#what-is-sugarizer- here]]
 +
Or try me now here [[http://try.sugarizer.org/]]
  
and any or all of the Activities.  
+
== MusicBlocks ==
 +
Music Blocks is a collection of manipulative tools for exploring fundamental musical concepts in an integrative and fun way.
 +
<gallery mode=packed heights=200px>
 +
File:Mb2.png
 +
File:Mb4.png
 +
</gallery>
 +
Try it right away in your browser : [[https://musicblocks.sugarlabs.org/]]
 +
For more information, check out the [[https://github.com/sugarlabs/musicblocks GitHub repository]] for Installation instructions and other information.
  
'''Or,''' using the command line, in a root terminal, enter
+
== TurtleBlocks ==
 
+
Turtle Art, also known as Turtle Blocks, is an activity with a Logo-inspired graphical "turtle" that draws colorful art based on snap-together visual programming elements. Its "low floor" provides an easy entry point for beginners. It also has "high ceiling" programming, graphics, mathematics, and Computer Science features which will challenge the more adventurous student.
yum install @sugar-desktop  sugar-emulator       
+
Try it now [[https://turtle.sugarlabs.org/]].
+
For more information, check out the [[https://github.com/sugarlabs/turtleart-activity GitHub repository]] for Installation instructions and other information.
'''Launching Sugar'''
 
 
 
With sugar-desktop and sugar-emulator installed you have two ways of running Sugar.
 
 
 
From the Applications Menu, Select Education, Select Sugar
 
:The sugar emulator (also known as Sugar in a Window) will launch.
 
 
 
To launch the Sugar Desktop Environment (also known as a Sugar session) you must reboot.
 
 
 
When you reboot Fedora, at the point where you login, a Sugar entry will now be present in the login prompt, or under "Session Type", or (as shown in the image below) by clicking on the star.
 
 
 
Select "Sugar" within the login prompt, enter you password, and '''Enter''', and the computer will boot into Sugar Desktop Environment.
 
 
 
====Note sugar-emulator does not exist in '''f20'''====
 
* A replacement (sugar-runner?) is still being developed.As a result theree is not Entry in the Education menu for sugar.
 
*To run sugar:
 
root terminal:
 
yum install @sugar-desktop
 
logoff
 
:select sugar from the De (GDM or lightdm) from the star under the password login screen
 
[[File:F20-Beta-TC2_gdm.png|600px]]
 
*enter password
 
:Sugar as a DE will start full screen.
 
  
 
== Please Explore Sugar ==
 
== Please Explore Sugar ==
Line 147: Line 130:
 
== I need more information ==
 
== I need more information ==
  
For help, see [[Find help]].
+
See https://help.sugarlabs.org, the Activity Help provided online.
 
 
See [[Supported systems]].
 
  
The Sugar Labs wiki is a collaboration site for [[Sugar Labs]] teams, the [[Sugar on a Stick]] project alone comprises over 75 pages or sub-pages. For additional information, you might look at [[Sugar on a Stick/Project sitemap]]
+
The Sugar Labs wiki is a collaboration site for [[Sugar Labs]] teams, the [[Sugar on a Stick]] project alone comprises over 75 pages or sub-pages. For an overview of the developing SoaS see [[Sugar on a Stick/Project sitemap]].
  
There is an introductory overview of The Sugar Learning Platform at http://www.sugarlabs.org/. You can also reach this site from the navigation bar along the top of this page, by clicking the tab labeled "web" at the far left end.
+
Find The Sugar Learning Platform Homepage at http://www.sugarlabs.org/.
 
Notice this set of pages also includes an overview sitemap.
 
  
 
==Release notes==
 
==Release notes==

Latest revision as of 02:59, 26 March 2020

Question.png
Please help us improve this page.
Tell us how it could be improved.
english | deutsch | español | français | português HowTo [ID# 103645] 


Sugar-small.png
Oh sweet! The Constructionist Learning Environment

About Sugar

Sugar is a constructionist learning desktop environment that is an alternative to the ones typically used in Microsoft Windows, Apple's OS X or other GNU/Linux operating systems. It is conceived as a platform upon which children learn with Sugar Activities. The platform provides mechanisms for collaboration, reflection, and exploration. Sugar Activities cover a broad range of applications: browsing, drawing, composing, writing, programming, etc. See this gallery of screenshots.

Introduction to the Sugar Interface describes multiple full-screen views: a Home view, from which Activities are launched; a Neighborhood view, where learners can connect to each other through a Jabber network; a Journal view, which can be used as a lab notebook; and the Activity view, where Sugar Activities are run.

Sugar Activities have no Save menu: everything is saved automatically. While the interface uses very little text, additional information is revealed when the user hovers over icons.

Sugar is Free Software. It is developed in Python and runs on a GNU/Linux Kernel, originally from the Fedora Project, and now from a variety of GNU/Linux distributions.

For an overview of the components composing a Sugar system see the Sugar System Stack.

Developers: Those interested in developing Sugar software should visit our developer documentation website.


Getting Sugar

Where do you want to install sugar?
(Jump directly to installation, or read through for step-by-step instruction).
Quick Links : #Hardware requirements, #Sugar Live CD, #Sugar on a Stick, #Sugar on a Virtual_Machine
Or scroll down to explore more on the various possibilities of Sugar OS !

This section aims to be an introductory walkthrough of some of the methods of installing Sugar covered on the pages Sugar on a Stick/Installation and Supported systems.

Hardware requirements

  • 1 GHz or faster processor
  • 64-bit Processor
  • 1 GB System Memory (RAM)
  • The Sugar .iso file from Sugar on a Stick/Downloads
  • 1 GB USB Drive (2 GB Recommended) or a Compact Disk (any)
  • A compatible USB or CD port (any)
  • USB Boot allowed on the BIOS (older PCs)

If your system requirements fall below those mentioned here, or you would like to check for alternatives, see Detailed Hardware Requirements

Installing Sugar

Sugar can be installed as an Operating System installed on a Hard Drive, Live CD, or a USB Drive. Alternatively it supports almost all Debian-based and RHEL based Linux Operating Systems, and can be natively installed as a Desktop Environment. See any of the OSes in #Getting Sugar.

Sugar Live CD

The Sugar LiveCD contains a complete, functioning Sugar distribution and operating system on CD.

The Sugar LiveCD does not alter files already installed on your computer. It returns to its previous state when the LiveCD is ejected and the computer is rebooted. The Sugar LiveCD allows you to temporarily run Sugar; this allows you to explore Sugar and test how Sugar runs on your hardware. Your settings will not be saved between boots, but you can experiment with inserting a USB stick into the computer running the LiveCD, and reading from, and saving work to, the USB stick.

Produce your LiveCD by downloading the Sugar on a Stick .iso image from Sugar on a Stick/Downloads and burning it onto a blank CD.

Many computers have built in software which will convert and copy, "burn", an .iso image to a blank CD. In Windows 8 from the File Manager, right click the .iso file and select 'Burn disc image' from the context menu, or use a free utility, like ImgBurn.

To run Sugar, insert your LiveCD into your computer and reboot into Sugar.

Sugar on a Stick

Sugar on a Stick (aka SOAS) is the USB implementation of Sugar for its portability and efficiency. There are many methods to create a SOAS. The downloaded sugar .iso from Sugar on a Stick/Downloads is then flashed (a bootable copying process) to a USB. For people who like GUI, there are Fedora Media Writer (Linux/Windows), UNetBootin (Linux, Mac, Windows), Rufus (Windows), etc. For command line interfaces, see livecd-iso-to-disk on Sugar on a Stick/Installation


Sugar on a Virtual Machine

The advantage of a Virtual Machine (VM) is that, with the full VM documentation provided online, you follow that documentation to install the VM on your PC or Mac. VirtualBox® is a suitable choice of VM for a first attempt, see their website: https://www.virtualbox.org/

As ever, download the Sugar on a Stick .iso from Sugar on a Stick/Downloads

Open the VM, bind the .iso image to the VM and boot it.

All VMs have excellent documentation on how to boot an .iso and again it is covered on this page Sugar on a Stick/Installation#SoaS on VirtualBox and the method to make a Sugar on a Stick from your VM, is covered here Sugar on a Stick/Installation#with Microsoft Windows in Method 3, Launch a virtual machine with the Sugar on a Stick .iso file, then run the script, livecd-iso-to-disk

Projects

Sugarizer

Sugarizer is a free/libre learning platform. The Sugarizer UI use ergonomic principles from The Sugar platform, developed for the One Laptop per Child project and used every day by more than 2 million children around the world.

Sugarizer runs on every device: from Raspberry Pi computers to Android and iOS phones to tablets and to laptops and desktops.

Sugarizer includes a bunch of pedagogic activities thought for children, see here for more.

Sugarizer is available as:

Application: an installable app for every operating system Web Application: a web application that runs in modern web browsers

Sugarizer is not a fork of sugar. To know more or to sugarizer, click [here] Or try me now here [[1]]

MusicBlocks

Music Blocks is a collection of manipulative tools for exploring fundamental musical concepts in an integrative and fun way.

Try it right away in your browser : [[2]] For more information, check out the [GitHub repository] for Installation instructions and other information.

TurtleBlocks

Turtle Art, also known as Turtle Blocks, is an activity with a Logo-inspired graphical "turtle" that draws colorful art based on snap-together visual programming elements. Its "low floor" provides an easy entry point for beginners. It also has "high ceiling" programming, graphics, mathematics, and Computer Science features which will challenge the more adventurous student. Try it now [[3]]. For more information, check out the [GitHub repository] for Installation instructions and other information.

Please Explore Sugar

and take it out into your community

There are two further pages in the Getting Started set.

Once you are able to launch Sugar, see Getting Started/Explore.
If you can take Sugar out into your school or community, see Getting Started/Presentation for ideas on how to demonstrate it to others.


I need more information

See https://help.sugarlabs.org, the Activity Help provided online.

The Sugar Labs wiki is a collaboration site for Sugar Labs teams, the Sugar on a Stick project alone comprises over 75 pages or sub-pages. For an overview of the developing SoaS see Sugar on a Stick/Project sitemap.

Find The Sugar Learning Platform Homepage at http://www.sugarlabs.org/.

Release notes

Release notes for Sugar 0.121 are available here.

Sugar platform release version cycle: | 0.82 | 0.84 | 0.86 | 0.88 | 0.90 | 0.92 | 0.94 | 0.96 | 0.98 | 0.100 | 0.102 | 0.104 | 0.106 | 0.108 | 0.110 | 0.112 |