Difference between revisions of "Sugar Creation Kit"

From Sugar Labs
Jump to navigation Jump to search
m (→‎Sugar_manual: moved here)
Line 256: Line 256:
 
====[[Sugar_Creation_Kit/sck/liveinst|F16 Sugar install from a booted Live CD/USB with {{Code|liveinst}}]]====
 
====[[Sugar_Creation_Kit/sck/liveinst|F16 Sugar install from a booted Live CD/USB with {{Code|liveinst}}]]====
 
* The Fedora-16-Live-SoaS.iso file is a 443 MB download.  
 
* The Fedora-16-Live-SoaS.iso file is a 443 MB download.  
* Tutorial
+
* '''Tutorial'''
 
: Annotated Screen-shots of an install
 
: Annotated Screen-shots of an install
 
* Installs to 4 GB USB stick or VirtualBox 4 GB hard drive. (The procedure is adaptable for installation to a regular hard drive.)
 
* Installs to 4 GB USB stick or VirtualBox 4 GB hard drive. (The procedure is adaptable for installation to a regular hard drive.)
*Works with f17-Soas with Anaconda reinstall [[Talk:Sugar_Creation_Kit/sck/liveinst#Fedora-17_Install_to_HD_with_liveinst|HD install with F17 SoaS Live CD]]
 
  
 
:
 
:

Revision as of 18:26, 1 February 2012


Sugar Creation Kit DVD

Sugar Creation Kit.png

Download Mirabell.png
Caution, this is a large file, at 3.8 GB


A complete DVD containing all the resources required to create all 3 versions of Sugar-on-a-Stick without requiring Internet access.

Uses:

  • "sneakernet" or behind firewall at school.
  • save bandwidth on servers.
  • download once and distribute copies locally.

Sugar Labs

http://www.sugarlabs.org/
  • Main Sugar Labs introductory page

Get Sugar

Chat login with list of Channels and languages

Click this^ link to enter chat
Pida ayuda a través de este canal #sugar-es Por favor, sea cortés y hacer sus preguntas.
Los voluntarios no pueden estar en línea todo el tiempo.
Sea paciente y permanecer conectado durante varios minutos para ver su respuest 
(utilizar la función de meeting para la traducción de estos artículos)
  • Ask for help on these IRC channels by clicking on either of the above links (English or Spanish)
  • NOTE: there are 4 channels on IRC: #sugar; #sugar-es; #sugar-it; #sugar-de
these channels which use MEETING to do translations between them.
to join enter this in command line of IRC: /join #sugar-it ; /join #sugar-de
Please be courteous and ask your questions.
Volunteers may not be on line all of the time. Be patient and stay connected for several minutes to see their answer.
Read the Floss Manuals first!
Most answers can be found in them

Communication channels

Click this ^ link to access a page with all the means to communicate with Sugar Labs contributors and learners. It includes mailing lists, chat rooms, blogs, forums, Jabber networks, video, mail and telephone contacts.

Translator

the translation server for Sugarlabs
  • Google Translate
Translate text files english<==>spanish
http://translate.google.com/#auto%7Ces

World Time Converter

Tiny URL

What is my IP

Find your IP address

ON-LINE VERSION

An expanded and enhanced listing of Items Included in the SugarCreationKit DVD ver 1.2.3 (see Above)
NOTE: There are newer and additional items on this web page that are not in the SCK DVD.iso

CD.pngUse to Download the elements you need and burn to your own DVD to save Downloading all of the above SCK DVD.iso

Look below to the References section to see how to then convert your customized DVD to an .iso


Introduction to the Sugar Interface Screenshot of f1 with frame showing.png

RECOMMENDED
  • Click on the following links to go to wiki pages of annotated screen-shots that cover these topics:
  • Note: The colored bars on the top and bottom of the following pages contain links to the next wiki page of the tutorial
- (This is not to be confused with the sugarlabs wiki page header)
Introduction to the Sugar Interface
Connecting to the Internet
Copying files with drag and drop
How to use the IRC Application
Annotated screen shots that show you how to use the IRC application
Communicate with other sugar users and developers on IRC
How to use the Chat application
Annotated screen shots that show you how to use the Chat application
A good example of collaboration on a shared activity via a jabber network
Send a file to friend from the Sugar-Journal
A nice way to sent a file to a friend
Backup-Restore_files_from_the_sugar-journal_with_a_2nd_USB-stick
Also works to Save/Retrieve individual files from the sugar-journal that have been copied to a 2nd USB-stick

Introducción a la interfaz de Azúcar Screenshot of f3 Drop-Down.png

Páginas wiki vinculado de Imágenes anotado que cubren estos temas
Introducción a la interfaz de Azúcar
Conexión a Internet
De arrastrar y soltar
Fotos de exportación
Importación / install <activity> archivo. Xo
Pantalla de captura de Screen capture
Cómo usar IRC
Tiros anotados de pantalla que muestran cómo utilizar la aplicación de IRC
Cómo usar Chat
Tiros anotados de pantalla que muestran cómo utilizar la aplicación de Chat

CD.png SCK-USB-MAC-Folder.iso (CD.iso)

108 MB
  • For MacBook Only - This Image contains the same content as SCK-USB (CD.iso) - Listed below
  • Click on screenshots to enlarge
Hit <==(Back) back arrow on browser to return
  • How to USE
  • Download
Download: http://people.sugarlabs.org/Tgillard/SCK-USB-MAC-Folder.iso to Mac Desktop
Open with DiskImageMounter.app - right click
  • Copy "SCK Copy to new SCK USB" (88.6 MB) Folder on Mounted iso to the Mac Desktop
  • Format USB-stick with Disk Utility
  • (Applications/Utilities/Disk Utility.app)
  • Insert 1 GB USB-stick (or larger) into a MAC USB slot

Mac-DiskUtility.JPG

  • Open Disk Utility.app
select USB-stick - Be Careful to select the correct one.
Erase as fat; label="SCK"
  • Close Disk Utility
  • Click on Mounted USB-stick "SCK" on Desktop
  • Copy 7 items in "SCK Copy to new SCK USB" folder
to SCK USB-stick on Desktop (88.6 MB)
  • Open SCK USB-stick on Desktop

Mac-SCK-open.JPG

Click on "Sugar_Creation_Kit.html"
  • Firefox for OSX starts wiki from USB-stick
NO INTERNET Connection required
  • revised Jan 11, 2011

Apple.gif Burning a CD from an .iso file on a Mac

Annotated screen-shots showing how to do it.

CD.png SCK-USB (CD.iso)

103 MB
  • This is an Archive of the Sugar Creation Kit - Most wiki pages were Downloaded on 12/30/2011
A set of Annotated screen shots as .html files with the accompanying folder containing the files for the .html
  • Intended to be used with no internet connection on the XO-1, XO-1.5, SoaS, and Trisquel-Sugar by students/teachers

Firefox-select.png SCK-Sugar Creation Kit.png

Click on XO-1.5 screenshots to enlarge
<===(back) use browser back arrow to return
CAUTION THE LINKS ON THE WIKI PAGES MAY NOT WORK (unless you have a Internet Connection)
This Version works correctly from a USB-stick; The USB-stick should be fat 16/32 and labeled "SCK" (In CAPS)
copy/paste the contents of the CD to this USB-Stick
All .html files have a Blue Bar at the top of the page
Follow the Blue Bar Links to Go Directly to the other pages of the tutorial
Page Links marked with * in front of their name also will work off-line.
Hint: Hit the Browser <== (back) arrow if you need to return to the previous page
  • NO INTERNET connection and are using the CD instead of a USB-stick:
Blue Bars and * links will not work.
Solution:
GO TO the next level folder (0-3) to see the .html Pages using firefox
Use firefox File/open: search for xxxx.html to open each one individually.
  • Contents:
4 levels of .html files from the Sugar Creation Kit wiki page of sugarlabs.org and some (Off-Site) .html files
0-)Sugar Creation Kit Page
SCK_USB_ReadMeFirst.txt - This File
Sugar_Creation_Kit.html - Start firefox here
firefox-6.xo - (see Installation below)
- install this Browser if you are running sugar-desktop; or Soas; XO-1 XO-1.5.
- This Browser is required to fully view these .html pages
Surf-115.xo
restore-4.xo
backup-5.xo
Revison-Hisory
1-) Direct links from the (0) top level Sugar_Creation_Kit.html page - including some (Off-Site) .html files
2-) Community Distribution Pages
3-) Sweets, Sweets Distribution,
  • Uses:
Intended to be run from a 2nd USB (or CD) where there is NO Internet Connection Available.
A usefull set of wiki pages that teach the basic operations of the Sugar-desktop
"sneakernet" with no internet connection
behind firewall at school.
save bandwidth on servers.
Download once and distribute copies locally
  • Problem with Browse and Surf-115 in SoaS and the XO-1
These browsers will not open the accompanying folder containing the files for the .html.
This results in a web page with no links or .png screenshots
Firefox-6.xo does not use or have sugar-journal access.
This means XO-1 security should not be compromised.
Firefox-6.xo has been sucessfully tested on a G1G1 XO-1 runing os508dx (Dextrose2)
  • Installation - This .iso is intended to be burned to a CD
The CD can be used directly or
copy/paste the contents of the CD to a USB-Stick
The USB should be fat 16/32 and labelled "SCK" (In CAPS)
This is necessary for the links in the Blue Bars to work correctly
  • Insert the USB stick in your XO-1 USB slot
Drag drop the Firefox-6.xo file from the 2nd USB-stick to the Journal - Install it
  • To Open Files in Firefox-6.xo
Click on the firefox icon in (f3) Home screen
File/open file: Select the required .html file on the SCK-USB USB-stick
click on the xxxx.html file
  • Firefox-6.xo installed from this USB-stick has been successfully tested viewing the .html web pages on the USB-stick.
  file:///media/SCK/Sugar_Creation_Kit.html used for the following:
  a G1G1 XO-1 running os508dx - (Dextrose2) 
  a XO-1.5 running os874 - (sugar 0.92.1) 
  a ACER ASPIRE ONE N450 Netbook - (Trisquel-5-Sugar) Live CD - NO Internet Connection 
  a ACER ASPIRE ONE N450 Netbook - (f16-SoaS-Pineapple) Live CD - NO Internet Connection 
  MacBookPro i7  VirtualBox 4.1.6 for OSX with install of Trisquel 5-Sugar (Toast) - NO Internet Connection  
  MacBookPro i7  VirtualBox 4.1.6 for OSX with install of Sugar 0.95.1 in Mageia release 2 (no other browser works on this Distro) - NO Internet Connection 

  MacBookPro i7:file:///Volumes/SCK/xxxx.html used so links are broken here
  Does not follow links in firefox for OSX - NO Internet Connection 
  Requires a second SCK-USB-Mac to be edited in gedit with file:///Volumes/SCK/ used for all ( * ) starred links
  Look at :SCK-USB-MAC-Folder.iso above for Mac USB_stick
  • These web page files were created with "save as" - "web page complete" using firefox.
And subsequently edited/revised in gedit.

Revised 05:59 AM, 7 January 2012 (PST)

Introduction to Sugar on a Stick

  • Link to: Sugar on a Stick
Also located on left side of all Wiki pages under Projects

New Sugarlabs Website - Mock Up

This is a mock up of SugarLabs New Website
Under Construction.

Sugar_manual

Another Nice wiki page introducing Sugar

Sugar 0.96 feature list

  • Accepted and Deferred features of next Sugar version

F16 Sugar install from a booted Live CD/USB with liveinst

  • The Fedora-16-Live-SoaS.iso file is a 443 MB download.
  • Tutorial
Annotated Screen-shots of an install
  • Installs to 4 GB USB stick or VirtualBox 4 GB hard drive. (The procedure is adaptable for installation to a regular hard drive.)

f16 Sugar-Desktop Install with a netinstall CD

  • Requires a high speed internet connection.
  • Tutorial
Annotated Screen-shots of an Install
  • Installs to Hard Disk or USB-stick

SugaronastickPineapple.png Sugar on a Stick (SoaS)

  1. Download
  2. Install
  3. Boot
  4. Use
SugaronastickCoconut.png Sugar on a Stick-v7-20120120.10-i686-Live
  • Preliminary Nightly Compose
Boots and most activities work
  • For Testing ONLY
Usb1.png Make a Live USB Duplicator USB
  • Click link for details ^
Requires a 8 GB USB-stick with 2 partitions.
Soas-pineapple.svg Sugar on a Stick v6 Pineapple
(Burn the .iso to a CD and Boot with the resulting CD)
Editable Listing of Activity Compatibility ASLOxo Activity Tests
Soas-coconut.svg Sugar on a Stick v5 Coconut
(Burn the .iso to a CD and Boot with the resulting CD)
Final Version released 10/09/2011
Editable Listing of Activity Compatibility ASLOxo Activity Tests
Soas-mango-lassi.pngSugar on a stick v4 Mango Lassi
(Burn the .iso to a CD and Boot with the resulting CD)
Soas-mirabelle-logo.pngSugar on a stick v3 mirabelle
Logo SoaS 02.png Sugar on a stick v2 Blueberry
http://download.sugarlabs.org/soas/releases/soas-2-blueberry.iso
Logo SoaS 01.pngSugar on a stick v1 Strawberry
http://download.sugarlabs.org/soas/releases/soas-1-strawberry.iso

Spins Archives

(Burn the .iso to a CD and Boot with the resulting CD)

Nightly Composes

Fedora Mirrors List

Hardware Compatibility

EeePC: http://fedoraproject.org/wiki/EeePc
key-to-press-to-access-bios-for-various-oem-and-computer-systems
smolt profiles:http://www.smolts.org/
http://smolts.org/smolt-wiki/Main_Page#Usage
XO-pixelqi Display: http://www.pixelqi.com/
XO-1 Display screen technology

SoaS Installation variations

A collection of install methods

Category:Live USB

A collection of links on how Live USB's are used in different distributions
A-Non-Live (real file structured) USB
This is an example of a dd writable SoaS-v2.img file which produces a fully functional Conventional install on a USB. This is equivalent to a liveinst install to USB.
It was first suggested by bernie in early 2010 as a better alternative to the currently used live USB SoaS file systems with their fragile and limited sized overlay,
  • This functionality is expected to be included in fedora 17.
  • This can also be realized by entering "liveinst" in root sugar terminal.
This is the Anaconda installer for live file systems which installs to the USB with a normal install.
Approximately 2 times as large a USB-stick is required (4GB minimum) as a compressed file system and an overlay are not used.
Notes on Live File Systems
LiveOS image
This page shares some information about the LiveOS design that helps Sugar on a Stick Learners make better use of their disc resources.
  • Clarify writing ISO to USB
(Discussion on what is supported in fedora)
https://fedorahosted.org/fedora-qa/ticket/134
Limited Lifetime of Persistent Overlay
One very important note about using the "primary" persistent overlay for system changes is that due to the way it's currently implemented (as a LVM copy-on-write snapshot),
every single change to it (writes AND deletes) subtracts from its free space, so it will eventually be "used up" and your USB stick will no longer boot.
Because of these limitations, it is advisable to use the system-level persistence sparingly, for configuration changes and important security updates only.
For a truly persistent write-many (vs write-once) overlay, use the --home-size-mb option to create a home directory filesystem image for personal files.
Unlike the primary system overlay image, the home.img can be re-used and loop mounted outside of the liveusb environment.
Cautions with u3 USB sticks
  • USB sticks with u3 partition will not boot with liveusb-creator
  • CAUTION: Formatting the USB-stick will not remove the hidden (virtual CD-ROM drive)
  • How to remove hidden u3 partition
Linux: http://u3-tool.sourceforge.net/
Windoz: Insert u3 Stick then click on tray icon for u3; select delete u3 partition, once it is deleted the USB-stick will work with liveusb-creator
http://en.wikipedia.org/wiki/U3
Commercial source of SoaS-loaded media
  • USB Flash Drives: -4gb-8gb-16gb-32gb (32 and 64-bit PC)
http://www.osdisc.com/cgi-bin/view.cgi/products/usb/fedora
http://www.osdisc.com/cgi-bin/view.cgi/products/usb/fedora/fedora-16-sugar-on-a-stick-4gb-usb-flash-drive-pc.html
Note: Ordered One. In testing; It is Not Persistent -satellit_ 6 December 2011
Long Delay on shutdown as it is "waiting for the CD to be removed from the Drive"
Visible if you hit <esc> on shutdown
  • SDHC Flash Cards: -2gb-4gb-8gb-16gb-32gb (32 and 64-bit PC)
http://www.osdisc.com/cgi-bin/view.cgi/products/usb/fedora/fedora-16-sugar-on-a-stick-4gb-sdhc-flash-card-pc.html
- see listing on site for more -

WiFi

Wifi (Open FirmWare for WiFi networks): http://www.ing.unibs.it/~openfwwf/
http://www.ing.unibs.it/openfwwf/
http://www.h-node.com/wifi/view/en/2/BCM4311--rev-02-/1/1/Broadcom/undef/undef/undef/undef
http://linuxwireless.org/en/users/Drivers/b43#Known_PCI_devices
http://www.h-node.com/wifi/catalogue/en/1/1/undef/undef/yes/undef/undef
http://www.h-node.com/wifi/catalogue/en/1/1/undef/undef/yes/USB/undef
Mesh Networking: http://hothardware.com/News/Nonprofit-Group-Releases-Open-Source-WiFi-Software/

Community Distributions Complete Listing

Introduction to the Sugar Interface ' VirtualBox Appliances
  • Shown here are Linux distributions where sugar is used:
Fedora-small.jpgFedora F13 SoaS, F14 SoaS, f15-gnome3-shell and sugar0.92.1 How to install Sugar packages
Trisquel icon.pngTrisquel Tris 4.0 (Ubuntu 10.04LTS); Tris 4.5 (Ubuntu 10.10); Tris 4.5.1-sugar(Ubuntu 10.10); Tris 5.0 and 5.0-Sugar (Ubuntu 11.04)
Mandriva-small.pngMandriva 2010.2 Mandriva Sugar 0.88.0
Mageia-2011.pngMageia-2-alpha1 Sugar 0.95.1 - (no browser except for firefox-6.xo install)
Debian-small.jpgDebian Debian 6 Sugar 0.88.1; 0.86; 0.84
LMD-small.pngLinux Mint Debian Debian 6 Sugar 0.88.1
Caixa Mágica-small.jpgCaixa Mágica based on Mandriva 2010.1 repositories Sugar 0.88.0
Ubuntu-small.jpgLMD-small.pngUbuntu sweets sugar 0.88.1 or 0.94.1 (and Mint 11)
Suse-small.jpg openSUSE
Tuquito.png tuquito NEW Community Distribution based on Ubuntu 10.10
SugaronastickCoconut.png Sugar on a Stick (SoaS)   Download earlier SoaS versions
Usb1.png USB SoaS-v5 and SoaS-v6 .img files to write to USB with dd (PC and Mac)

CD.png ASLOxo-6

Updated: Added new activities from the sugar-devel list up to: 01/21/2012
  • Use as an off-line "sneaker net"- Download one time and have an off-line library of Sugar-activities on hand.
  • Burn the .iso file to a DVD.
To View tests and compatibility of some of the included Activities (works off-line) on the included Activity_Matrix web page;
Open the Activity_Matrix.html file in the Activity_List Folder on the DVD with Firefox, or in Sugar Browse 129 or Surf 115.
Or.
Copy contents of DVD to a USB-stick and open the USB-stick Activity_Matrix.html file in Sugar Browse 129 or Surf 115. - (Browse 130 does not open it in f17)
Hint: Use search window (_______) on the top bar of USB-stick display that appears when you click on the USB-stick icon in the left bottom corner of the sugar screen.
look for Activity_Matrix.html use open with on the drop down box that appears when you hover over the Activity_Matrix.html file.
  • Suggestion: copy only the activity.xo files that you want to use from the DVD to a (fat 16/32) USB-stick; Insert it and use it to drag-drop install a custom suite of activities to Sugar.
Activities.xo files can be installed by drag-dropping them into the Sugar Journal from a mounted DVD or a USB to which they have been copied.
You can also install and open the activities by clicking on them.

Activities Activities

Click link ^ for more details

Chapters on supporting both old and new toolbars in the same Activity plus using Pootle in MYOSA
Activity Testing
Tested in Various XO-1; XO-1.5; SoaS and other Linux operating systems, in an editable tabular wiki page.
Tested with a XO-1 - (os883 sugar 0.94.1) - Authored by Alan Jhonn Aguiar Schwyn
FileShare
FileShare is an activity that allows the user to share files from their journal.
Note small files can be posted to sites like pastebin for sharing
  • Book: Challenging Programs in Logo
surf browser
  • alternate to sugar-browse
Included in latest f15 sugar 0.92.1 as the main web browser
Works in situations where sugar-browse will not start
Razor-qt Desktop
Firefox/sharemenot
ShareMeNot is a Firefox add-on designed to prevent third-party buttons 
(such as the Facebook “Like” button or the Twitter “tweet” button)
embedded by sites across the Internet from tracking you until you actually click on them.

DVD covers; artwork & screenshots

Sugarlabs mainpage 07.pngFloss Manuals

(Important Manuals on how to use Sugar Applications and Features)

READ THESE FIRST!
(Local ARCHIVE of the.pdf files shown below:)
  • Source Links:
Introduction to Sugar http://en.flossmanuals.net/sugar
como-hacer-una-actividad-sugar
MakeYourOwnSugarActivities Internet Archive Publishing Quality
In PDF, EPUB, Kindle, Daisy, Full Text. DjVu formats
MakeYourOwnSugarActivities-es with corrected index
Introduction to the command line
What is Sugar http://people.sugarlabs.org/Tgillard/floss_manuals/What_is_Sugar_28Oct08.pdf
Browse http://people.sugarlabs.org/Tgillard/floss_manuals/Browse_06Sep08.pdf
Chat http://people.sugarlabs.org/Tgillard/floss_manuals/Chat_09Sep08.pdf
Collaboration http://people.sugarlabs.org/Tgillard/floss_manuals/Collaboration_31Jan10.pdf
SugarCollaboration http://en.flossmanuals.net/ActivitiesGuideSugar/SugarCollaboration
FunWithTheJournal http://people.sugarlabs.org/Tgillard/floss_manuals/Fun_with_the_journal_09Nov10.pdf
Linux Command Line http://people.sugarlabs.org/Tgillard/floss_manuals/Linux-command-line_16Apr09.pdf
ActivitiesGuideSugar-English http://people.sugarlabs.org/Tgillard/floss_manuals/Activitys_Guide-sugar_en_09Nov10.pdf
Record http://people.sugarlabs.org/Tgillard/floss_manuals/Record_06Sep08.pdf
The Terminal http://people.sugarlabs.org/Tgillard/floss_manuals/Terminal_06Sep08.pdf
Turtle Art http://people.sugarlabs.org/Tgillard/floss_manuals/TurtleArt_06Sep08.pdf
Write http://people.sugarlabs.org/Tgillard/floss_manuals/Write_27Sep08.pdf
Reading_and_sugar: http://people.sugarlabs.org/Tgillard/floss_manuals/Reading_and_sugar_28Sep10.pdf
Text to Speech: http://people.sugarlabs.org/Tgillard/floss_manuals/Text_and_Speak_09Nov10.pdf
e-book resources:http://en.flossmanuals.net/e-book-enlightenment/

Open_Education_Resources

  • Open Education Resources (OERs) are digital replacements for textbooks available under some form of Free license, such as Creative Commons

Python Programming

Learn and practice Python programming in your web browser

Replacing_Textbooks - Booki

Replace textbooks
  • Booki
booki user guide
Blog
Booki importing-a-book
FLOSS Manuals WRITE

Khan Academy videos in OGV format

^

  • Re: [IAEP] Khan academy content 04/05/2011
You can download around 1000 of the Khan Academy videos in OGV format
(playable on XO laptops) from Archive.org   Here's an English/Spanish
index of relevant categories
If you're skeptical or haven't seen his videos, his talk sparked a great
discussion about math education on Hacker News:
http://news.ycombinator.com/item?id=2307532 

For more recent videos, including YouTube, there's this media guide:
http://wiki.laptop.org/go/MediaGuide

Regards,
Nick Doiron
Adobe Flash
a proprietary player for Flash media
Flash Player
needed for firefox viewing of Khan academy lectures
Gnash
GNU Flash movie player and as a plugin to Browse is the default Flash player on the XO. It is the free software counterpart to the Adobe Flash player.
Flash Video Replacer

References

How to make your own custom Sugar-Creation_Kit.iso file
(How this DVD was converted to an .iso file)
    1. Collect, annotate and sort the files you want in a folder on your Desktop.
    2. Burn the contents of this folder to a CD or DVD.
    3. Use the following command in Terminal as the root user:
      dd if=/dev/sr0 of=Sugar-Creation-Kit.iso
/dev/sr0 is the device name for your DVD/CD drive
  • Sample output:
         dd if=/dev/sr0 of=Sugar-Creation-Kit.iso
         5555584+0 records in
         5555584+0 records out
         2844459008 bytes (2.8 GB) copied, 232.86 s, 12.2 MB/s
        
  • the resulting .iso file can be sent over the internet or used to make copies by burning to a DVD
copy items between a USB drive and sugar-journal
copy files between the sugar-journal and a 2nd USB-stick
install an <activity>.xo file from a 2nd USB-stick
Guide to GNOME 3 desktop
GNOME 3 release notes
GNOME 3.2 notes
  • Gnome IRC Channels
https://live.gnome.org/GnomeIrcChannels
pulseaudio-fixes-and-workarounds
How to Sugarize an Application
Instructions on how to make a program appear in the (F3) Home view of Sugar as an icon
http://people.sugarlabs.org/Tgillard/sugarize/wiki-sugarize.txt
Running Linux Applications Under Sugar
This seems to be the same script as listed here: Sugarize which has these insructions: How to sugarize a program used with permission: Albert Cahalan's compiled libsugarize file. --Satellit 17:45, 18 January 2012 (EST)
Translated from Spanish with google translate:
There is a special package for an existing program sugarizar X11 using a bash script and a library specially created for it,
here let the package be zipped for download: Sugarizar_software.zip
Just unzip the file and run the script found in the package and you answering the questions,
the script will generate a directory with the activity for sugar, then you should give the required permissions to  each file and directory
as explained in the main page this site and package the directory
to download the activity from the x or directly copy the entire directory to / home / olpc / Activities on the XO.
FSF-How to choose a license for your own work
how-to-mount-and-access-files-in-an-iso-image-on-linux
grub and grub2
how to recover grub and grub2 after installing windows
Re work LiveCD
  • Scheduled for f17 - Under discussion ATM
May affect spins and remixes.
How it works livemedia-creator
Download Methods
There are many alternative methods to install Sugar. The options can be very confusing because of the technical details and features that may be unfamiliar.
This page begins to itemize some of the many options that are available for those interested in learning more about the possibilities.

The Undiscoverable

(The Undiscoverable Features of Sugar)
Features and tips not easily discovered about using Sugar
HTMLDOC
HTMLDOC software, version 1.8.27. HTMLDOC converts Hyper-Text Markup Language ("HTML") input files
into indexed HTML, Adobe® PostScript®, or Adobe Portable Document Format ("PDF") files.

Converting Mediawiki files to DocBook.XML

E-books

calibre is a free and open source e-book library management application developed by users of e-books for users of e-books

Graphic installers

Liveusb Creator
  • Instructions on how to load a Live USB device in Windows, GNU/Linux, and Intel Mac's.
An easy method for Fedora and Windows, however this method does not generate a separate home.img filesystem to conserve the exhaustible OS overlay (see LiveOS image), nor does it copy the livecd-iso-to-disk installation script to the new device to permit generation of a new Live USB device from the first.
Note if graphical liveusb-creator program will not make a bootable USB-stick from an .iso file:
(This can happen if the stick is formatted to fat16 on another PC with a different Operating System.)
Use terminal command :
liveusb-creator --reset-mbr
USB-stick must be formatted: fat16/32; Labeled=LIVE; boot flag set.
(The LIVE label is only required when the device is to be used for a subsequent uncompressed installation to a hard disk.)
UNetbootin
Does not make persistent USB-sticks
LiLi USB Creator
For Windows 7, Vista, XP
GPL3
Makes a persistent USB from
Ubuntu, Fedora, Debian, OpenSUSE, Mint, Slax, CentOS, ArchLinux, Gentoo, PCLinuxOS, Sabayon, BackTrack, Puppy Linux ...
many-linux-tux
pendrivelinux

Expert install methods

Use "dd" command
For ADVANCED USERS ONLY.
to make an install USB from a liveCD .iso file
Use (live).iso and terminal to make bootable USB
Use to install to HD or USB without needing a DVD/CD ROM
Building a bootable Mac USB
(tested on a MacBook Air)
Boot Helper CD's
  • MAC SoaS-3 Mirabelle Boot DISK
soas-3-boot-test.iso (Burn this to a CD and boot with it)
Read Me First & Credits to Programmer
  • MAC SoaS-4 Mango Lassi Boot DISK
soas-4-boot-test (Burn this to a CD and boot with it)
  • rEFIt
rEFIt
burn a bootable rEFIt CD on Mac OS X Used to Boot live USB's in a Mac
rEFIt is a boot menu and maintenance toolkit for EFI-based machines like the Intel Macs.
You can use it to boot multiple operating systems easily, including triple-boot setups with Boot Camp.
It also provides an easy way to enter and explore the EFI pre-boot environment.

Backup and Restore

Sugar-journal
everything but the sugar-journal

QEMU Virtualization

In Gnome terminal:
su
yum install @virtualization
Start (Graphical): Applications/System Tools/Virtual Machine Manager
  • installs soas.iso files to VM HD (with liveinst command in terminal of running Virtual Machine)

BoxGrinder

BoxGrinder creates appliances (also called images) from simple plain text Appliance Definition files.

VMware Player Virtualization

click this link ^ for more details and examples

Download VMware Player (free)

requires registering first but free.

VMware Player Appliances

DEPRECIATED
VMware Player 4.0 will now work with exported Virtual Box appliances (see Below)
It still works with the compressed VMware Player files below
  • VMware Player appliance of SoaS-v3-Mirabelle
Compressed in .zip file
Download
This appliance is ready to run "firstboot" (agree/user name/password/tz/etc)
sugarroot is the root password.
  • VMware Player appliance Trisquel-3 (NEW) 01/05/2011
Compressed in .zip file
download
User=sugar
Password=sugaruser
  • VMware Player appliance Trisquel-4+sugar (NEW) 01/05/2011
Compressed in .zip file
download
User=sugar
Password=sugaruser
  • VMware Player appliance Sugar on a Stick v2 (Blueberry)
Read this first.
download
  • VMware Player appliance of openSUSE-Sugar
Read this first.
download
networking help
how to use

VirtualBox Virtualization

click this link ^ for more details and examples.
scroll down on this page for RECOMMENDED Sugar Appliances

With VirtualBox® one can run Sugar in a window on Microsoft Windows, Intel-based Apple Macintosh, or Linux host computers from a virtual machine (VM) window. VirtualBox overview

replace OSE with Virtualbox and how to set up a USB-stick
VirtualBox.pngSet up MacBook to Open VirtualBox
..automatically when you power it on
Mac OSX Version 10.6.8
  • Open System Preferences/Accounts
use Spotlight:
magnifying glass on right end of top bar
search for "accounts"
Choose System Preferences| Accounts
  • Click on your user
unlock
login Options/
Login Items (to right)
Click Add(+) button to the right of the accounts list
Select an application VirtualBox - Application and click add.
lock
  • Boot Mac
Mac opens directly to VirtualBox VirtualBox Manager
Pointed to VirtualBox Appliance - (the last one used)
You can select another on list
==> Start
  • Now when the MacBook is powered on, it will boot up in VirtualBox pointed at the last Virtual Appliance used
There can be multiple VirtualBox appliances, belonging to individual students/teachers to choose from, on the same Mac.
Nice school set up for 1 Mac with multiple student's Sugar.
easy to archive with export function of VirtualBox - save weekly? backups for each of the students.
To roll back: import the previously exported file - quick and easy
  • Where we need to simplify We need a simple, elegant, Sugar specific UI that is presented to the user when they insert a stick into a running Windows machine.
  • Suggestion-1:
Download the 2 files for VirtualBox import to a 2nd USB stick
On insertion; the contents of the USB stick pop up
 An example:
 f16-live-RC4-Desktop-sugaruser-disk1.vmdk
 f16-live-RC4-Desktop-sugaruser.ovf <==click on this file and it immediately imports into VirtualBox (less than 2 Minutes) 
 (Only the .ovf file icon is highlighted in the USB stick contents)
  • Suggestion-2:
Export the VirtualBox .vdi hard drive to a 2nd USB and create a new machine that uses the .vdi to run
/home/(user)/VirtualBox VMs/ (copy all three files to USB-stick)
Create a new appliance
use pre-existing hard disk
Look for .vdi (on USB-stick)

Trisquel running from Ext USB-stick.png

click on image ^ to enlarge
Use your browser (back) <== arrow to return here
  • This is OS agnostic for a system with an installed VirtualBox 4.1


35px-Activity-write.png
  • When making a new VM, to clear the Sugar Journal of old entries and to avoid identity conflicts among copies of the VM, enter the command rm ~ rf /.sugar in the Terminal activity. Then shutdown the VM. This will clear all Learner information on the VM and let you start with a fresh install. Skipping this will result in collisions in the Neighborhood view of the Jabber network between separate copies of the appliance. Verify the presence of the .sugar directory by entering ls -a in Terminal.
  • When cloning a customized VM, in order to keep the Journal and installed .xo Activities, use rm ~/.sugar/default/owner.key* in the Sugar Terminal, and then shutdown the VM. This leaves the Journal entries and removes only the previous Learner's identity key files.

VirtualBox.pngAll Prebuilt VirtualBox Appliances

click this link ^ to see a complete list of available VirtualBox Appliances
  • Use the ← left________________________ link in the colored bar below
to connect to another part of this Annotated Guide to Sugar
Introduction to the Sugar Interface ' Activity Testing
Try the appliances listed below first.
they are listed with the Recommended version first and older ones below.
VirtualBox.png Download VirtualBox Here
  • Licensing Information.
VirtualBox is released as GPL=> "Freely available for Windows, Mac OS X, Linux and Solaris x-86 platforms."
VirtualBox Extension Pack => "Free for Personal Use, available for Windows, Mac OS X, Linux and Solaris x-86 platforms."
(Extension Pack is required for USB 2 Access.)

Trisquel icon.png Trisquel-5.0-sugar

RECOMMENDED
  • Sugar Desktop ONLY

Trisquel 5.0 is based on the previous Ubuntu release, 11.04 Natty Narwhal.

Sugar 0.94.1
autologon
starts at color selection
use <==(Back) to change name
Auto logon
enter password on restart
User = sugar
password = sugaruser
4-GB Virtual Box hard disc
English and English keyboard
USA-Los Angeles (Pacific timezone)

Trisquel icon.png Trisquel-4.1-sugar

  • Sugar Desktop ONLY
Ubuntu 10.04 LTS with Sugar sweets 0.88.1
Cleared of sugar identity; Starts on Color Selection Screen ( <===(back) to change/ customize name)

Soas-pineapple.svg v6 Pineapple

RECOMMENDED
firstboot has not yet run; so a new user name and password will be set for the gdm login on startup for the first time
Built 11/13/2011 with Virtualbox 4.1.4 for OSX
How Built:
root=sugarroot
4-GB VirtualBox hard disc
English and English keyboard
USA-Los Angeles (Pacific timezone)
download and import 2 files:
http://download.sugarlabs.org/images/VirtualBox/F16-i686_SoaS_CL.ovf
http://download.sugarlabs.org/images/VirtualBox/F16-i686_SoaS_CL-disk1.vmdk

Soas-coconut.svg v5 Coconut

firstboot has not yet run; so a new user name and password will be set for the gdm login on startup for the first time
Built 10/10/2011 with Virtualbox 4.1.4 for OSX
How Built:
root=sugarroot
8-GB VirtualBox hard disc
English and English keyboard
USA-Los Angeles (Pacific timezone)
download and import 2 files:
http://download.sugarlabs.org/images/VirtualBox/Soas_Coconut_i686_CL.ovf
http://download.sugarlabs.org/images/VirtualBox/Soas_Coconut_i686_CL-disk1.vmdk

Soas-mirabelle-logo.png v3 Mirabelle

firstboot has not yet run; so a new user name and password will be set for the gdm login on startup for the first time
How Built:
root=sugarroot
8-GB VirtualBox hard disc
English and English keyboard
USA-Los Angeles (Pacific timezone)
download and import 2 files:
http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.vmdk 533M
http://download.sugarlabs.org/images/VirtualBox/Fedora-13-i686-Live-SoaS-sugaruser.ovf   12K
35px-Activity-write.png
  • Note1:Use the latest version of Oracle VM VirtualBox (3.2_10.8-64453 or later). Some appliances have multiple hard disc controllers and the earlier Sun VirtualBox 3.1 version does not support them.
  • Note2: All appliances were built on a MacBook Air with Oracle VM VirtualBox (3.2.10-r66523) then tested on a Ubuntu installation on an Acer Aspire One Netbook imported into VirtualBox (3.2.10 r66523)
  • Note3:Set ControlPanel/Frame "Edge" slider to far left for easier access to sugar-frame features

Soas-blueberry-logo.png v2 Blueberry

READ FIRST: http://people.sugarlabs.org/Tgillard/soas-2-blueberry_ovf_README_FIRST.txt
Download these three files:
http://people.sugarlabs.org/Tgillard/soas-2-blueberry.vmdk
http://people.sugarlabs.org/Tgillard/soas-2-blueberry.ovf
http://people.sugarlabs.org/Tgillard/soas-2-blueberry.mf

SoaS-remix

SoaS-remix is a bundle of edit-liveos.py and supporting scripts to make testing and use easier. The bundle will change with development. As of 10 February 2011 it contains,

  • edit-liveos.py - the primary remix builder
  • liveos-disk-to-iso - a Bash launcher script for edit-liveos.py
  • fs2.py, live2.py, creator2.py - temporary modules from livecd-tools with pending squashfs-compression_type() functionality

Get the SoaS-remix bundle:

wget http://people.sugarlabs.org/fgrose/SoaS-remix

Sugar on a Stick/Sugar Clone

customize or duplicate Live USB installations
(script files for making a customized Live USB installation self­-replicating)
Update: http://www.mail-archive.com/soas@lists.sugarlabs.org/msg02044.html
Rebuild/Refresh a custom SoaS iso from a running stick

Possible Use Cases

(from Wiki Page)

Curriculum packaging
  1. A teacher wants to prepare a SoaS image with a custom set of installed Activity bundles or a Journal of Activity instances for an upcoming class term.
  2. The teacher modifies their current working image by adding or deleting Activity bundles from their Home view and adding or removing Journal entries with specific content
   (such as a Physics model template or Etoys project), even saving distributable ebooks, or bookmarks in Browse Activity instances that are named for specific sets of local web destinations
   (a class portal perhaps for deployments lacking Internet connectivity).
  3. The teacher scrubs out any personal passwords or other history that should not be shared in the new copies.
  4. A fresh or recycled USB stick is inserted into the computer running the customized SoaS image and the SugarClone script is executed. 
Full image backup or sharing
  1. A Learner has modified their environment, perhaps adding Activity bundles and prepared specific instances such as a Activities/Physics simulation.
  2. Their modifications include changes to their operating system installed through yum or RPM to obtain some new core functionality.
  3. The Learner wants to archive or share this image with friends or for a backup.
  4. Personal or private information is scrubbed from the Journal or Browse history and other potential stores.
  5. The User creates one or more Sugar Clones. 

This method of backup has the advantage that it copies Learner changes to the core operating system as well as the Journal. A LiveOS image using a separate persistent home folder could be partially cloned with either the operating system overlay or home folder without the other should that be desired.

SoaS in Parallels for OSX

(experimental)

PPC

Power PC
Doing builds again for fedora 16
  • IRC: #fedora-ppc on irc.freenode.net

OLPC/Sugar as Webserver

copied from Inkyfingers
  • Open Terminal and type the following to install Boa (approx. 100k)
su -
yum -y install boa
  • Now put your index.html in /var/www
  • Find your Sugar Computer/XO's IP Address. Still as root user (having entered su- already), enter into Terminal:
ifconfig
  • Look next to eth0 for 192.168.whatever (for example)
  • Go to another machine on your LAN and type your Sugar Computer/XO's IP Address into your browser. There's your Sugar computer serving up a web page!

Build Your Own Remix with Fedora

Advanced - RECOMMENDED
Make your own Custom CD/DVD.iso with a customized kickstart file
http://trisquel.info/en/wiki/customizing-trisquel-iso
http://wiki.debian.org/DebianCustomCD
http://wiki.mandriva.com/en/Draklive
Ubuntu: https://help.ubuntu.com/community/LiveCDCustomizationFromScratch
Debian: http://wiki.debian.org/Simple-CDD

Advanced Topics

Advanced Methods and Notes
Introduction to the Sugar Interface ' Activity Testing