Sugar Labs - User contributions [en]

Features/Web services

2013-05-11T06:03:35Z

Rgs: /* Current status */

<noinclude>
[[Category:Feature Page Incomplete]]
[[Category:Feature|Journal enhancement]]
</noinclude>

== Summary ==
This feature adds a new section to the Sugar Control Panel to manage online accounts and some interventions to the Sugar Journal toolbars and palettes in order to expose any installed online services.

== Owner ==
* Name: [[User:Walter| Walter Bender]]
* Name: [[User:rgs| Raúl Gutiérrez Segalés]]

* Email: <walter AT sugarlabs DOT org> <rgs AT itevenworks DOT net>

== Current status ==
* Targeted release: 1.0
* Last updated: 18 Feb 2013
* Percentage of completion: 100% (pending review, including an example Web Service: Facebook sharing. Note that a self-hosted web service is being written by Tincho, Walter and Raúl atm: https://www.itevenworks.net/2013/05/a-backend-for-sugars-future-web-services-infrastructure/)

== Detailed Description ==
This feature adds a new section to the Sugar Control Panel to manage online accounts and some interventions to the Sugar Journal toolbars and palettes in order to expose any installed online services.

There are two parts to the feature:
# adding support to the Control Panel to manage online accounts.
# adding support to integrate webservices with the Sugar journal, adding Copy-to and Refresh capabilities.

We have implemented one example of using this feature:
* support specific to Facebook: to share Journal entries on Facebook and to retrieve comments on those entries from Facebook.

We are working with community members on Twitter and Google Drive extensions based on the framework in #0002 and #0003 and encourage other community members to work with us on additional services.

For now, web services implementations are welcome to handle their retrieval of tokens on their own. In the future we might want to delegate that to Gnome Online Accounts or a similar auth/token provider.

== Benefit to Sugar ==
See the [[Archive/Current_Events/2013-02-19|detailed discussion in the Sugar Digest]].

== Scope ==
The feature requires
* the addition of a new cpsection: extensions/cpsection/webservices
* an icon added to data/icons
* a place to put the webservices: extensions/web
* an interface to the webservices: src/jarabe/web
* and integration of webservices with the journal: src/jarabe/journal/palettes.py and src/jarabe/journal/journaltoolbox.py

The changes to existing code is minimal, just the addition of some new palette entries based upon the availability of the online services. The actions taken by the services themselves are self-contained within the services themselves.

+ from jarabe.web import online_accounts_manager as oam

+ for account in oam.OnlineAccountsManager.configured_accounts():
+ menu = account.get_share_menu(metadata)
+ self.append(menu)

+ self._refresh_buttons = []
+ for account in oam.OnlineAccountsManager.configured_accounts():
+ self._refresh_buttons.append(account.get_refresh_button())
+ self.toolbar.insert(self._refresh_buttons[-1], -1)

+ for account in oam.OnlineAccountsManager.configured_accounts():
+ menu = account.get_share_menu(self._metadata)
+ palette.menu.append(menu)

==UI Design==
There are three places where the UI is impacted.

1. There is a new icon on the control panel (as a place holder, we use a color-inverted activity-web.svg) for online account management. It has a label, _('Configure your Web Services'). When that icon is clicked, a horizontal list of icons (provided by the services) is displayed. (If no services are installed, a message to that effect is displayed.) If a service is requested, a widget provided by the service is displayed in the bottom 3/4 of the screen. Typically, this would be some sort of login dialog. A token and expiration time may be stored in .gconf/desktop/sugar/collaboration or some other place specific to the online service.

<gallery>
File:Sugar-CP-Section-with-Web-services.png|The Web Services section is on the lower right
File:FB-online-account-manager.png|The available services are shown along the top (in this case, only FB is installed)
</gallery>

2. In the Journal list view, a new palette entry is created for each installed online service under the Copy-to submenu. If the service is "active", i.e., the user has a valid token as determined by the online service, then that button is sensitive. Otherwise, it is insensitive.

<gallery>
File:Fb-share-on-fb.png|The web services are added to the Copy-to menu (in this case, only FB is installed)
</gallery>

3. In the Journal detail view, the Copy-to submenu is also updated. In addition, a refresh button for each installed online service is displayed on the toolbar. The service itself determines whether or not that button is sensitive or insensitive. (For example, the Facebook service uses the refresh button to retrieve comments from Facebook. Therefore, the refresh button is only sensitive if the Facebook service is active ''and'' the entry has been shared with Facebook.)

<gallery>
File:FB-comments.png|An example of comments retrieved from FB using the Refresh button. These comments co-exist with comments generated from within Sugar.
</gallery>

== How To Test ==
{{:{{PAGENAME}}/Testing}}

== User Experience ==
If you use the Journal, you will see a new entries on the Copy-to submenu for each online service you've installed. There is no need to use these buttons.

== Dependencies ==
No new dependencies, but some new strings to translate.

== Contingency Plan ==
No impact as this is a new feature.

== Documentation ==
Some discussions with the design team regarding the placement of the buttons on the palettes.

== Release Notes ==
The Sugar Journal has a new mechanism for integrating the Sugar Journal with online services, e.g., if you install the Facebook online service, you can share journal entries on Facebook and associate comments from Facebook with your journal entries.

== Comments and Discussion ==
* See [[{{TALKPAGENAME}}|discussion tab for this feature]]

Phabricator

2013-04-01T16:32:08Z

Rgs: /* Configuring arc for your project */

We've got a test instance of [http://www.phabricator.org Phabricator] running here (at the moment I did in my VM because I was testing out the setup - didn't want to do it in sunjammer just yet - will move to a proper SL domain later today/tomorrow):

[http://phabricator.itevenworks.net http://phabricator.itevenworks.net]

== Phabricator's Web UI ==

Right now you can login by creating a regular account or via an FB account (support for other external systems coming soon).

You can browse code here:

[http://phabricator.itevenworks.net/diffusion/ http://phabricator.itevenworks.net/diffusion/]

And check your pending reviews here:

[http://phabricator.itevenworks.net/differential/ http://phabricator.itevenworks.net/differential/]

And manage tasks here:

[http://phabricator.itevenworks.net/maniphest/ http://phabricator.itevenworks.net/maniphest/]

== Using Phabricator from the command-line ==

A code review in Phabricator is called a Revision. You can create and close revisions directly from the command line via '''arc'''.

=== Installing arc ===
The only prerequisite for running arc is the php-cli package (on Fedora and php5-cli on Ubuntu).

mkdir ~/arc
cd ~/arc
git clone git://github.com/facebook/libphutil.git
git clone git://github.com/facebook/arcanist.git

and then extend your PATH (via ~/.bashrc or similar) to have it include:

~/arc/arcanist/bin

=== Configuring arc for your project ===
To use '''arc'' (with, say, Turtle Art) you need to create an .arcconfig inside your Turtle Art's repo clone:
{
"project_id" : "turtleart",
"conduit_uri" : "http://phabricator.itevenworks.net/"
}

As projects pick up Phabricator & arc I am expecting them to have a .arcconfig committed to their repos, so you'll be able to skip this step. The first time you run an arc command against the Phabricator instance it'll ask you to paste in an auth token to validate your account.

When you create a commit you need to include certain fields (reviewer, test plan, etc) so that arc can create a revision out of this. To avoid having to do this manually you can use git commit message templates:

git config --global commit.template ~/.gitmessage.txt

And ~/.gitmessage.txt has to be:

<Replace this line with a title. 1 line only, 67 chars or less>

Summary:

Test Plan:

Reviewers:

CC:

=== Create revisions ===

To create a new revision (a code review request) hack on something and create a commit and then:

arc diff

If you are requested changes on that revision as part of the code review you can hack on those changes and then:

git commit -a --amend

and then request a new review:

arc diff

Note that this last command won't create a new revision - it'll update the existing one.

Once your reviewers are finally happy with that revision and it has been approved you can close it with:

arc amend && git push

2011-05-19T18:10:24Z

Rgs:

<noinclude>{{GoogleTrans-en}}{{TOCright}}</noinclude>[[Category:Page Template]]
= Turtle Art =

== Introduction ==
Turtle Art is an activity with a Logo-inspired graphical "turtle" that draws colorful art based on snap-together visual programming elements.

Turtle Art is intended to be a stepping stone to the Logo programming language, but there are many restrictions compared to Logo. (Only numeric global variables and stack items are available, no lists or other data-structures. The conditionals and some of the functions only take constants or variables, not expressions. Limited screen real-estate makes building large programs unfeasible.) However, you can export your Turtle Art creations to Berkley Logo. The sensor-enabled version of Turtle Art also has a facility for sensor input, so, for example, you can move the Turtle based upon sound volume or pitch.

Turtle Art is in the same tradition as Etoys, Scratch, Lego Mindstorms™, and Lego Microworlds™.

Turtle Art is used extensively in Sugar deployments and numerous materials for support in the classroom have been developed. Of course, since Turtle Art is a Logo derivative, many of the classic Logo exercises are well suited for engaging students in Turtle Art. For example, Bill Kerr has been blogging about the experiences of his students trying to tackle Barry Newell worksheet of 40 geometric shapes to be rendered using turtle graphics.

More Info:

* Turtle Art Sugar Activity [[Activities/TurtleArt|homepage]]
* Turtle Art gallery (See [http://www.turtleart.org])
* Turtle Art Manual (See [http://en.flossmanuals.net/turtleart])
* Turtle Art teacher guides from Uruguay (See [http://www.reducativa.com/wiki/index.php?title=Proyecto_OLPC_-_Plan_Ceibal#Turtle_Art])
* Turtle Art teacher guides from Peru (See [http://www.perueduca.edu.pe/olpc/OLPC_fichasfasc.html])
* Turtle Art student guide (See [http://wiki.laptop.org/images/e/e3/Turtle_Art.pdf])
* Tony Forster blog on Turtle Art (See [http://tonyforster.blogspot.com/])
* Bill Kerr blog on Turtle Art (See [http://xo-whs2009.blogspot.com/])
* Barry Newell worksheet (See [http://1.bp.blogspot.com/_r-MQun1PKUg/SpuoxMM_JmI/AAAAAAAABEA/DIEF5r3OYe8/s1600-h/BNcropped.jpg])

== What is new for users ==

The most visible change is the incorporation of the new Sugar Toolbar design.

[[Image:TA-v65.png|800px]]

[[Image:TA-v65-toolbar.png|thumb|left|800px|Turtle Art v65 with the 0.86 toolbar design has the project buttons: Hide Palette, Hide Blocks, Erase, Run, Step, Debug, and Stop Buttons, and four submenus]][[Image:TA-v65-main.png|thumb|left|800px|The activity toolbar contains the Keep Button, Snapshot Button, Save to HTML Button, Save to Logo Button, Save as Image Button, and Load Python Code Button]][[Image:TA-v65-edit.png|thumb|left|800px|The edit toolbar contains the Copy and Paste Buttons]][[Image:TA-v65-view.png|thumb|left|800px|The view toolbar contains the Fullscreen Button]][[Image:TA-v65-help.png|thumb|left|800px|The help toolbar includes the Sample-Projects Button and hover help]][[File:File-sharing-in-TA.png|thumb|left|800px|File sharing of Turtle Art projects from the Journal works between Sugar "buddies"; but only through a local connection, i.e., Salut (See [[Development_Team/Release/Releases/Sucrose/0.84#File_transfer]]) ]]

<div class="visualClear"></div>

Minor bugs and feature changes include:

73

* raise status flag when catching overflow error
* clean up of de, it, fr, es artwork
* fixed bug related to blocks running off the left edge
* cleaned up command-line code

72

* cleaned up code for pre-0.86 palettes
* fixed keyboard shortcut bug in pre-0.86 palettes
* fixed problem with int(None) in unselect
* fixed problem with int(float) in unselect
* fixed fence-post problem with searching off the end of blocks
* work-around Rainbow problem with tmpfile

71

* updated fr translations
* more sample Python code
* limiting abs(number) to max of 1000000 to prevent OverflowErrors

70

* new translations/artwork for vi, it, fr
* added linewrap to help label (with rgs)
* added label to Help toolbar (to work around bug with small displays)
* caught some exceptions that prevented TA from running outside of Sugar
* fixed bug preventing simple save to HTML for pre-086 systems
* added missing icon for Save from Journal

69

* chmod +x svg factory
* added missing import gettext from talogo.py
* renamed xo-man to xo-child
* caught missing attribute when running from outside of Sugar
* new translations/artwork for de, fr, es, it
* added translator comments
* fixed several bugs in export to Logo code

68

* made case consistent on tool tips
* fixed bug re i18n in debug panel
* new artwork for es and fr
* fixed some problems with svg factory
* fixed bug in Export HTML
* fixed naming problem with all save_as functions
* fixed bug in Export Logo in regard to start block

67

* added mime-type icon
* changed keyboard shortcuts to use Ctrl instead of Alt as per guidelines
* fixed bug re wait time (now in seconds)
* fixed problem with fractional wait times
* fixed i18n problem with labels in hover help
* reorganization of extras palette
* fixed problem of empty file with "Save as HTML" (saving screen capture)

66

* fixed bug preventing launch on (0.82-0.84)
* work around Rainbow problem with Save as image
* fixed bug re activate Stop Button on launch (thanks to rgs)
* added open from journal button (with rgs)
* fixed bug re Erase Button (hides status blocks)
* cleaned up some broken sample code

65

* fixed problem with View Toolbar
* moved Samples button to Help Toolbar

64

* major refactoring for new toolbar design
* stop sign turns off after execution is finished
* added preliminary support for mg and ta
* moved hover help to help toolbar
* adjusted artwork on Turtle palette

63

* more sample programs
* consolidated samples into one directory
* fixed mask bug that prevented palette hiding

62

* first pass at hover help support (thanks Raul)
* put samples button, keep button on project toolbar
* fixed journal icons associated with html, python, logo
* improved compatibility with old Sugar builds
* images centered under turtle
* text vertically centered under turtle
* pop blocks snap into boxes
* improved masks for fewer block-selection errors

61

* fixed es translation
* fixed problem with save/load on old systems

60

* fixed sharing bug
* began work on 701 backward compatibility
* added more debugging code

59

* fixed leading bug for OLPC XO portfolio
* enabled box to hold strings and journal objects

58

* fixed unicode string compare in equal block
* fixed journal description bug introduced in v55
* fixed misaligned myfunc block problem

57

* lots of artwork clean up
* elimination of lock block
* more dead key clean ups
* truncated strings

56

* more dead key cleanup
* empty (undefined) box error message

55

* dead key workaround

54

* debug button
* no more decimals by default for print

53

* es updates

52

* first attempt at fixing the mimetypes
* default behavior of tamyblock.py is to draw a dotted line

51

* caught ISO_Level3_Shift problem on OLPC XO keyboard

50

* fixed some problems with taexportlogo
* cleaned up save/load icons
* print uses title for Journal objects
* cleaned up movie window destroy code
* more consistent template management internally
* support of a sort for show in taexporthtml

49

* fixed character input bug

48

* reworking of media blocks
* json cleanup

== What is new for developers ==
The good news is that contributions are coming in from multiple sources. In particular, many thanks to Raúl Gutiérrez Segalés, who has contributed many patches. Raúl and I are working on a roadmap for a major refactoring for 0.88 which will include a block factory--a more object-oriented approach that should facilitate a more decentralized development approach.

== Internationalization (i18n) and Localization (l10n) ==
We now have support for:
* mg
* ta

'''Note:''' The artwork will be reworked once the translation team completes its work.

== Compatibility ==
Compatible with all versions of Sugar although some functionality is lost with pre-0.82 versions.

== Detailed changes ==
'''Version 71'''
* {{Bug|893}} Show multimedia tile to support text formats
* {{Bug|490}} Turtle Art should close video window properly
* {{Bug|343}} Turtle Art doesn't start on amd64 due to 32bit alsaaudio.so in bundle
* {{Bug|389}} Turtle Art with sensors needs special alsaaudio.so on XO
* {{Bug|451}} Rainbow problem copying module from Journal to data directory
* {{Bug|590}} Turtle Art user-defined block feedback
* {{Bug|672}} Export picture as pdf or png
* {{Bug|774}} Keep Error: json.encode() does not exist
* {{Bug|883}} TAPortfolio fails to keep the current project
* {{Bug|894}} Set scale is done in the object chooser tile should be in show tile?
* {{Bug|1054}} TA Text input brick, text should be right aligned (or keep cursor in view)
* {{Bug|1056}} TA showing Journal object (image) should be centered and rotated
* {{Bug|1084}} Usability enhancements for Turtle Art
* {{Bug|1186}} turtle art variables are not being saved
* {{Bug|1205}} Turtle Art not starting
* {{Bug|1269}} Strings in turtleart-activity.po in Fructose 0.84 need to have comments/notations for terms that should not be translated
* {{Bug|1290}} Turtle Art is using <Ctrl><Shift>+Q for Quit, should be <Ctrl>+Q
* {{Bug|1331}} Rainbow problem with Turtle Art save image
* {{Bug|127}} Turtle Art: Demo images not centered when first loaded
* {{Bug|241}} [portfolio] slide titles, stack labels and variable names do not truncate
* {{Bug|549}} Turtle Art, implement canvas scrollbars
* {{Bug|1288}} Key accelerators are all <Alt>, HIG specifies <Ctrl> is the default modifier
* {{Bug|1073}} Units of wait brick smaller than seconds
* {{Bug|1424}} Long help strings can't be seen at all
* {{Bug|1425}} Should the 'Hide blocks' button hide the blocks palette as well?
* {{Bug|1426}} lots of missing strings for spanish (probably for all other languages)
* {{Bug|1455}} int overflow crashes Turtle Art

==Open tickets==
* {{Bug|472}} Remove unexpected 'save/load' tab from toolbar
* {{Bug|489}} Turtle Art text entry should use Entry widget
* {{Bug|673}} Logo program should be displayable in the document View Source
* {{Bug|1057}} Turtle Art feature to add support for "pages"
* {{Bug|1188}} Load samples from turtleart.org
* {{Bug|1203}} Rebase Turtle Art graphics on Cairo
* {{Bug|155}} Turtle Art with Sensors has different requirements for non-XO hardware
* {{Bug|491}} Turtle Art sharing needs new logic
* {{Bug|548}} Turtle Art: read and write to text file
* {{Bug|552}} Turtle art: reinstate sensor input

== Credits ==
* Walter Bender and Raúl Gutiérrez Segalés (with help from Simon Schampijer)
* Especially helpful community feedback from Tony Forster and Bill Kerr
* Brian Silverman is the first author of Turtle Art

2009-03-09T17:05:25Z

Rgs:

=== Introduction ===

This page lists the places in the world where Sugar is used along with a contact person that will facilitate communication between the global and the local communities.

The column "# of members" is intended to give a rough estimation of the size of the local community and may include children, educators, parents, volunteers, etc

=== Asia ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
! Region
! Languages
! # of members
! Contact
|-
| Nepal
| Nepali
| 40
| [[USER:BryanWB|Bryan Berry]], Rabi Karmacharya
|-
| Quezon City, Philippines
| Filipino, English
| 30
| [[USER:Jgotangco|Jerome Gotangco]]
|}

=== Africa ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
! Region
! Languages
! # of members
! Contact
|-
| Ethiopia
| Amharic
| ?
| ?
|}

=== America ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
! Region
! Languages
! # of members
! Contact
|-
| Colombia
| Spanish
| 7
| RafaelOrtiz
|-
| Peru
| Spanish
| ?
| Hernan Pachas?
|-
| Uruguay
| Spanish
| ?
| Pablo Flores?
|-
| Paraguay
| Spanish
| 4500
| Raul Gutierrez S.
|-
| Boston, USA
| English
| ?
| Caroline Meeks?
|}

=== Europe ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
! Region
! Languages
! # of members
! Contact
|-
| Graz, Austria
| German
| 7
| David Van Assche, [[User:ChristophD|Christoph Derndorfer]]
|}

=== Oceania ===

{| border=1 cellpadding=3 style="border: 1px solid white; border-collapse: collapse; background: #e3e4e5;"
|-style="background:#787878; color: white;"
! Region
! Languages
! # of members
! Contact
|-
| Solomon Islands
| Pijin, Marovo
| ?
| David Leeming?
|}