Difference between revisions of "Sugar Network/Tutorial"

From Sugar Labs
Jump to navigation Jump to search
m (→‎OFF Line Mode: updated to SN 0.3)
 
(51 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Under construction| - Updated June 5 2012}}
+
<noinclude>[[Category:Tutorial|Network]]
[[Image:Sweets.svg|65px]]<big><big>'''Sugar Network annotated screen-shots'''</big></big>
+
{{Under construction| - Updated Aug 18, 2012}}
 +
</noinclude>
 +
<big><big>'''Sugar Network annotated screenshots'''</big></big>
 
===Info and How to install Sugar Network (SN)===
 
===Info and How to install Sugar Network (SN)===
 +
* '''Main Wiki Page [[Sugar_Network|Sugar Network]]'''
 +
:How to install on XO-1 and XO-1.5
 +
::Tested on XO-1.5
 +
*To Upgrade XO-1.5 to SN 0.5 software:
 +
terminal
 +
su
 +
yum update
 
* SN is only available on '''Factory'''
 
* SN is only available on '''Factory'''
: [[Platform Team/Harmonic Distribution]]
+
* '''[http://network-testing.sugarlabs.org/context?type=all&page=1 Test View of latest SN (0.5)]''' Look at a preview of the latest changes to the SN interface.
 +
* '''[http://network-testing.sugarlabs.org/hub/ advanced View of Activites with Hub Interface]'''
 +
: [[Harmonic Distribution]]
 
: [[Sweets Distribution#Installation]]
 
: [[Sweets Distribution#Installation]]
 
: [[Sweets Distribution/Manual Installation]]
 
: [[Sweets Distribution/Manual Installation]]
: [[Sugar_Network_Activities]] Listing which activities on SN work - Browsing 113 Contexts; 19 Pages
+
: [[Sweets Distribution/Testing]] With instuctions on updating sweets-distribution
: [[Sugar_Network_Server_mode_Activities]] Testing list of activities in Server mode
+
: [[Sugar Network Activities]] Listing of '''On-Line SN''' Activities by page
: [http://network-testing.sugarlabs.org/context?page=1 Test View of SN] Test View of SN
+
 
* Visual introduction to the Sugar Interface
+
* If you are new to Sugar, see this visual [[Tutorials/Introduction to the Sugar Interface|introduction to the Sugar Interface]].
:[[Introduction to the Sugar Interface]]
+
 
 
====Check for Updates Often====
 
====Check for Updates Often====
:Maybe even daily; as SN is a rapidly being developed.
+
: Maybe even daily; as SN is a rapidly being developed.
*root terminal: (for Ubuntu; Trisquel)
+
 
 +
'''Caution Do Not Use My Settings/Software update'''
 +
:As you may download Activity updates that are not compatable with SN
 +
 
 +
====Alternate Method for Activity Installation====
 +
*Note: This will correct for loss of the activity if Cresent ("Moon") and ("star") icons are uncolored by mistake *.
 +
:'''* Doing this will erase the activity''' and an Activity.xo downloaded from sugar-browse will not start in SN-Factory
 +
*Running Ubuntu 11.04 (Trisquel 5.5)
 +
# Download new Activity.xo file from [http://activities.sugarlabs.org/ ASLO] to the desktop - with SN not running
 +
# Or Copy the Activity.xo from a [[Sugar_Creation_Kit#ASLOxo-6|'''CD/DVD''']] or USB to the desktop
 +
# Extract the .xo file with "Archive Manager" to Activities from the desktop
 +
# New activity will be on inside end of (f3) Home View activity spiral
 +
: And will appear when the Circle with 3 circles inside Icon on left end of SN Top bar is not colored - '''Offline Mode'''
 +
 
 +
====Upgrading Sugar-Network====
 +
*Ubuntu (Trisquel 5.5)
 +
sudo su
 +
password
 
  apt-get update
 
  apt-get update
 
  apt-get upgrade
 
  apt-get upgrade
*Reboot Computer
+
sweets-distribution status
 +
sweets-distribution sync
  
 
===Home view for Sugar Network (F3 key)===
 
===Home view for Sugar Network (F3 key)===
* Home view - updated June 5 2012
+
* Home view  
:Hover over central XO avatar to get drop-down menu
+
: Hover over central XO avatar to get drop-down menu
[[File:SN-1c.png|800px]]
+
[[File:SN-0.3-f3.png|800px]]
  
===Sugar Network in "My Settings"===
+
===Sweets Distribution in "My Settings"===
*Click on Sweets Distribution
+
====Sweets Distribution====
[[File:SN-MySettings.png|800px]]
+
*Click on Sweets Distribution Icon
* Check [x] to start SN  
+
:(Currently a grey circle as Sweets-Distribution Icon has not been approved)
 +
[[File:My_Settings.png|800px]]
 +
*Check [x]Sugar Network Integration
 +
* Reboot Computer after selecting Sugar Network Integration
 +
: You may be unable to Connect to Activites if you do not
 +
:Screen in Ubuntu (Trisquel 5.5)
 +
::(Sweets-distribution 11.04 Factory)
 +
[[File:Sweet_Distribution.png|800px]]
 +
:Screen in XO-1.5 1
 +
::(Hexokinase Factory Sugar 0.94.1
 +
*Restart XO-1.5 after '''yum update''' if updating to SN-0.5
 +
*Check [x] Sweets-Desktop is Default Sugar-Session
 +
*Check [x] Sugar Network Integration
 +
[[File:Sweet_Distribution-XO.png|800px]]
  
* Check [x] to Start Server Mode 
+
====Internet_Proxy====
:'''This is Only used for testing''' and should not be used.
+
*New
 +
[[File:Internet_Proxy.png|800px]]
 +
====Modem_Configuration====
 +
*for 3G Modems
 +
[[File:Modem_Configuration.png|800px]]
  
: '''Reboot Computer''' after selecting SN
+
===Neighborhood view for Sugar Network (F1 key)===
:You may be unable to Connect to Activites if you do not
+
* Neighborhood view can also be accessed from the far left icon on the Sugar '''Frame''' (see next screenshot).
[[File:SN-Server-mode.png|800px]]
+
* Note many more XO avatars than are present on jabber.sugarlabs.org
 
+
: Grey (no color) XO avatars seem to have incomplete information on the server.
===Neighbourhood view for Sugar Network (F1 key)===
 
* Neighbourhood view can also be accessed from the far left Icon on sugar-frame (see next screenshot)
 
* Note many more XO Avitars than are present on jabber.sugarlabs.org
 
:Grey (No color) XO Avatars seem to have incomplete info on server.
 
 
[[File:SN-3.png|800px]]
 
[[File:SN-3.png|800px]]
  
 
===Access Activities with SN button on Frame===
 
===Access Activities with SN button on Frame===
* Move Cursor arrow to top right corner of window to activate the frame. Wait for frame to appear.
+
* Move the mouse pointer to a corner of the screen/window to activate the '''Frame'''. Wait a couple of seconds for it to appear.
* Click on the SN button to access SN Activities
+
* Click on the SN button to access SN Activities.
:The '''F8 KEY''' is an alternate way to access Activities  
+
: The '''F8 key''' is an alternate way to access SN Activities.
[[File:SN-4.png|800px]]
+
[[File:SN-4png.png|800px]]
  
 
===SN Activities ===
 
===SN Activities ===
*when [_] server mode is NOT checked in My settings (Drop-Down Menu on f3 HOME screen-Circular View)
+
*There are 2 sets of Activities available:
*listing and start pages for [[Sugar_Network_Activities]]
+
#Off-line Mode (see Below)
:Click on the Activity Icon to start
+
:Locally stored Activities
:Not all will start at this time.
+
#On-Line Mode (see Below)
*Screen 1 of 55 pages, (329 activities)
+
:Downloaded from the Internet
Note: type the name of the activity you want in Search box (_______) on top bar of page to find it quickly
+
 
*For Details on Search - '''It can be Complex''' ie "author:walter"
+
====OFF Line mode====
:Search Contexts Diagram http://wiki.sugarlabs.org/go/File:Sugar-Network-diagram.png
+
*Left SN Icon on top bar not colored (Circle with 3 smaller circles inside of it)
====OFF Line Mode====
+
* Screen 1 of 16 pages, (92 Activities)
*Note buttons that appear when cursor is over activity
+
*Clicking on the Activity Icon will start it.
questions            review
+
* Note extra buttons that appear when cursor is over activity:
  ideas     [activity] 0   (not working)
+
  (?)              questions            (Box with Tail)      review
problems            (not working
+
  (Lightning bolt) ideas               ( 0 )                (future use not working)
 +
  (!)              problems            (Horizontal Grid)    View All Resources
 +
:Use them to report, or ask questions, about the on activity's behaviour.
 +
*'''This will only happen when SN is On line Mode.'''
 +
:Off-line reports are disabled
 +
 
 
[[File:SN-0.3_Offline.png|800px]]
 
[[File:SN-0.3_Offline.png|800px]]
  
====ON Line Mode====
+
====ON Line mode====
 +
*When Selected the left SN Icon is Colored ( Circle with 3 smaller circles inside)
 +
* Screen 1 of 11 pages, (66 Activities)
 
[[File:SN-0.3.png|800px]]
 
[[File:SN-0.3.png|800px]]
*Cursor is on new "Improve the system:Sugar Network pop up screen
+
* The pointer is on the Selection Drop-Down Menu
Note:  
+
'''Note:''' Clicking on the "(" moon icon will copy the remote Activity bundle to the local system, thus it will be accessible from the  '''Home''' view. If the 'star' icon is set, it will appear in the Favorites view of '''Home'''. Deselect "(" moon icon to remove it from the local system; unset the 'star' icon to remove it from the Favorites view.
clicking on the "(" moon icon will copy activity to ~/Activities, thus it will be accessible from f3 Home View.
+
====Browse Resources====
If the "star" is set, it will appear in the favourites view of f3
+
*Selected from the (Horizontal Grid) icon on the top bar
Disable "(" Moon to remove it; unset "star" to remove from favourites view.
+
:Cursor is pointing to it
=====Improve the system=====
+
*The icons on the right side of the top grey bar are used to filter the view of the resources by clicking the icons:
[[File:SN-0.3-sug.png|800px]]
+
  (?)                questions
=====Browse Problems=====
+
  (Lightning bolt)  ideas             
[[File:SN-0.3-browse_problems.png|800px]]
+
  (!)                problems
 +
  (Box with Tail)    review
 +
  ( 0 )              (future use not working)
 +
  (Horizontal Grid)  ALL
 +
*Click on the top bar Icon with Grid to return to Activities Screen
 +
 
 +
[[File:SN-0.3-browse-resources.png|800px]]
  
===SN Server-mode Activities===
 
'''THIS IS ONLY FOR TESTING- DO NOT USE'''
 
*when [x] server mode is checked in My settings (Drop-Down Menu on f3 HOME screen-Circular View)
 
:If the server is checked, you browse your local activities in f8 all the time
 
*listing and start pages for [[Sugar_Network_Server_mode_Activities]]
 
:Click on an Activity Icon to start It.
 
  
:Updated June 5 2012
 
  
]
+
==Notes==
 +
Note: Enter the name of the Activity you want in the Search box (_______) on the tool bar of page to find it quickly
 +
* For Details on Search - '''It can be Complex''' --"walter"
 +
: Object model for the Sugar Network <abbr title="application programming interface">API</abbr> - [[:File:Sugar-Network-diagram.png]]
 +
* ALSO SEE - Reference: Listing and start pages for [[Sugar Network Activities]]

Latest revision as of 21:56, 6 October 2012

Warning.png
Under construction
This page is under active construction at this time. Please check back shortly for updated information.
- Updated Aug 18, 2012

Sugar Network annotated screenshots

Info and How to install Sugar Network (SN)

How to install on XO-1 and XO-1.5
Tested on XO-1.5
  • To Upgrade XO-1.5 to SN 0.5 software:
terminal
su
yum update
Harmonic Distribution
Sweets Distribution#Installation
Sweets Distribution/Manual Installation
Sweets Distribution/Testing With instuctions on updating sweets-distribution
Sugar Network Activities Listing of On-Line SN Activities by page

Check for Updates Often

Maybe even daily; as SN is a rapidly being developed.

Caution Do Not Use My Settings/Software update

As you may download Activity updates that are not compatable with SN

Alternate Method for Activity Installation

  • Note: This will correct for loss of the activity if Cresent ("Moon") and ("star") icons are uncolored by mistake *.
* Doing this will erase the activity and an Activity.xo downloaded from sugar-browse will not start in SN-Factory
  • Running Ubuntu 11.04 (Trisquel 5.5)
  1. Download new Activity.xo file from ASLO to the desktop - with SN not running
  2. Or Copy the Activity.xo from a CD/DVD or USB to the desktop
  3. Extract the .xo file with "Archive Manager" to Activities from the desktop
  4. New activity will be on inside end of (f3) Home View activity spiral
And will appear when the Circle with 3 circles inside Icon on left end of SN Top bar is not colored - Offline Mode

Upgrading Sugar-Network

  • Ubuntu (Trisquel 5.5)
sudo su
password
apt-get update
apt-get upgrade
sweets-distribution status
sweets-distribution sync

Home view for Sugar Network (F3 key)

  • Home view
Hover over central XO avatar to get drop-down menu

SN-0.3-f3.png

Sweets Distribution in "My Settings"

Sweets Distribution

  • Click on Sweets Distribution Icon
(Currently a grey circle as Sweets-Distribution Icon has not been approved)

My Settings.png

  • Check [x]Sugar Network Integration
  • Reboot Computer after selecting Sugar Network Integration
You may be unable to Connect to Activites if you do not
Screen in Ubuntu (Trisquel 5.5)
(Sweets-distribution 11.04 Factory)

Sweet Distribution.png

Screen in XO-1.5 1
(Hexokinase Factory Sugar 0.94.1
  • Restart XO-1.5 after yum update if updating to SN-0.5
  • Check [x] Sweets-Desktop is Default Sugar-Session
  • Check [x] Sugar Network Integration

Sweet Distribution-XO.png

Internet_Proxy

  • New

Internet Proxy.png

Modem_Configuration

  • for 3G Modems

Modem Configuration.png

Neighborhood view for Sugar Network (F1 key)

  • Neighborhood view can also be accessed from the far left icon on the Sugar Frame (see next screenshot).
  • Note many more XO avatars than are present on jabber.sugarlabs.org
Grey (no color) XO avatars seem to have incomplete information on the server.

SN-3.png

Access Activities with SN button on Frame

  • Move the mouse pointer to a corner of the screen/window to activate the Frame. Wait a couple of seconds for it to appear.
  • Click on the SN button to access SN Activities.
The F8 key is an alternate way to access SN Activities.

SN-4png.png

SN Activities

  • There are 2 sets of Activities available:
  1. Off-line Mode (see Below)
Locally stored Activities
  1. On-Line Mode (see Below)
Downloaded from the Internet

OFF Line mode

  • Left SN Icon on top bar not colored (Circle with 3 smaller circles inside of it)
  • Screen 1 of 16 pages, (92 Activities)
  • Clicking on the Activity Icon will start it.
  • Note extra buttons that appear when cursor is over activity:
 (?)               questions            (Box with Tail)      review
 (Lightning bolt)  ideas                ( 0 )                (future use not working)
 (!)               problems             (Horizontal Grid)    View All Resources
Use them to report, or ask questions, about the on activity's behaviour.
  • This will only happen when SN is On line Mode.
Off-line reports are disabled

SN-0.3 Offline.png

ON Line mode

  • When Selected the left SN Icon is Colored ( Circle with 3 smaller circles inside)
  • Screen 1 of 11 pages, (66 Activities)

SN-0.3.png

  • The pointer is on the Selection Drop-Down Menu

Note: Clicking on the "(" moon icon will copy the remote Activity bundle to the local system, thus it will be accessible from the Home view. If the 'star' icon is set, it will appear in the Favorites view of Home. Deselect "(" moon icon to remove it from the local system; unset the 'star' icon to remove it from the Favorites view.

Browse Resources

  • Selected from the (Horizontal Grid) icon on the top bar
Cursor is pointing to it
  • The icons on the right side of the top grey bar are used to filter the view of the resources by clicking the icons:
 (?)                questions
 (Lightning bolt)   ideas              
 (!)                problems 
 (Box with Tail)    review
 ( 0 )              (future use not working)
 (Horizontal Grid)  ALL
  • Click on the top bar Icon with Grid to return to Activities Screen

SN-0.3-browse-resources.png


Notes

Note: Enter the name of the Activity you want in the Search box (_______) on the tool bar of page to find it quickly

  • For Details on Search - It can be Complex --"walter"
Object model for the Sugar Network API - File:Sugar-Network-diagram.png