Difference between revisions of "Documentation Team/User Manual"

From Sugar Labs
Jump to navigation Jump to search
(flossmanuals website is dead and gone)
 
(105 intermediate revisions by 12 users not shown)
Line 1: Line 1:
=How To Use Sugar=
+
<noinclude></noinclude>
 +
{{Translations
 +
  | [[Documentation Team/User Manual|english]] &#124; [[Documentation Team/User Manual/lang-es|español]] }}
  
 +
{{Obsolete|This page serves as a historical reference  until it is restructured by a new Documentation Team. (Volunteers needed.)}}
  
===Using the Interface===
 
  
 +
====The Sugar user manual====
 +
{{FlossmanualBlock}}
  
===Launching Activities===
+
==How To Use Sugar==
  
  
===Installing and Deleting Activities===
+
===Using the [[Documentation Team/Glossary#User_Interface_.28UI.29|Interface]]===
  
Sugar Activities
+
====Where's the desktop?====
 +
Sugar is a different desktop environment to what is normally used in Windows, Apple's OS X or other Linux operating systems. One of the first things that a child sees, therefore, is not a hard disk or a trash can&mdash;it’s the other children in the “neighborhood.” Sugar's closest desktop metaphor is the Home view: where the user can see what Activities they are currently using and access the Journal, which acts as a history of usage and allows the user to access files they viewed or applications they ran previously.
  
Linux Activities
+
===Using Activities===
 +
====What is an Activity?====
 +
The program that you run using Sugar are called Activities. Why? Because Sugar, in its departure from the desktop metaphor for computing, is the first serious attempt to create a [[Documentation Team/Glossary|user interface]] that is based on both cognitive and social [[wikipedia:Constructivism_%28learning_theory%29| constructivism]]: an environment where learners engage in authentic exploration and collaboration in the act of learning.
 +
 +
====Starting an Activity====
  
===Connecting To Wireless Networks===
 
  
 +
====Sharing an Activity====
 +
The interface (.85) doesn't show who is an activity until you join it. Apparently, once you join you can also destroy whatever work was there and the owner/starter of the activity would be none the wiser.
 +
:versioning for the activity?
 +
:control over who has access?
 +
[http://www.youtube.com/watch?v=fVWDbmMke9s Here's a video showing the sharing activity in action].
  
===Setting The Clock & Timezone===
+
====Installing and Deleting Activities====
 +
<ol>
 +
*Installing Sugar Activities Using Browse
 +
*Installing/Removing Sugar Activities Using Terminal
 +
*Installing/Removing Linux Applications
 +
*Installing an .xo file
 +
*Installing Sugar Coated Linux Applications
 +
*Windows Applications</ol>
  
 +
===Customizing the Interface===
 +
====Changing an XO's Nickname and Color on Sugar Views====
 +
<ol>Your XO's Nickname and other options can be changed using the [[OLPC:Terminal Activity]]'s command line [[OLPC:Sugar Control Panel]].
 +
</ol>
  
==Develop==
+
====Changing the "XO Guy"====
 +
To change the XO Guy, the symbol in the middle of the Home view (with applications opening around him/her), you have to follow a few steps:
  
===Installing Sugar===
+
*'''Create An Icon''' - You first have to make an icon image and save it as an SVG (Scalable Vector Graphics) file with the name computer-xo.svg. Probably on your Mac or Windows machine. There are instructions on how to do this [http://wiki.laptop.org/go/Making_SVG_Icons_for_Sugar on the OLPC wiki].
 +
*'''Transfer It To Your Computer''' - Copy computer-xo.svg to a USB or SD card and plug it into your OLPC or computer.
 +
*'''Install it''' - Open Terminal and type the following commands to back-up the original icon and copy your new icon into the correct location:
 +
 
 +
su -l
 +
cp /usr/share/icons/sugar/scalable/device/computer-xo.svg /usr/share/icons/sugar/scalable/device/computer-xo.svg.bak
 +
cp /media/<your usb or sd>/computer-xo.svg /usr/share/icons/sugar/scalable/device/computer-xo.svg
 +
 
 +
*Now close terminal and press Ctrl,Alt,Erase.
 +
 
 +
Example of modified icon:
 +
 
 +
[[Image:Screenshotkm7.png‎‎]]
 +
 
 +
 
 +
'''Restoring Icon To Original'''
 +
 
 +
To restore computer-xo.svg back to the original, open terminal and type:
 +
 
 +
su -l
 +
cp /usr/share/icons/sugar/scalable/device/computer-xo.svg.bak /usr/share/icons/sugar/scalable/device/computer-xo.svg
 +
rm /usr/share/icons/sugar/scalable/device/computer-xo.svg.bak
 +
 
 +
Source: http://olpcnews.com/forum/index.php?topic=2157.0
 +
 
 +
====Setting the Clock and Timezone====
 +
 
 +
You may set the date and time as follows:
 +
 
 +
<ol>
 +
 
 +
<li> Connect to the Internet. (For details, see [[Documentation Team/User Manual/Connecting to the Internet]])
 +
 
 +
<li> Open a Linux prompt. (For details, see [[#How do I access a Linux command prompt?|How do I access a Linux command prompt?]] Note that unless you are an advanced user, you should use the Terminal Activity button to open the prompt.)
 +
 
 +
<li> Log in as "root". Assuming you are using the Terminal Activity program, you can log in as root by typing "su -" at the command prompt and pressing the Enter key. Note that as user "root" you have the ability to destroy all software on the XO, so you should end your session as soon as you successfully change the date and time.
 +
 
 +
<li> At the command prompt, enter the following commands:<br>
 +
    <code>/usr/sbin/ntpdate time.nist.gov</code><br>
 +
    <code>/usr/sbin/hwclock --systohc</code>
 +
 
 +
<li> Press the Enter key after each. In response to the ntpdate command, if it successfully contacts this US government official time server, the system will output a line of data displaying the correct date and time.
 +
 
 +
<li> Click the "Stop" icon [[OLPC::Image:Quit.gif]] at the upper right corner of the screen to log out and close the Terminal Activity program.
 +
 
 +
</ol>
 +
 
 +
====How to set the timezone on my laptop====
 +
 
 +
You can set the timezone by typing the [[OLPC:Sugar Control Panel]] command in the [[OLPC:Terminal Activity]].
 +
 
 +
===Sound Control===
 +
 
 +
<ol>
 +
====Disabling the bootup sound====
 +
 
 +
Turn the volume down while the laptop is booting (i.e. before getting into Sugar).
 +
</ol>
 +
 
 +
===Taking Screen Shots===
 +
 
 +
To take a screen shot, typing Alt+1 at the same time will take one and store it in your journal.
 +
 
 +
==Networking & Communications==
 +
 
 +
===Connecting to Wireless Networks===
 +
To some degree, networking is specific to the platform upon which Sugar is running.
 +
<ol>
 +
On the XO-1 laptop, there are three ways to connect to the Internet:
 +
*Wireless access point (Wi-Fi hotspot);
 +
*“School Server” mesh network; or
 +
*“simple” mesh network, which lets you collaborate directly with other XOs.
 +
</ol>
 +
Read [[Documentation Team/User Manual/Connecting to the Internet|Connecting to the Internet]] for detailed instructions.
 +
 
 +
===Connecting to Jabber Servers===
 +
 
 +
Jabber servers allow Sugar users to interact, play and collaborate with each other in the Sugar environment.
 +
 
 +
While the OLPC is designed with mesh wireless networking built in (where users can connect to each other without having a central wireless internet router/connection), Sugar users around the world may not be able to connect with others using the platform unless it's through the Internet, since mesh networking relies on a concentration of users (for example, in a classroom, school or business environment).
 +
 
 +
Jabber networks link Sugar users to each other in order to chat, interact and collaborate. There are global Sugar Jabber networks, or regional ones hosted by organizations and individuals around the world. You can choose whichever Jabber network you wish to connect to. Connecting Sugar to one of these networks will greatly enhance your Sugar experience.
 +
 
 +
*'''Connecting to Jabber Networks''' - [[How to connect Sugar to a Jabber network]]
 +
*'''List of Jabber Networks''' - [[Community Jabber servers]]
 +
*'''Creating a Jabber Server''' - To host a Jabber server for your city, region, country or interest read [[How to Create a Jabber Server]]
 +
 
 +
=== IRC Chat ===
 +
[[olpc:XoIRC | Install the XoIRC activity]] and connect with other Sugar/OLPC users and enthusiasts on the internet and chat with them in real time. XoIRC uses a system called [[wikipedia:Internet_Relay_Chat| IRC]]. 
 +
 
 +
It defaults to a "room" called #olpc-help, but you can also enter other rooms by typing '''/join #room'''  where '''room''' is the name of the room you wish to join.
 +
 
 +
Some other Sugar/OLPC IRC chatrooms are listed [[OLPC:IRC#irc.freenode.net_channels|here]].
 +
 
 +
=== OLPC/Sugar as Webserver ===
 +
 
 +
*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!
 +
 
 +
==Installing Sugar==
 
*[[:Category:Installing Sugar|Installing Sugar]] (on various platforms)
 
*[[:Category:Installing Sugar|Installing Sugar]] (on various platforms)
*[[Sugar Instructions]], booting and getting started with Sugar
+
*[[OLPC:Sugar Instructions]], booting and getting started with Sugar
  
===Exploring Sugar===
+
 
 +
==Developing For Sugar==
 
* [http://www.redhatmagazine.com/2007/02/23/building-the-xo-introducing-sugar/ Building the XO: Introducing Sugar - Red Hat Magazine 2007-02-23]
 
* [http://www.redhatmagazine.com/2007/02/23/building-the-xo-introducing-sugar/ Building the XO: Introducing Sugar - Red Hat Magazine 2007-02-23]
* [[Sugar_with_sugar-jhbuild|Build]] from sources, and [[Sugar Instructions|get started]].
+
* [[Development Team/Jhbuild|Build]] from sources, and [[OLPC:Getting started]].
* Read the human interaction [[HIG|guidelines]]
+
* Read the human interaction [[Human_Interface_Guidelines|guidelines]]
* Get an overview of the [[Sugar Architecture|architecture]]
+
* Get an overview of the [[OLPC:Sugar Architecture|architecture]]
* [[Sugar_Activity_Tutorial|Write]] your own activity
+
* [[OLPC:Activity tutorial|Write]] your own activity
* Check out the [[Sugar_Code_Snippets|code snippets]] library
+
* Check out the [[Development Team/Almanac/Code Snippets|code snippets]] library
* [[Understanding sugar code]] organization.
+
* [[Development Team/Understanding the Code]] organization.
 
* See a list of Sugar [[Activities|activities]] and specifications.
 
* See a list of Sugar [[Activities|activities]] and specifications.
 
* [http://dev.laptop.org/git?p=sugar;a=summary Sugar source repository]
 
* [http://dev.laptop.org/git?p=sugar;a=summary Sugar source repository]
Line 39: Line 174:
 
* [http://dev.laptop.org/roadmap Roadmap]
 
* [http://dev.laptop.org/roadmap Roadmap]
  
 +
==See also==
 +
* [[Documentation Team/Glossary]] of Sugar terms
  
 
+
[[Category:Documentation]]
 
 
[[Category:General public]]
 

Latest revision as of 14:52, 6 June 2019

english | español HowTo [ID# 103090] 
Stop hand.png NOTE:
The content of this page is considered
DEPRECATED and OBSOLETE
It is preserved for historical research, along with its talk page.

This page serves as a historical reference until it is restructured by a new Documentation Team. (Volunteers needed.)


The Sugar user manual

view now: HTML.gif
Sugarlabs mainpage 07.png available as: HTML.gif or PDF.PNG 128 pages, 8.3 MBytes (for saving or printing).

The manual needs to be updated to include information regarding Sugar-on-a-Stick.

How To Use Sugar

Using the Interface

Where's the desktop?

Sugar is a different desktop environment to what is normally used in Windows, Apple's OS X or other Linux operating systems. One of the first things that a child sees, therefore, is not a hard disk or a trash can—it’s the other children in the “neighborhood.” Sugar's closest desktop metaphor is the Home view: where the user can see what Activities they are currently using and access the Journal, which acts as a history of usage and allows the user to access files they viewed or applications they ran previously.

Using Activities

What is an Activity?

The program that you run using Sugar are called Activities. Why? Because Sugar, in its departure from the desktop metaphor for computing, is the first serious attempt to create a user interface that is based on both cognitive and social constructivism: an environment where learners engage in authentic exploration and collaboration in the act of learning.

Starting an Activity

Sharing an Activity

The interface (.85) doesn't show who is an activity until you join it. Apparently, once you join you can also destroy whatever work was there and the owner/starter of the activity would be none the wiser.

versioning for the activity?
control over who has access?

Here's a video showing the sharing activity in action.

Installing and Deleting Activities

    • Installing Sugar Activities Using Browse
    • Installing/Removing Sugar Activities Using Terminal
    • Installing/Removing Linux Applications
    • Installing an .xo file
    • Installing Sugar Coated Linux Applications
    • Windows Applications

Customizing the Interface

Changing an XO's Nickname and Color on Sugar Views

    Your XO's Nickname and other options can be changed using the OLPC:Terminal Activity's command line OLPC:Sugar Control Panel.

Changing the "XO Guy"

To change the XO Guy, the symbol in the middle of the Home view (with applications opening around him/her), you have to follow a few steps:

  • Create An Icon - You first have to make an icon image and save it as an SVG (Scalable Vector Graphics) file with the name computer-xo.svg. Probably on your Mac or Windows machine. There are instructions on how to do this on the OLPC wiki.
  • Transfer It To Your Computer - Copy computer-xo.svg to a USB or SD card and plug it into your OLPC or computer.
  • Install it - Open Terminal and type the following commands to back-up the original icon and copy your new icon into the correct location:
su -l
cp /usr/share/icons/sugar/scalable/device/computer-xo.svg /usr/share/icons/sugar/scalable/device/computer-xo.svg.bak
cp /media/<your usb or sd>/computer-xo.svg /usr/share/icons/sugar/scalable/device/computer-xo.svg
  • Now close terminal and press Ctrl,Alt,Erase.

Example of modified icon:

Screenshotkm7.png


Restoring Icon To Original

To restore computer-xo.svg back to the original, open terminal and type:

su -l
cp /usr/share/icons/sugar/scalable/device/computer-xo.svg.bak /usr/share/icons/sugar/scalable/device/computer-xo.svg
rm /usr/share/icons/sugar/scalable/device/computer-xo.svg.bak

Source: http://olpcnews.com/forum/index.php?topic=2157.0

Setting the Clock and Timezone

You may set the date and time as follows:

  1. Connect to the Internet. (For details, see Documentation Team/User Manual/Connecting to the Internet)
  2. Open a Linux prompt. (For details, see How do I access a Linux command prompt? Note that unless you are an advanced user, you should use the Terminal Activity button to open the prompt.)
  3. Log in as "root". Assuming you are using the Terminal Activity program, you can log in as root by typing "su -" at the command prompt and pressing the Enter key. Note that as user "root" you have the ability to destroy all software on the XO, so you should end your session as soon as you successfully change the date and time.
  4. At the command prompt, enter the following commands:
    /usr/sbin/ntpdate time.nist.gov
    /usr/sbin/hwclock --systohc
  5. Press the Enter key after each. In response to the ntpdate command, if it successfully contacts this US government official time server, the system will output a line of data displaying the correct date and time.
  6. Click the "Stop" icon OLPC::Image:Quit.gif at the upper right corner of the screen to log out and close the Terminal Activity program.

How to set the timezone on my laptop

You can set the timezone by typing the OLPC:Sugar Control Panel command in the OLPC:Terminal Activity.

Sound Control

    Disabling the bootup sound

    Turn the volume down while the laptop is booting (i.e. before getting into Sugar).

Taking Screen Shots

To take a screen shot, typing Alt+1 at the same time will take one and store it in your journal.

Networking & Communications

Connecting to Wireless Networks

To some degree, networking is specific to the platform upon which Sugar is running.

    On the XO-1 laptop, there are three ways to connect to the Internet:
    • Wireless access point (Wi-Fi hotspot);
    • “School Server” mesh network; or
    • “simple” mesh network, which lets you collaborate directly with other XOs.

Read Connecting to the Internet for detailed instructions.

Connecting to Jabber Servers

Jabber servers allow Sugar users to interact, play and collaborate with each other in the Sugar environment.

While the OLPC is designed with mesh wireless networking built in (where users can connect to each other without having a central wireless internet router/connection), Sugar users around the world may not be able to connect with others using the platform unless it's through the Internet, since mesh networking relies on a concentration of users (for example, in a classroom, school or business environment).

Jabber networks link Sugar users to each other in order to chat, interact and collaborate. There are global Sugar Jabber networks, or regional ones hosted by organizations and individuals around the world. You can choose whichever Jabber network you wish to connect to. Connecting Sugar to one of these networks will greatly enhance your Sugar experience.

IRC Chat

Install the XoIRC activity and connect with other Sugar/OLPC users and enthusiasts on the internet and chat with them in real time. XoIRC uses a system called IRC.

It defaults to a "room" called #olpc-help, but you can also enter other rooms by typing /join #room where room is the name of the room you wish to join.

Some other Sugar/OLPC IRC chatrooms are listed here.

OLPC/Sugar as Webserver

  • 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!

Installing Sugar


Developing For Sugar

See also