Documentation Team/User Manual: Difference between revisions

(36 intermediate revisions by 7 users not shown)

Line 1:

~~=How To Use Sugar=~~

{{Translations

| [[Documentation Team/User Manual|english]] | [[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 [[Glossary#User_Interface_.28UI.29|Interface]]===~~

====~~Where's the desktop?~~====

====The Sugar user manual====

Sugar is a different desktop environment to what is normally used in Windows, Apple's OS X or other Linux operating systems. The first thing 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.

==How To Use Sugar==

===Using the [[Documentation Team/Glossary#User_Interface_.28UI.29|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 [[Glossary|user interface]] that is based on both cognitive and social [~~http~~:~~//en.wikipedia.org/wiki/~~Constructivism_%28learning_theory%29 constructivism]: an environment where learners engage in authentic exploration and collaboration in the act of learning.

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====

====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].

====Installing and Deleting Activities====

Line 20:

Line 35:

*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 [[Terminal Activity]]'s command line [[Sugar-Control-Panel]].

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

</ol>

Line 42:

Line 57:

*Now close terminal and press Ctrl,Alt,Erase.

~~Exmaple~~ of modified icon:

Example of modified icon:

[[Image:Screenshotkm7.png‎‎]]

Line 63:

Line 78:

<ol>

<li> Connect to the Internet. (For details, see [[Connecting to the Internet]])

<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.)

Line 75:

Line 90:

<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 [[Image:Quit.gif~~|25px~~]] at the upper right corner of the screen to log out and close the Terminal Activity program.

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

Line 81:

Line 96:

====How to set the timezone on my laptop====

You can set the timezone by typing the [[Sugar-Control-Panel]] command in the [[Terminal Activity]].

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

===Sound Control===

Line 95:

Line 110:

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

=Networking & Communications=

==Networking & Communications==

===Connecting to Wireless Networks===

Line 101:

Line 116:

<ol>

On the XO-1 laptop, there are three ways to connect to the Internet:

*Wireless access point (~~WiFi~~ hotspot);

*Wireless access point (Wi-Fi hotspot);

*“School Server” mesh network; or

*“simple” mesh network, which lets you collaborate directly with other XOs.

</ol>

Read [[Connecting to the Internet]] for detailed instructions.

Read [[Documentation Team/User Manual/Connecting to the Internet|Connecting to the Internet]] for detailed instructions.

===Connecting to Jabber Servers===

Line 116:

Line 131:

*'''Connecting to Jabber Networks''' - [[How to connect Sugar to a Jabber network]]

*'''List of Jabber Networks''' - [[~~A list of~~ Jabber ~~networks around the world~~]]

*'''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 ===

[~~http~~:~~//wiki.laptop.org/go/~~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 [~~http~~:~~//en.wikipedia.org/wiki/~~Internet_Relay_Chat IRC].

[[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 [~~http~~:~~//wiki.laptop.org/go/~~IRC#irc.freenode.net_channels ~~are listed~~ here.]]

Some other Sugar/OLPC IRC chatrooms are listed [[OLPC:IRC#irc.freenode.net_channels|here]].

=== OLPC/Sugar as Webserver ===

Line 141:

Line 156:

*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=

==Installing Sugar==

*[[: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

=Developing For 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]

* [[~~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.

* [http://dev.laptop.org/git?p=sugar;a=summary Sugar source repository]

Line 159:

Line 174:

* [http://dev.laptop.org/roadmap Roadmap]

=See also=

==See also==

* [[Glossary]] of Sugar terms

* [[Documentation Team/Glossary]] of Sugar terms

~~[[Category:General public]]~~

[[Category:Documentation]]

@@ 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 [[Glossary#User_Interface_.28UI.29|Interface]]===
-====Where's the desktop?====
+====The Sugar user manual====
-Sugar is a different desktop environment to what is normally used in Windows, Apple's OS X or other Linux operating systems. The first thing 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.
+{{FlossmanualBlock}}
+==How To Use Sugar==
+===Using the [[Documentation Team/Glossary#User_Interface_.28UI.29|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&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.
 ===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 [[Glossary|user interface]] that is based on both cognitive and social [http://en.wikipedia.org/wiki/Constructivism_%28learning_theory%29 constructivism]: an environment where learners engage in authentic exploration and collaboration in the act of learning.
+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====
+====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].
 ====Installing and Deleting Activities====
@@ Line 20: / Line 35: @@
 *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 [[Terminal Activity]]'s command line [[Sugar-Control-Panel]].
+<ol>Your XO's Nickname and other options can be changed using the [[OLPC:Terminal Activity]]'s command line [[OLPC:Sugar Control Panel]].
 </ol>
@@ Line 42: / Line 57: @@
 *Now close terminal and press Ctrl,Alt,Erase.
-Exmaple of modified icon:
+Example of modified icon:
 [[Image:Screenshotkm7.png‎‎]]
@@ Line 63: / Line 78: @@
 <ol>
-<li> Connect to the Internet. (For details, see [[Connecting to the Internet]])
+<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.)
@@ Line 75: / Line 90: @@
 <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 [[Image:Quit.gif|25px]] at the upper right corner of the screen to log out and close the Terminal Activity program.
+<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>
@@ Line 81: / Line 96: @@
 ====How to set the timezone on my laptop====
-You can set the timezone by typing the [[Sugar-Control-Panel]] command in the [[Terminal Activity]].
+You can set the timezone by typing the [[OLPC:Sugar Control Panel]] command in the [[OLPC:Terminal Activity]].
 ===Sound Control===
@@ Line 95: / Line 110: @@
 To take a screen shot, typing Alt+1 at the same time will take one and store it in your journal.
-=Networking & Communications=
+==Networking & Communications==
 ===Connecting to Wireless Networks===
@@ Line 101: / Line 116: @@
 <ol>
 On the XO-1 laptop, there are three ways to connect to the Internet:
-*Wireless access point (WiFi hotspot);
+*Wireless access point (Wi-Fi hotspot);
 *“School Server” mesh network; or
 *“simple” mesh network, which lets you collaborate directly with other XOs.
 </ol>
-Read [[Connecting to the Internet]] for detailed instructions.
+Read [[Documentation Team/User Manual/Connecting to the Internet|Connecting to the Internet]] for detailed instructions.
 ===Connecting to Jabber Servers===
@@ Line 116: / Line 131: @@
 *'''Connecting to Jabber Networks''' - [[How to connect Sugar to a Jabber network]]
-*'''List of Jabber Networks''' - [[A list of Jabber networks around the world]]
+*'''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 ===
-[http://wiki.laptop.org/go/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 [http://en.wikipedia.org/wiki/Internet_Relay_Chat IRC].
+[[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 [http://wiki.laptop.org/go/IRC#irc.freenode.net_channels are listed here.]]
+Some other Sugar/OLPC IRC chatrooms are listed [[OLPC:IRC#irc.freenode.net_channels|here]].
 === OLPC/Sugar as Webserver ===
@@ Line 141: / Line 156: @@
 *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=
+==Installing Sugar==
 *[[: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
-=Developing For 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]
-* [[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.
 * [http://dev.laptop.org/git?p=sugar;a=summary Sugar source repository]
@@ Line 159: / Line 174: @@
 * [http://dev.laptop.org/roadmap Roadmap]
-=See also=
+==See also==
-* [[Glossary]] of Sugar terms
+* [[Documentation Team/Glossary]] of Sugar terms
-[[Category:General public]]
 [[Category:Documentation]]