From 6b9fa036f5832b43ae2d6bb3b1994091668d95d7 Mon Sep 17 00:00:00 2001 From: Sebastian Dziallas Date: Sat, 22 May 2010 14:47:47 +0000 Subject: get content in shape for the upcoming v3 release --- diff --git a/Creation Kit/en-US/Book_Info.xml b/Creation Kit/en-US/Book_Info.xml index b433e61..73fa904 100644 --- a/Creation Kit/en-US/Book_Info.xml +++ b/Creation Kit/en-US/Book_Info.xml @@ -29,7 +29,7 @@ Sugar on a Stick. - + diff --git a/Creation Kit/en-US/Chapter.xml b/Creation Kit/en-US/Chapter.xml index 2333a20..0013a75 100644 --- a/Creation Kit/en-US/Chapter.xml +++ b/Creation Kit/en-US/Chapter.xml @@ -2,251 +2,242 @@ - Preparation - - This chapter will demonstrate the stages required to prepare Sugar on a Stick on different platforms and guide you through them step by step. Please pay close attention to the instructions to make sure no loss of data occurs. - + Preparation + + This chapter will demonstrate the stages required to prepare Sugar on a Stick on different platforms and guide you through them step by step. Please pay close attention to the instructions to make sure no loss of data occurs. + -
- System Requirements - - Platforms - - - - - - - Platform - Requirements - Notes - - - - - Windows - - - Windows XP or higher - at least 2 GB of free hard disk space - - - older versions may be unsupported - - - Linux - - - Fedora 11 or higher - Ubuntu 8.04 or higher - at least 2 GB of free hard disk space - - - - - older versions may be unsupported - other distributions may be unsupported - the syslinux isomd5sum cryptsetup packages - - - - - Mac - - - Mac OS X 10.6 or higher - at least 2 GB of free hard disk space - - - - - older versions may be unsupported - a python 2.6 installation is required - - - - - -
-
-
- Windows Instructions - - - - - Fedora LiveUSB Creator on Windows - +
+ System Requirements + + Platforms + + + + + + + Platform + Requirements + Notes + + + + + Windows + + + Windows XP or higher + at least 2 GB of free hard disk space + + + older versions may be unsupported + + + Linux + + + Fedora 12 or higher + Ubuntu 8.04 or higher + at least 2 GB of free hard disk space + + + + + older versions may be unsupported + other distributions may be unsupported + the syslinux isomd5sum cryptsetup packages + + + + + Mac + + + Mac OS X 10.6 or higher + at least 2 GB of free hard disk space + + + + + older versions may be unsupported + a python 2.6 installation is required + + + + + +
+
+
+ Windows Instructions + + + + + Fedora LiveUSB Creator on Windows + + + These instructions are intended for use with Windows XP or higher. + + + + + Download the latest Fedora LiveUSB Creator from https://fedorahosted.org/liveusb-creator/ and install it. + + + + + Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte). + + + + + Launch LiveUSB Creator. + + + + + Select Sugar on a Stick v3 Mirabelle in the drop-down menu on the upper-right side to download the liveUSB disk image. Alternatively, download Mirabelle here, then hit the Browse button and select the downloaded file. + + + + + Set the Persistent Storage slider to the maximum. This enables you to save the child's work in Sugar onto the device. + +
+ + Important + + If you repeat this installation on a device after having saved some Sugar work or changes, all Sugar work and changes will be lost. + + + + You may allocate as much storage as there is capacity on your device. You may allocate less than the maximum, if you want to use some of the device storage when not booting Sugar. + +
+ + + + Select your flash drive as the target and click the Create Live USB button. + + + + + Wait for the process to finish, then close the LiveUSB Creator program. + + + + + Stop your flash drive using the Safely Remove Hardware dialog and eject it. + + + +
+ +
+ Linux Instructions + + These instructions are intended for use with current Linux distributions. Supported examples include recent versions of Fedora, as well as of Ubuntu. Due to the numerous distributions out there, we cannot guarantee support for all of them, but are hoping to provide instructions for as many of them as possible and are looking forward to hearing your experiences with other distributions. + +
+ Fedora + + + + Execute this command as root:yum install liveusb-creator + + + + + Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte) and follow . + + + +
+
+ Other Distributions + + For a graphical way of putting SoaS on a USB stick, we recommend using UNetbootin. Since version 393, it is able to create Fedora Live USB sticks, the technology Sugar on a Stick is using. Please feel free + + + - These instructions are intended for use with Windows XP or higher. + Please check the upstream website for the latest version and use either the packages your distribution provides or the generic file. - - - - Download the latest Fedora LiveUSB Creator from https://fedorahosted.org/liveusb-creator/ and install it. - - - - - Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte). - - - - - Launch LiveUSB Creator. - - - - - Select Sugar on a Stick v2 Blueberry in the drop-down menu on the upper-right side to download the liveUSB disk image. Alternatively, download Blueberry here, then hit the Browse button and select the downloaded file. - - - - - Set the Persistent Storage slider to the maximum. This enables you to save the child's work in Sugar onto the device. - -
- - Important - - If you repeat this installation on a device after having saved some Sugar work or changes, all Sugar work and changes will be lost. - - - - You may allocate as much storage as there is capacity on your device. You may allocate less than the maximum, if you want to use some of the device storage when not booting Sugar. - -
- - - - Select your flash drive as the target and click the Create Live USB button. - - - - - Wait for the process to finish, then close the LiveUSB Creator program. - - - - - Stop your flash drive using the Safely Remove Hardware dialog and eject it. - - - -
- -
- Linux Instructions + + - These instructions are intended for use with current Linux distributions. Supported examples include recent versions of Fedora, as well as of Ubuntu. Other distributions might work or require slight adjustments in the process. + Download the Sugar on a Stick image from here. - - - - Download the Sugar on a Stick image from here. - - - - - Install these three packages: syslinux, isomd5sum, and cryptsetup - - - - - Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte). - - - - - Download the installation script: http://download.sugarlabs.org/soas/releases/livecd-iso-to-disk.sh - - - - - Change mode to make the script executable: chmod +x livecd-iso-to-disk.sh - - - - - Unmount the USB flash drive (e.g. sudo umount /dev/sdb1) - - - - - Execute the script with the following command: sudo ./livecd-iso-to-disk.sh --overlay-size-mb 300 soas-2-blueberry.iso /dev/sdb1 - -
- - Important - - To prevent unnecessary data loss, it is important to understand the different elements of the command line you are executing. - - - - In this case, we have assumed the USB device node to be sdb. It is essential that you verify this before continuing. If your USB key contains no partitions, you might also need to drop the number at the end of the USB device node definition. - - - Additionally, you can also increase or decrease the overlay size for storing your data. Keep in mind that executing the command twice will remove the old overlay, and thus your stored files. - - - Note - - You might also want to add the --efi or --xo parameters, depending on later use. The former one is a requirement for booting the stick on a limited number of Macs, the latter one for booting it on OLPC's XO-1. - - -
- - -
-
- Mac Instructions - - - - - Image Writer on Mac - + + - These instructions are intended for use with Mac OS X. Whereas it is possible to prepare Sugar on a Stick on a Mac, the stick will with some certainty only work on normal machines. A definite requirement is the use of a Mac with Intel processor. + Open UNetbootin and plug a USB stick with a size of at least 1G in. - - Note - - This way of preparing Sugar on a Stick does not create a persistant overlay. This means that you will not be able to keep the data you created in Sugar after reboot. - - - - - - Download the Sugar on a Stick image from here. - - - - - Download the image-writer tool for Macs from here. - - - - - Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte). - - - - - Execute the following command in Terminal: cd Downloads; python image-writer-mac soas-2-blueberry.iso - - - Warning - - If you proceed here, your flash drive will be wiped and you will lose all data on it. - - - - - - The script will output a device name; confirm that it matches with your flash drive. - - - -
+ + + + Click on Diskimage and select and open the .iso file you just downloaded for Sugar on a Stick above. + + + + + Select your USB device and click OK to proceed with the creation process. After a couple of minutes, your USB key should be ready. + + + +
+
+
+ Mac Instructions + + + + + Image Writer on Mac + + + These instructions are intended for use with Mac OS X. This does, however, not guarantee that the resulting stick will work on a Mac, but possibly only on Linux or Windows machines. Hence, the Mac platform is not officially supported and instead marked as experimental. + + + Note + + This way of preparing Sugar on a Stick does not create a persistant overlay. This means that you will not be able to keep the data you created in Sugar after reboot. + + + + + + Download the Sugar on a Stick image from here. + + + + + Download the image-writer tool for Macs from here. + + + + + Plug a blank target USB flash drive (or SD Card) into your computer (minimum 1-gigabyte). + + + + + Execute the following command in Terminal: cd Downloads; python image-writer-mac soas-3-mirabelle.iso + + + Warning + + If you proceed here, your flash drive will be wiped and you will lose all data on it. + + + + + + The script will output a device name; confirm that it matches with your flash drive. + + + +
diff --git a/Creation Kit/en-US/Revision_History.xml b/Creation Kit/en-US/Revision_History.xml index e826633..bed1138 100644 --- a/Creation Kit/en-US/Revision_History.xml +++ b/Creation Kit/en-US/Revision_History.xml @@ -6,6 +6,21 @@ + 2 + Sat May 22 2010 + + Sebastian + Dziallas + sdz@sugarlabs.org + + + + Final commits before Mirabelle release + Update creation content for Linux and Mac + + + + 1 Sun Feb 14 2010 diff --git a/Creation Kit/en-US/images/soas-blueberry.png b/Creation Kit/en-US/images/soas-blueberry.png deleted file mode 100644 index 1a0f21f..0000000 --- a/Creation Kit/en-US/images/soas-blueberry.png +++ /dev/null Binary files differ diff --git a/Customization Guide/en-US/Book_Info.xml b/Customization Guide/en-US/Book_Info.xml index c4b4778..76ddabc 100644 --- a/Customization Guide/en-US/Book_Info.xml +++ b/Customization Guide/en-US/Book_Info.xml @@ -6,7 +6,7 @@ A simple guide on how to customize SoaS Sugar on a Stick 3 - 1 + 2 0 @@ -28,7 +28,7 @@ and enables you to do more the open source way. - + diff --git a/Customization Guide/en-US/Revision_History.xml b/Customization Guide/en-US/Revision_History.xml index 2a97e68..b418eda 100644 --- a/Customization Guide/en-US/Revision_History.xml +++ b/Customization Guide/en-US/Revision_History.xml @@ -6,6 +6,20 @@ + 2 + Sat May 22 2010 + + Sebastian + Dziallas + sdz@sugarlabs.org + + + + Final commits before Mirabelle release + + + + 1 Sun Mar 28 2010 diff --git a/Customization Guide/en-US/images/soas-blueberry.png b/Customization Guide/en-US/images/soas-blueberry.png deleted file mode 100644 index 1a0f21f..0000000 --- a/Customization Guide/en-US/images/soas-blueberry.png +++ /dev/null Binary files differ -- cgit v0.9.1