Activity Team/Resources: Difference between revisions

Wade (talk | contribs)
References: Update Almanac link.
Wade (talk | contribs)
No edit summary
Line 56: Line 56:


====Sugar Human Interface Guidelines (HIG)====
====Sugar Human Interface Guidelines (HIG)====
* http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines.  
* http://sugarlabs.org/go/DesignTeam/Human_Interface_Guidelines.  


These pages give a good introduction to the thought process behind the Sugar environment and will help a lot when designing your activity.
Required reading before planning the user interface for your activity.  These pages give a good introduction to the thought process behind the Sugar environment and will help a lot when designing your activity.


====JSON introduction====
====JSON introduction====
Line 64: Line 64:


JSON is a data format commonly used to store activity data in the Journal.
JSON is a data format commonly used to store activity data in the Journal.
* http://simplejson.googlecode.com/svn/tags/simplejson-2.0.8/docs/index.html
Currently, the recommended JSON library is simplejson.  It has also become the standard JSON library in Python 2.6+.


====Git introduction====
====Git introduction====
Line 70: Line 74:
Git is the version control software used by Sugar Labs.  It is a distributed version control system and is quite powerful, but requires a lot of command line use.
Git is the version control software used by Sugar Labs.  It is a distributed version control system and is quite powerful, but requires a lot of command line use.


====XML routine====
====XML routines====
There are [http://docs.python.org/library/markup.html dozens] Python classes to satisfy XML standard but if you want just save/load parameters use "Zen of XML" in Python - [http://effbot.org/zone/element.htm ElementTree] library. It's supported out of the box in Python 2.5(xml.etree.ElementTree module). In previous version you'll have to install library by yourself.
There are [http://docs.python.org/library/markup.html dozens] Python classes to satisfy the XML standard, but if you want just save/load parameters use "Zen of XML" in Python - [http://effbot.org/zone/element.htm ElementTree] library. It's supported out of the box in Python 2.5 (xml.etree.ElementTree module). In previous versions you'll have to install library by yourself.
 
But if you just need a simple configuration format to read/write Python objects, check out JSON instead.


====Speech synthesizing====
====Speech synthesizing====
Line 86: Line 92:
* http://sugarlabs.org/go/DevelopmentTeam/Almanac Detailed Sugar API overview.  Quite in depth and offers answers to common questions.
* http://sugarlabs.org/go/DevelopmentTeam/Almanac Detailed Sugar API overview.  Quite in depth and offers answers to common questions.
* http://pygstdocs.berlios.de/ Python GStreamer bindings.
* http://pygstdocs.berlios.de/ Python GStreamer bindings.
* http://wiki.laptop.org/go/OLPC_Human_Interface_Guidelines The design behind the Sugar interface.  Useful when planning your activity.
* http://sugarlabs.org/go/DesignTeam/Human_Interface_Guidelines The design behind the Sugar interface.  Very important to read and understand before planning your activity's user interface.
* http://cairographics.org/documentation/pycairo/ Cairo Python API reference.  Very sparse, use the tutorial instead.
* http://cairographics.org/documentation/pycairo/ Cairo Python API reference.  Very sparse, use the tutorial instead.
* http://wiki.laptop.org/go/Low-level_Activity_API Information on how activities interact with Sugar.
* http://wiki.laptop.org/go/Low-level_Activity_API Information on how activities interact with Sugar.
Line 97: Line 103:
* http://www.tortall.net/mu/wiki/CairoTutorial A great introduction to Cairo in PyGTK and vector graphics drawing in general.
* http://www.tortall.net/mu/wiki/CairoTutorial A great introduction to Cairo in PyGTK and vector graphics drawing in general.
* http://www.json.org/fatfree.html An overview of the JSON data format.
* http://www.json.org/fatfree.html An overview of the JSON data format.
* http://simplejson.googlecode.com/svn/tags/simplejson-2.0.8/docs/index.html Documentation for the recommended JSON library.
* http://wiki.laptop.org/go/Shared_Sugar_Activities High level overview of collaboration.
* http://wiki.laptop.org/go/Shared_Sugar_Activities High level overview of collaboration.
* http://wiki.laptop.org/go/Collaboration_Tutorial Step by step tutorial on integrating collaboration into an activity.
* http://wiki.laptop.org/go/Collaboration_Tutorial Step by step tutorial on integrating collaboration into an activity.