Sugar Labs - User contributions [en]

Sandbox

2014-11-05T05:50:56Z

Tonyforster: /* This is a title */

Testing! again. ok. http://wiki.laptop.org

== This is a title ==

I can write whatever I like... well, almost...

* Fish
* Meat
* Veggies
* Ice cream

== Test interwiki links ==
The API call http://wiki.sugarlabs.org/api.php?action=query&meta=siteinfo&siprop=interwikimap dumps the set of interwiki links. [[Special:Interwiki]] provides a tool to edit them. Let's try some links.
* [[olpc:Help Activity refresh]]
* [[wikipedia:Constructionism (learning theory)]]

== Test Interwiki image links ==
Here's a screenshot from w.l.o, [[olpc:File:Activity_browse.jpg]], with the extra params that usually cause image display.
: [[olpc:File:Activity_browse.jpg|right|400px|thumb|Browse activity]]
doesn't seem to work?!
:: The <nowiki>[[File:imagefile|options]]</nowiki> code works with the local wiki image folder. One can embed sized external images from the absolute URI, such as http://wiki.laptop.org/skins/common/images/OLPC_wiki_logo.png or http://wiki.laptop.org/images/thumb/9/93/Ul_warning.png/120px-Ul_warning.png

The URI for an image can be discovered by inspecting the HTML element of an example image in the source wiki with a browser source inspector, such as, right click, Inspect Element in Firefox.

== Video support in Mediawiki ==

=== TimedMediaHandler ===

These examples employ the [http://www.mediawiki.org/wiki/Extension:TimedMediaHandler TimedMediaHandler] extension:

==== Matroska + WebM ====

Works in Chromium 18 and Firefox 9:

[[File:Itaipu.webm]]

==== OGG Theora + Vorbis ====

Works in Chromium 18 and Firefox 9:

[[File:Shinkansen.ogv]]

==== MPEG-4 x264 ====

This doesn't work:

[[File:Rio_de_Janeiro.mp4]]

[[Sandbox/OldVideoPlugins]]

=== Links to the raw videos ===

* http://codewiz.org/pub/pictures/vacation/iguazu_itaipu_2010/itaipu/MVI_1052.webm
* http://codewiz.org/pub/pictures/vacation/japan_2009/Shinkansen/00011-x264.avi
* http://codewiz.org/pub/pictures/vacation/japan_2009/Shinkansen/00008-mjpeg.avi
* http://codewiz.org/pub/pictures/vacation/japan_2009/Shinkansen/00010.ogg

== Iframe ==
{{Iframe|collapsed=|show this historical page|http://wiki.sugarlabs.org/index.php?title=Welcome_to_the_Sugar_Labs_wiki&oldid=2|900|600|0}}

SandBox

2014-11-05T05:48:59Z

Tonyforster: Created page with "Works for me"

Works for me

Features/Parental controls

2014-04-24T03:37:37Z

Tonyforster: /* Demand */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Demand==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. These features also make it easier to circumvent controls.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses.

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:54:45Z

Tonyforster: /* Marketing case */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Demand==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. These features also make it easier to circumvent controls.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses.

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:44:48Z

Tonyforster: /* Effectiveness */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. These features also make it easier to circumvent controls.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses.

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:42:06Z

Tonyforster: /* Effectiveness */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. These features also make it easier to circumvent controls.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses.

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:36:13Z

Tonyforster: /* Education case */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. These features also make it easier to circumvent controls.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses, there is the saying "locks only keep out honest people".

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:24:30Z

Tonyforster: /* Education case */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses, there is the saying "locks only keep out honest people".

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:20:49Z

Tonyforster: /* Effectiveness */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. Any locking down of the software would be inconsistent with the design philosophy.

==Effectiveness==
Any kind of lock will fail to block a proportion of illegitimate uses while blocking a proportion of legitimate uses, there is the saying "locks only keep out honest people".

There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:15:26Z

Tonyforster: /* Unintended consequences */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. Any locking down of the software would be inconsistent with the design philosophy.

==Effectiveness==
There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==
Would there be unintended losses in functionality?

* legitimate browsing, eg researching breast cancer
* switching to Gnome
* launching non Sugar activities from Terminal, eg the Arduino IDE
* Pippy
* Turtle Blocks
* Develop
* cloning an Activity
* (re)installing Activities
* reflashing with a different build

Features/Parental controls

2014-04-24T02:10:57Z

Tonyforster: /* Default or optional feature */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==
It is proposed that this be included in XO and SOAS builds. Deployments and others would be free to create customised builds which included or excluded this feature. Would the default builds published by Sugarlabs include the feature?

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. Any locking down of the software would be inconsistent with the design philosophy.

==Effectiveness==
There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==

Features/Parental controls

2014-04-24T02:07:59Z

Tonyforster: /* The proposal */

==The proposal==
http://lists.sugarlabs.org/archive/sugar-devel/2014-April/048045.html

==Default or optional feature==

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. Any locking down of the software would be inconsistent with the design philosophy.

==Effectiveness==
There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==

Features/Parental controls

2014-04-24T02:05:18Z

Tonyforster: /* Effectiveness */

==The proposal==

==Default or optional feature==

==Marketing case==
"Not only am I basing this on the inclusion of a similar feature in OS X, I am also basing this on the fact that some Nigerian children reportedly visited a Web site containing pornography. I have no other evidence." (Ryan)

How often would this feature be used? How do we estimate this?

==Education case==
Does this feature enhance or detract from Sugar's effectiveness for facilitating learning.

A central platform of OLPC and Sugar is that children should be creators rather than consumers. This has been facilitated in a number of ways, show source, cloning Activities, easy reflashing of the OS. Any locking down of the software would be inconsistent with the design philosophy.

==Effectiveness==
There are a number of potential ways to circumvent parental controls

* switching to Gnome
* using Pippy to create a browser
* using Turtle Blocks to create a browser (yes its easy!)
* using Develop to create a browser
* cloning an Activity
* installing another browser Activity
* installing Browse with an altered name
* reflashing with a different build

==Unintended consequences==

Features/Parental controls

2014-04-24T02:01:31Z

Tonyforster: /* Education case */

Features/Parental controls

2014-04-24T01:57:22Z

Tonyforster: /* Marketing case */

Features/Parental controls

2014-04-24T01:53:19Z

Tonyforster: Created page with "==The proposal== ==Default or optional feature== ==Marketing case== ==Education case== ==Effectiveness== ==Unintended consequences=="

==The proposal==

==Default or optional feature==

==Marketing case==

==Education case==

==Effectiveness==

==Unintended consequences==

User:Tonyforster

2014-04-24T01:51:23Z

Tonyforster: /* Patch */

== Me ==
http://tonyforster.blogspot.com/ blog, random thoughts, Turtle Art samples

http://www.freewebs.com/schoolgamemaker/ game programming and learning

forster at ozonline dot com dot au

Interests:
Activities which maximise the opportunity for self-directed learning: low floor, wide walls and high ceiling with particular emphasis on the walls and ceiling. My Sugar favourites: [[Activities/TurtleArt-0.88 | Turtleart]], Scratch, Etoys. [http://www.yoyogames.com Game Maker] still my Windows favourite.

Currently user testing Turtleart and Sliderule, experimenting with [[Activities/Pippy | Pippy]]. Supporting the [http://www.seaton-olpc-ug.org/?q=node/54 Timor Leste deployment].

== Preschool student Activities, some links==
Radia Perlman in the 70s when at student at MIT did extensive experiments with preliterate children and the LOGO turtle and built a number of interfaces for them. She also spent some time at Xerox PARC and did many similar experiments with chldren 3 years on up.

http://www.formatex.org/micte2006/virtual/pdf/582.pdf
see fig 3 with plastic cards showing visual images of turtle commands

http://www.formatex.org/micte2006/virtual/ppt/582.ppt
similar image

http://logothings.wikispaces.com/
towards the end, photo of Radia Perlman's Button Box for Pre-Schoolers

http://alumni.media.mit.edu/~mcnerney/personal-ubicomp.pdf
more discussion than the above

== Turtle Art - text free ==
To what extent could pre-literate children use Turtle Art?

Are graphics on blocks really better than text?

Does keeping text labels help develop literacy?

What graphics are best?

Some features, eg. the heap are unlikely to be used by pre-literate children, should they be omitted or retained with text labels?

The following graphic is a discussion starter

[[Image:Textfreeturtle.jpg|300px]]

or another [[http://wiki.sugarlabs.org/images/c/cd/Iconic_Turtle_Art.odt suggested layout]]]

== Text-less outdoor lesson for Turtle Art ==
[[File:Outdoor-TA.jpg|400px]]

== Sliderule ==
* http://tonyforster.blogspot.com/2010/09/pippy-sliderule.html Pippy [[File:Pippy_sliderule.doc]]
* http://tonyforster.blogspot.com/2010/09/turtle-sliderule.html Turtle art
* http://www.freewebs.com/schoolgamemaker/#lobject Game maker
* [[File:Slideruletute.pdf]] tutorial

== Presentations - Software Freedom Day Melbourne ==
[[File:Softwarefreedomday10.pdf]] presentation

http://luv.asn.au/sfd2010/ photos

[[File:Olpc-rotary.odp]]

[[File:Ictev11.odp]]

== Sea Surface Temperature Mapping ==
Sea surface temperature mapping, inspired by http://oceanpc.org . Described here is a program to read and display the temperature data which is available at http://www.ncdc.noaa.gov/oa/climate/research/sst/sst.html

The data format is described at ftp://eclipse.ncdc.noaa.gov/pub/ersstv3b/README

The first record in the file [ftp://eclipse.ncdc.noaa.gov/pub/ersstv3b/ascii/ ersst_v3b_2010_2019.asc] , the 2010 to 2019 data set, reads:
-9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -19 13 18 11 7 25 64 132 255 427 607 791 990 1198 1408 1616 1816 1999 2149 2258 2327 2360 2365 2355 2347 2359 2393 2443 2500 2568 2654 2736 2789 2826 2869 2904 2911 2903 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 -9999 1489 1432 -9999 -9999 -9999 -9999 -9999 713 -9999 656 715 780 796 744 669 596 476 298 156 113 70 -134 -180 -180 -180 -180

-9999 represents land, the other numbers are degrees C x100
This record represents a line running from the south pole through to the north pole in 2 degree increments at longtitude 0 for the first month and year. The next record is for lattitude 2 degrees east and so on.

 Sample Pippy(Python) program 

This Pippy(Python) mapping program is supplied as a starter and as inspiration for further investigation

[[File:Write Activity sst.odt]] Pippy code as open office doc. Download and open in Journal. Copy from the Write session, paste into Pippy and run.

Alternatively download this content bundle [[File:Sst.xol]] to the journal, starting the bundle from the journal installs the bundle as off line web content which is accessible from the Browse home page as sst in the Science category. This content includes the Python source and a sample data file.

[[File:Sstcontentbundle.jpg|250px]]

 Challenges 
* Display the other months and years in the file
* Display the month and year in the title bar
* Animate the display
* Do a legend
* Display the temperature at the cursor
* Map other data
* Error checking
* Display partly corrupted data sets without crashing
* Create models of ocean or atmosphere
* More ideas at http://oceanpc.org , http://marinedataliteracy.org/index.html and http://data.worldbank.org/

[[File:Screenshot of "pygame window".png|300px]]

(This program has also been [http://www.freewebs.com/schoolgamemaker/#lobject done in Game Maker] on the Windows OS)

==Reflashing Sugar==
===Unsigned XO1===
[http://wiki.laptop.org/go/Clean-install_procedure See]

*Get a developer key and unlock your XO
*Download the OS image (e.g. osxxx.img) and its CRC file (e.g. osxxx.crc) to USB
*Press escape at power on for the OK prompt
probe-usb copy-nand disk:\osNNN.img

Will not work if there are 2 partitions, [http://wiki.laptop.org/go/11.2.0]

To install from Open Firmware on an unlocked XO-1, download the .onu and .uim files and run:

ok update-nand u:\osXX.onu

===Unsigned XO1.5===
[http://dev.laptop.org.au/projects/xo-au/wiki/Installing_unsigned_builds see]
*Get a developer key and unlock your XO
*Download osxxx.zd, osxxx.zsp.fs.zip, (seem to only need the zd file)
*rename the zip file to fs.zip
*Pressing the "check mark"(tick) game key, Turn on the laptop, (don't seem to need the tick)
*press ESC (X) to get to the OFW prompt "ok",
fs-update u:\osxxx.zd

===Signed builds===
[http://wiki.laptop.org/go/Release_notes/10.1.2#Installation see]

*Download osxxx.img, osxxx.img.fs.zip to the top directory of a USB drive
*(osxxx.zd,osxxx.zsp.fs.zip on XO1.5),
*Rename the zip file to fs.zip
* hold the 4 game keys at boot

===Deployment key signed builds===
http://dev.laptop.org.au/projects/xo-au/wiki/Installing_signed_builds

===Nand blaster XO1.5===
http://wiki.laptop.org/go/Nandblaster_for_XO-1.5

==Dodo mobile broadband on the XO==
Connected to the [http://www.dodo.com.au/wireless/ Dodo mobile broadband] network with the Huawei E160E

* username my username
* password my password
* number *99#
* APN dodolns1
* PIN blank
* PUK blank

(best with power management turned off)

==Sugar security==
Some Activities are 'protected', that is they can't be deleted. This also means that the Activity can't be downgraded or crossgraded to the same revision number.

To achieve this you need to delete the Activity's directory in

/home/olpc/Activities

This is easily done in older builds in Gnome but newer builds have a hidden and protected Activities directory

sudo gedit

allows you to edit files but not delete

chmod 777 ~/Activities
chmod 777 ~/Activities -r #contents too?

unprotects the directory but it is still hidden, in the file manager nautilus check show hidden files

To automate this every time Gnome starts, add the following 2 commands to System, Preferences, Startup applications

rm .hidden
chmod 777 Activities

==Enabling debug output==
Edit /home/olpc/.sugar/debug and uncomment :
export SUGAR_LOGGER_LEVEL=debug

==Starting Gnome==
If not in my settings
echo gnome > /home/olpc/.olpc-active-desktop
and restart

==Setting the clock==
From firmware, using the internet, networkname is your modem/router eg DLINK
ok essid networkname
ok ntp-set-clock pool.ntp.org
ok .clock
Worked despite timeout message

or http://wiki.laptop.org/go/Fix_Clock#Reprogram_the_time.2Fdate

==Text dungeon==
A text dungeon game for literacy and numeracy

Most of this page transferred to [[Activities/Textdungeon]] , just the command line version here

[[File:Text dungeon.jpg|300px]]

The dungeon [[File:Sampledungeon.doc | description file]]

[[File:Textdungeon.doc | the program]] is a version of the program's Python code which works from the command line

[[File:Textdungeon1.xo]] is a Sugarised install bundle, works Sugar 0.88 - 0.92

[[File:Textdungeon2.xo]] Sugar compliant icon, do not load sample file if resuming, backspace supported, journal entry saves progress)

===Keyboard commands===
h - help

f - forward

r - right

l - left

b - list backpack contents

p item - pick up item

d item - drop item

u item - use item

q - quit

==1.75 accelerometer ==
[[File:Screenshot of sugar-activity 3 axis.png|300px]]

The vertical axis is raw reading/4 so 1G=250

[[File:Turtle Art Activity 3 axis.ta]]

==Screenshots in Sugar==
===Simple screenshot===
To take screenshots press Alt 1

This will capture the screen but not the mouse cursor

===Screenshot with cursor===
To also capture the mouse cursor, install gnome-screenshot. Type the following in Terminal:

sudo yum install gnome-utils

You can then start the interactive version of gnome-screenshot:
gnome-screenshot --interactive

[[File:Gnome-screenshot.png|350px]]

Check that you have the right options selected and that 'Include pointer' is selected, then click Take Screenshot. Do not navigate away to the screen you want the screenshot of because you will be unable to navigate back to the utility. At this point we are just checking that the options are correct.

[[File:Gnome-screensh-2.png|350px]]

Select a suitable save location such as 'Documents' and click Save.

Now you are ready to take a screenshot. Start gnome-screenshot from Terminal with a suitable delay, eg. 2 seconds

gnome-screenshot -d 2

Immediately go to the screen you wish to capture, position the cursor where you want it, get the menus etc. as you want them and wait for the dialog box. Click Save. (Later versions of Sugar allow you to access the saved file in Documents but the folder contents are not updated, you may need to switch between Journal and Documents to see the updated file listing.)

==Miscellaneous_Technical_Notes==
http://wiki.laptop.org/go/User:Kevgor/Miscellaneous_Technical_Notes

==GIT and patches==
===GIT local repository===
sudo install git

clone the git of the Turtle, in a terminal, make:

git clone git://git.sugarlabs.org/turtleart/mainline.git

In the mainline folder there are all turtle's files..

===Patch===
sudo yum install patch
or
sudo yum install patch --nogpg

Should be a "raw patch" link (eg. 2b4ecb0cc7095f47fc944c54512e055c21537ab5.patch)

1. Save that page as a file into ~/Activities/TurtleArt.activity (eg patching Turtle Art)

2. From terminal run the patch command as follows:

patch -p1 < 2b4ecb0cc7095f47fc944c54512e055c21537ab5.patch

That is it. (Note, you should be able to use autocomplete when typing
the command line by hitting tab after typing the first few letters of
the patch file name.)

[[Activities/Butialo]]
[[Features/Parental_controls]]

Activities/Turtle Art/Toolbars

2014-04-14T08:50:10Z

Tonyforster: /* Edit Toolbar */

<noinclude>__NOTOC__</noinclude>
==Toolbars==

===Main Toolbar===

[[Image:TAmain.png|800px]]

From left to right:
* Activity toolbar (includes sharing; saving/loading options);
* Edit toolbar (including copy and paste);
* View toolbar (including full-screen, coordinate overlays; turtle status, etc.);
* Palette toolbar (including all programming blocks);
* erase canvas;
* run project fast (rabbit);
* run project slow (snail);
* hide blocks (This button is replaced by the stop button when the project is running);
* help;
* load examples;
* stop activity

;Note: Keyboard short cuts for the above: Alt+ '''p'''alette; '''b'''locks; '''r'''un; '''w'''alk; '''s'''top; '''e'''rase; e.g., Alt+e will erase the screen. Esc will return from full-screen mode.

;Note: The run buttons are tied to the [[#descriptions (6)|Start Block]]. If no Start Block is used, then all blocks are run when either run button is clicked.

;Note: The "rabbit" button runs the blocks at maximum speed. The "snail" button pauses and displays the turtle and block values between each step.

;Note: The [[Image:Show-blocks.svg]] button, which is replaced by the Stop button on the main toolbar while the program is executing, is used to reveal the program blocks. Individual palettes can be hidden by clicking on their highlighted tab.

;Note: On older versions of Sugar (e.g., 0.84), the main toolbar will look like this:

[[File:TA0.84.png|800px]]

===Project Toolbar===

[[File:TurtleBlocks_Toolbar_1.png|800px]]

From left to right:
* Project title;
* Write to Journal (on newer versions of Sugar)
* Keep button (not shown; only appears on older Sugar systems)
* [[#Sharing|Share]] button;
* Share blocks button used to share stacks of blocks between collaborators (shown in inactive state);
* Save palette button (shows save options; see below);
* Load palette button (shows load options; see below)

;Note: On older Sugar systems, these controls appear on the Import/Export toolbar.
;Note: To share a stack, click on the share button. The cursor will change to the hand shape [[File:Ta-hand-cursor.png]]. Place the cursor on any block or stack of blocks and click. The blocks will be shared and the cursor will change back to the arrow shape.

[[File:TurtleBlocks_Toolbar_1a.png|800px]]

[[File:TurtleBlocks_Toolbar_1b.png|800px]]

===Edit Toolbar===

[[File:TurtleBlocks_Toolbar_2.png|800px]]

The Edit toolbar is used to copy stacks of blocks to the clipboard and to paste stacks from the clipboard. To copy a stack, click on the copy button or type Ctrl-c. The cursor will change to the hand shape [[File:Ta-hand-cursor.png]]. Place the cursor on any block or stack of blocks and click. The blocks will be copied to the Sugar clipboard and the cursor will change back to the arrow shape. To paste from the clipboard, type Ctrl-v or click the paste button.

From left to right:
* Copy;
* Paste;
* Undo (Restore blocks from trash);
* Save stack to custom palette (use the hand cursor to select a stack to save, the stack of blocks must start with an "action" block);
* Remove stack from custom palette (use the hand cursor to select a stack on the custom palette to delete)

;Note:After save stack: To show the custom palette or see new stacks it is necessary to restart TurtleBlocks

===View Toolbar===

[[File:TurtleBlocks_Toolbar_4.png|800px]]

From left to right:
* Full-screen button;
* Cartesian-coordinate grid;
* polar-coordinate grid;
* ''not shown'': centimeter-coordinate grid (XO-only);
* Rescale-coordinates button (There are two modes: one pixel-based and one scaled from -20 to 20);
* Grow block size;
* Shrink block size
* Disable/enable hover help
* display of x,y coordinates, heading of turtle;

=== Palettes Toolbar ===

The palette menus are revealed by clicking on the Block icon on the main toolbar. (On older Sugar systems, select the Projects toolbar. When running Turtle Art from GNOME, the palettes are visible by default.)

[[File:TurtleBlocks_Toolbar_5.png|800px]]

There are ten palettes of program elements available for program construction: [[Activities/Turtle_Art/Turtle|Turtle movements]]; [[Activities/Turtle_Art/Pen|Pen attributes]]; Color attributes; [[Activities/Turtle_Art/Numbers|Numeric operators]]; [[Activities/Turtle_Art/Flow|Logical operators]]; [[Activities/Turtle_Art/Blocks|Logical blocks]]; [[Activities/Turtle_Art/Sensors|Sensor blocks]]; Media blocks; Customization functions; and [[Activities/Turtle_Art/Templates|Presentation blocks]]. An eleventh palette is used for restoring blocks from the trash.

;Note: Additional palettes may be loaded by [[Activities/Turtle_Art#plugins|plugin]] extensions to Turtle Blocks.

;Note: A custom palette is created if you use the 'save stack' button on the Edit toolbar.

;Note: Blocks are dragged from the palette onto the canvas surface. To dispose of a block, drag it back onto the palette. (It will be placed onto the trash palette.)

;Note: The palettes can be displayed horizontally or vertically (See below). Orientation is adjusted by clicking on the [[Image:TAorientation0.svg]] and [[Image:TAorientation1.svg]] buttons on the upper-left corner of the palette.

;Note: The palette can be hidden by clicking on the [[Image:TAhide.svg]] button on the lower-right corner of the palette.

;Note: The next palette in the menu can be accessed by clicking on the [[Image:TAnext.svg]] button on the upper-right corner of the palette.

;Note: On smaller screens, a palette may not fit. It can be scrolled by clicking on the [[Image:TAscroll.svg]] button.

====Turtle Palette====
[[Image:TAturtle.png|800px]]

These blocks are used to control the movements of the turtle.

* forward: move turtle forward
* back: move turtle backward
* clean: clear the screen and position the turtle in the center of the screen, pen down, color red, heading 0
* left: rotate turtle counterclockwise
* right: rotate turtle clockwise
* arc: move turtle along an arc
* set xy: set turtle x,y position (0,0) is the center of the screen
* seth: set turtle heading
* xcor: holds current x-coordinate value of the turtle (can be used in place of a number block)
* ycor: holds current y-coordinate value of the turtle (can be used in place of a number block)
* heading: holds current heading value of the turtle (can be used in place of a number block)

====Pen Palette====
[[Image:TApen.png|800px]]

These blocks are used to control the attributes of the turtle's pen.

* pen up: turtle will not draw when moved
* pen down: turtle will draw when moved
* set pen size: sets the width of the line drawn by the turtle
* fill screen: fill the screen with a color/shade and reposition the turtle in the center of the screen
* pen size: width of the line drawn by the turtle (can be used in place of a number block)
* set color: sets the pen color
* set shade: sets the pen shade
* set gray: sets the gray-level of the pen (Only available in Turtle Blocks)
* color: current pen color (can be used in place of a number block)
* shade: current pen shade (can be used in place of a number block)
* gray: current pen gray level (can be used in place of a number block) (Only available in Turtle Blocks)
* start fill: starts a filled polygon (straight sides, not arcs)
* end fill: ends a fill polygon (straight sides, not arcs)

====Color Palette====
[[Image:TAcolors.png|800px]]

These blocks can be used with the set-pen-color block in place of a number block.

====Numbers Palette====
[[Image:TAnumbers.png|800px]]

These blocks are arithmetic and boolean operators.

* addition: adds two numeric inputs (also can be used to concatenate strings)
* subtraction: subtracts the bottom numeric input from the top input
* multiplication: multiplies two numeric inputs
* division: divided top input (numerator) by bottom input (denominator)
* identity: identity function (used for spacing blocks)
* modulo (remainder): calculates remainder when dividing top input by the bottom input
* square root (Only available with Turtle Blocks)
* random number: generates a random integer between the minimum and maximum values
* number block: a numeric input
* greater than: boolean greater than operator (used with flow blocks)
* less than: boolean less than operator (used with flow blocks)
* equal to: boolean equal to operator (used with flow blocks)
* not: boolean not (Only available with Turtle Blocks)
* and: boolean and (Only available with Turtle Blocks)
* or: boolean or (Only available with Turtle Blocks)

====Flow Palette====
[[Image:TAflow.png|800px]]

These blocks control program flow.

* wait: pause program execution (unit is seconds)
* forever: continuously repeat execute stack under the right flow
* repeat: repeat the execution of stack under the right flow a specified number of times
* if/then: conditional execution of the stack under the right flow (uses boolean operators found on the Number palette)
* if/then/else: conditional execution of the stack under the center and right flows (uses boolean operators found on the Number palette)
* vertical spacer
* stop stack: interrupt execution
* while: execute stack under right flow ''while'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)
* until: execute stack under right flow ''until'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)

'''Note:''' Nesting ''while'' and/or ''until'' blocks is not always reliable. If you encounter an error, try putting the nested block in a separate stack, accessed with an action block.

====Blocks Palette====
[[Image:TAblocks.png|800px]]

These blocks are for defining variables and subroutines. Without actions

* start: connects action to toolbar 'Run' button
* store in: store a number, string, or media object in a named box
* action: top of named action stack
* action: execute named action stack

'''Note:''' When a named action or named box block are used, new blocks appear on the palette that correspond to these names; e.g., if a top of action stack is rename, "to square", an action block, "to square" is added to the palette.

[[Image:TAblocks_yes.png|800px]]

Palette with additional actions and boxes created by the user.

====Sensors Palette====
[[Image:TAsensors.png|800px]]

* query keyboard: check for keyboard input (results are stored in the keyboard block)
* keyboard: current value of keyboard input (can be used in place of a number block)
* read pixel: push the RGB value of the pixel under the turtle onto the FILO (blue is first, red is last)
* turtle sees: the "palette color" of the pixel under the turtle
* time: number of seconds since program began
* sound: raw data from microphone ranging -32000 to 32000
* volume (loudness): ranging 0 to 32000
* pitch: the resolution is +-8Hz
* brightness: average luminance seen through camera
* button down: current state of the mouse button (1 == down; 0 == ip)
* mouse x: x position of mouse
* mouse y: y position of mouse

The OLPC XO can measure external inputs with its microphone jack:
* resistance: measurement range is 750 to 14k ohms, (OLPC XO1) and 2k ohms to open circuit (OLPC XO1.5)
* voltage: measurement range is DC 0.4V to 1.85V. (OLPC XO1) and 0.17V to 3.0V (OLPC XO1.5)

The OLPC XO 1.75 also includes an accelerometer.
* accelerate (not shown): measure the acceleration of the computer. Results are pushed to the stack and can be retrieved by using 3 'pop' blocks (one for X (horizontal), one for Y (vertical), and one for Z (forward/backward))

See [[Activities/Turtle Art/Using Turtle Art Sensors]] for more details about the sensor blocks.

([[Activities/Turtle Art/Uso de Tortuga Arte Sensores]] español)

====Media Palette====
[[Image:TAmedia.png|800px]]

These are a collection of blocks used for displaying media objects, such as images from the Journal.

* journal: Sugar Journal media object (used with show block) (also available in Turtle Art)
* audio: Sugar Journal media object (used with show block)
* video: Sugar Journal media object (used with show block)
* description: Sugar Journal description field (used with show block)
* text: text string (used with show block; also used with box and action blocks)
* show: draw text or display media object from the Journal
* set scale: sets the scale of images displayed with show block
* save picture: save the canvas to the Sugar Journal as a .png image (note: saves the canvas as displayed)
* save SVG: save turtle graphics to the Sugar Journal as a .svg image (note: only saves the changes to the canvas in the current execution run)
* scale: sets scale for show block (100% is full-screen)
* media wait: used to pause program while audio or video file plays
* media stop: stop current sound or video
* media pause: pause current sound or video
* media resume: resume playing paused media
* speak: sends text to the voice synthesizer
* sine wave: plays a sine wave of a given frequency, amplitude, and duration

====Extras Palette====
[[Image:TAextras.png|800px]]

These are a collection of extra blocks for accessing advanced features only available in Turtle Blocks.

* push: push value onto FILO (first-in last-out) heap
* show heap: show FILO in status block
* empty heap: empty the FILO
* pop: pop value off of the FILO (can be used in place of a number block)
* print: print value in status block (also available in Turtle Art)
* comment: program comment (displayed in "walk" mode)
* chr: Python chr primitive: converts ASCII to character (useful for converting keyboard input to text)
* int: Python int primitive: converts input to integers
* Python: a [[Activities/Turtle Art-0.88#Python_function_block|programmable block]] (can be used in place of a number block)
:: add your own math equation in the block, e.g., sin(x); This block is expandable to support up to three variables, e.g. f(x,y,z)
* Import Python: [[Activities/Turtle Art-0.88#Python_code_block|import Python code]] from the Sugar Journal (a more general-purpose programmable block). This block accepts a single variable x, as an input or up to 3 variables as an array x[0], x[1] and x[2]
* Cartesian: display Cartesian coordinate grid overlay
* polar: display polar coordinate grid overlay
* turtle: specify which turtle is active
* turtle shell: import a image from the Journal to use as the turtle's 'shell', i.e., replace the turtle with a sprite.
* turtle x: Return x coordinates of turtle
* turtle y: Return y coordinates of turtle
* active turtle: the name of active turtle
* turtle heading: Return heading of turtle
* URL: gets a text string or image from a URL

====Portfolio Palette====
[[Image:TAportfolio.png|800px]]

These blocks are used to make multimedia presentations only available in Turtle Blocks.

* hide blocks: hides all blocks and palettes (useful for decluttering the screen during presentations) (also available in Turtle Art)
* show blocks: shows blocks and palettes (useful for resuming programming after a presentation)
* full screen: goes into full-screen mode (hides Sugar toolbars)
* list slide: used for bulleted lists; This block is expandable, allowing you to add as many bullets as you need
* picture slides: used for picture slides (1×1, 2×2, 1×2, and 2×1)
Only available in Turtle Blocks:
* left: holds current x-coordinate value of the left edge of the screen (can be used in place of a number block)
* top: holds current y-coordinate value of the top edge of the screen (can be used in place of a number block)
* right: holds current x-coordinate value of the right edge of the screen (can be used in place of a number block)
* bottom: holds current y-coordinate value of the bottom edge of the screen (can be used in place of a number block)
* width: screen width (can be used in place of a number block)
* height: screen height (can be used in place of a number block)
::Note: The slide blocks expand into stacks that can be edited for customized presentations.

====User custom-stack palette====
[[Image:TAStack.png|800px]]

The custom palette holds any blocks that have been saved with "Save Stack" option in Edit Toolbar. It lets you reuse stacks between projects.
Blocks on this palette will expand into action stacks.

;Note: This palette first appears after using the "Save stack" option on the Edit Toolbar.

====Trash Palette====
[[Image:TAtrash.png|800px]]

This palette holds any blocks that have been put in the trash. You can drag blocks out of the trash to restore them. The trash palette is emptied when you quit Turtle Art.

====Vertical palettes====
[[Image:TAvertical.png|300px]]

An example of a vertical palette. Vertical palettes are used by default on the OLPC XO laptops running older versions of Sugar.

====Palettes en español====

<gallery>
File:TAturtle-es.png
File:TApen-es.png
File:TAcolors-es.png
File:TAnumbers-es.png
File:TAflow-es.png
File:TAboxes-es.png
File:TAmedia-es.png
File:TAsensors-es.png
File:TAextras-es.png
File:TAstack-es.png
File:TAportfolio-es.png
File:TAtrash-es.png
</gallery>

Activities/Turtle Art/Toolbars

2014-04-14T08:48:59Z

Tonyforster: /* Edit Toolbar */

<noinclude>__NOTOC__</noinclude>
==Toolbars==

===Main Toolbar===

[[Image:TAmain.png|800px]]

From left to right:
* Activity toolbar (includes sharing; saving/loading options);
* Edit toolbar (including copy and paste);
* View toolbar (including full-screen, coordinate overlays; turtle status, etc.);
* Palette toolbar (including all programming blocks);
* erase canvas;
* run project fast (rabbit);
* run project slow (snail);
* hide blocks (This button is replaced by the stop button when the project is running);
* help;
* load examples;
* stop activity

;Note: Keyboard short cuts for the above: Alt+ '''p'''alette; '''b'''locks; '''r'''un; '''w'''alk; '''s'''top; '''e'''rase; e.g., Alt+e will erase the screen. Esc will return from full-screen mode.

;Note: The run buttons are tied to the [[#descriptions (6)|Start Block]]. If no Start Block is used, then all blocks are run when either run button is clicked.

;Note: The "rabbit" button runs the blocks at maximum speed. The "snail" button pauses and displays the turtle and block values between each step.

;Note: The [[Image:Show-blocks.svg]] button, which is replaced by the Stop button on the main toolbar while the program is executing, is used to reveal the program blocks. Individual palettes can be hidden by clicking on their highlighted tab.

;Note: On older versions of Sugar (e.g., 0.84), the main toolbar will look like this:

[[File:TA0.84.png|800px]]

===Project Toolbar===

[[File:TurtleBlocks_Toolbar_1.png|800px]]

From left to right:
* Project title;
* Write to Journal (on newer versions of Sugar)
* Keep button (not shown; only appears on older Sugar systems)
* [[#Sharing|Share]] button;
* Share blocks button used to share stacks of blocks between collaborators (shown in inactive state);
* Save palette button (shows save options; see below);
* Load palette button (shows load options; see below)

;Note: On older Sugar systems, these controls appear on the Import/Export toolbar.
;Note: To share a stack, click on the share button. The cursor will change to the hand shape [[File:Ta-hand-cursor.png]]. Place the cursor on any block or stack of blocks and click. The blocks will be shared and the cursor will change back to the arrow shape.

[[File:TurtleBlocks_Toolbar_1a.png|800px]]

[[File:TurtleBlocks_Toolbar_1b.png|800px]]

===Edit Toolbar===

[[File:TurtleBlocks_Toolbar_2.png|800px]]

The Edit toolbar is used to copy stacks of blocks to the clipboard and to paste stacks from the clipboard. To copy a stack, click on the copy button or type Ctrl-c. The cursor will change to the hand shape [[File:Ta-hand-cursor.png]]. Place the cursor on any block or stack of blocks and click. The blocks will be copied to the Sugar clipboard and the cursor will change back to the arrow shape. To paste from the clipboard, type Ctrl-v or click the paste button.

From left to right:
* Copy;
* Paste;
* Undo (Restore blocks from trash);
* Save stack to custom palette (use the hand cursor to select a stack to save, the stack of blocks must atart with an "action" block);
* Remove stack from custom palette (use the hand cursor to select a stack on the custom palette to delete)

;Note:After save stack: To show the custom palette or see new stacks it is necessary to restart TurtleBlocks

===View Toolbar===

[[File:TurtleBlocks_Toolbar_4.png|800px]]

From left to right:
* Full-screen button;
* Cartesian-coordinate grid;
* polar-coordinate grid;
* ''not shown'': centimeter-coordinate grid (XO-only);
* Rescale-coordinates button (There are two modes: one pixel-based and one scaled from -20 to 20);
* Grow block size;
* Shrink block size
* Disable/enable hover help
* display of x,y coordinates, heading of turtle;

=== Palettes Toolbar ===

The palette menus are revealed by clicking on the Block icon on the main toolbar. (On older Sugar systems, select the Projects toolbar. When running Turtle Art from GNOME, the palettes are visible by default.)

[[File:TurtleBlocks_Toolbar_5.png|800px]]

There are ten palettes of program elements available for program construction: [[Activities/Turtle_Art/Turtle|Turtle movements]]; [[Activities/Turtle_Art/Pen|Pen attributes]]; Color attributes; [[Activities/Turtle_Art/Numbers|Numeric operators]]; [[Activities/Turtle_Art/Flow|Logical operators]]; [[Activities/Turtle_Art/Blocks|Logical blocks]]; [[Activities/Turtle_Art/Sensors|Sensor blocks]]; Media blocks; Customization functions; and [[Activities/Turtle_Art/Templates|Presentation blocks]]. An eleventh palette is used for restoring blocks from the trash.

;Note: Additional palettes may be loaded by [[Activities/Turtle_Art#plugins|plugin]] extensions to Turtle Blocks.

;Note: A custom palette is created if you use the 'save stack' button on the Edit toolbar.

;Note: Blocks are dragged from the palette onto the canvas surface. To dispose of a block, drag it back onto the palette. (It will be placed onto the trash palette.)

;Note: The palettes can be displayed horizontally or vertically (See below). Orientation is adjusted by clicking on the [[Image:TAorientation0.svg]] and [[Image:TAorientation1.svg]] buttons on the upper-left corner of the palette.

;Note: The palette can be hidden by clicking on the [[Image:TAhide.svg]] button on the lower-right corner of the palette.

;Note: The next palette in the menu can be accessed by clicking on the [[Image:TAnext.svg]] button on the upper-right corner of the palette.

;Note: On smaller screens, a palette may not fit. It can be scrolled by clicking on the [[Image:TAscroll.svg]] button.

====Turtle Palette====
[[Image:TAturtle.png|800px]]

These blocks are used to control the movements of the turtle.

* forward: move turtle forward
* back: move turtle backward
* clean: clear the screen and position the turtle in the center of the screen, pen down, color red, heading 0
* left: rotate turtle counterclockwise
* right: rotate turtle clockwise
* arc: move turtle along an arc
* set xy: set turtle x,y position (0,0) is the center of the screen
* seth: set turtle heading
* xcor: holds current x-coordinate value of the turtle (can be used in place of a number block)
* ycor: holds current y-coordinate value of the turtle (can be used in place of a number block)
* heading: holds current heading value of the turtle (can be used in place of a number block)

====Pen Palette====
[[Image:TApen.png|800px]]

These blocks are used to control the attributes of the turtle's pen.

* pen up: turtle will not draw when moved
* pen down: turtle will draw when moved
* set pen size: sets the width of the line drawn by the turtle
* fill screen: fill the screen with a color/shade and reposition the turtle in the center of the screen
* pen size: width of the line drawn by the turtle (can be used in place of a number block)
* set color: sets the pen color
* set shade: sets the pen shade
* set gray: sets the gray-level of the pen (Only available in Turtle Blocks)
* color: current pen color (can be used in place of a number block)
* shade: current pen shade (can be used in place of a number block)
* gray: current pen gray level (can be used in place of a number block) (Only available in Turtle Blocks)
* start fill: starts a filled polygon (straight sides, not arcs)
* end fill: ends a fill polygon (straight sides, not arcs)

====Color Palette====
[[Image:TAcolors.png|800px]]

These blocks can be used with the set-pen-color block in place of a number block.

====Numbers Palette====
[[Image:TAnumbers.png|800px]]

These blocks are arithmetic and boolean operators.

* addition: adds two numeric inputs (also can be used to concatenate strings)
* subtraction: subtracts the bottom numeric input from the top input
* multiplication: multiplies two numeric inputs
* division: divided top input (numerator) by bottom input (denominator)
* identity: identity function (used for spacing blocks)
* modulo (remainder): calculates remainder when dividing top input by the bottom input
* square root (Only available with Turtle Blocks)
* random number: generates a random integer between the minimum and maximum values
* number block: a numeric input
* greater than: boolean greater than operator (used with flow blocks)
* less than: boolean less than operator (used with flow blocks)
* equal to: boolean equal to operator (used with flow blocks)
* not: boolean not (Only available with Turtle Blocks)
* and: boolean and (Only available with Turtle Blocks)
* or: boolean or (Only available with Turtle Blocks)

====Flow Palette====
[[Image:TAflow.png|800px]]

These blocks control program flow.

* wait: pause program execution (unit is seconds)
* forever: continuously repeat execute stack under the right flow
* repeat: repeat the execution of stack under the right flow a specified number of times
* if/then: conditional execution of the stack under the right flow (uses boolean operators found on the Number palette)
* if/then/else: conditional execution of the stack under the center and right flows (uses boolean operators found on the Number palette)
* vertical spacer
* stop stack: interrupt execution
* while: execute stack under right flow ''while'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)
* until: execute stack under right flow ''until'' the condition is true (uses boolean operators found on the Number palette) (Only available with Turtle Blocks)

'''Note:''' Nesting ''while'' and/or ''until'' blocks is not always reliable. If you encounter an error, try putting the nested block in a separate stack, accessed with an action block.

====Blocks Palette====
[[Image:TAblocks.png|800px]]

These blocks are for defining variables and subroutines. Without actions

* start: connects action to toolbar 'Run' button
* store in: store a number, string, or media object in a named box
* action: top of named action stack
* action: execute named action stack

'''Note:''' When a named action or named box block are used, new blocks appear on the palette that correspond to these names; e.g., if a top of action stack is rename, "to square", an action block, "to square" is added to the palette.

[[Image:TAblocks_yes.png|800px]]

Palette with additional actions and boxes created by the user.

====Sensors Palette====
[[Image:TAsensors.png|800px]]

* query keyboard: check for keyboard input (results are stored in the keyboard block)
* keyboard: current value of keyboard input (can be used in place of a number block)
* read pixel: push the RGB value of the pixel under the turtle onto the FILO (blue is first, red is last)
* turtle sees: the "palette color" of the pixel under the turtle
* time: number of seconds since program began
* sound: raw data from microphone ranging -32000 to 32000
* volume (loudness): ranging 0 to 32000
* pitch: the resolution is +-8Hz
* brightness: average luminance seen through camera
* button down: current state of the mouse button (1 == down; 0 == ip)
* mouse x: x position of mouse
* mouse y: y position of mouse

The OLPC XO can measure external inputs with its microphone jack:
* resistance: measurement range is 750 to 14k ohms, (OLPC XO1) and 2k ohms to open circuit (OLPC XO1.5)
* voltage: measurement range is DC 0.4V to 1.85V. (OLPC XO1) and 0.17V to 3.0V (OLPC XO1.5)

The OLPC XO 1.75 also includes an accelerometer.
* accelerate (not shown): measure the acceleration of the computer. Results are pushed to the stack and can be retrieved by using 3 'pop' blocks (one for X (horizontal), one for Y (vertical), and one for Z (forward/backward))

See [[Activities/Turtle Art/Using Turtle Art Sensors]] for more details about the sensor blocks.

([[Activities/Turtle Art/Uso de Tortuga Arte Sensores]] español)

====Media Palette====
[[Image:TAmedia.png|800px]]

These are a collection of blocks used for displaying media objects, such as images from the Journal.

* journal: Sugar Journal media object (used with show block) (also available in Turtle Art)
* audio: Sugar Journal media object (used with show block)
* video: Sugar Journal media object (used with show block)
* description: Sugar Journal description field (used with show block)
* text: text string (used with show block; also used with box and action blocks)
* show: draw text or display media object from the Journal
* set scale: sets the scale of images displayed with show block
* save picture: save the canvas to the Sugar Journal as a .png image (note: saves the canvas as displayed)
* save SVG: save turtle graphics to the Sugar Journal as a .svg image (note: only saves the changes to the canvas in the current execution run)
* scale: sets scale for show block (100% is full-screen)
* media wait: used to pause program while audio or video file plays
* media stop: stop current sound or video
* media pause: pause current sound or video
* media resume: resume playing paused media
* speak: sends text to the voice synthesizer
* sine wave: plays a sine wave of a given frequency, amplitude, and duration

====Extras Palette====
[[Image:TAextras.png|800px]]

These are a collection of extra blocks for accessing advanced features only available in Turtle Blocks.

* push: push value onto FILO (first-in last-out) heap
* show heap: show FILO in status block
* empty heap: empty the FILO
* pop: pop value off of the FILO (can be used in place of a number block)
* print: print value in status block (also available in Turtle Art)
* comment: program comment (displayed in "walk" mode)
* chr: Python chr primitive: converts ASCII to character (useful for converting keyboard input to text)
* int: Python int primitive: converts input to integers
* Python: a [[Activities/Turtle Art-0.88#Python_function_block|programmable block]] (can be used in place of a number block)
:: add your own math equation in the block, e.g., sin(x); This block is expandable to support up to three variables, e.g. f(x,y,z)
* Import Python: [[Activities/Turtle Art-0.88#Python_code_block|import Python code]] from the Sugar Journal (a more general-purpose programmable block). This block accepts a single variable x, as an input or up to 3 variables as an array x[0], x[1] and x[2]
* Cartesian: display Cartesian coordinate grid overlay
* polar: display polar coordinate grid overlay
* turtle: specify which turtle is active
* turtle shell: import a image from the Journal to use as the turtle's 'shell', i.e., replace the turtle with a sprite.
* turtle x: Return x coordinates of turtle
* turtle y: Return y coordinates of turtle
* active turtle: the name of active turtle
* turtle heading: Return heading of turtle
* URL: gets a text string or image from a URL

====Portfolio Palette====
[[Image:TAportfolio.png|800px]]

These blocks are used to make multimedia presentations only available in Turtle Blocks.

* hide blocks: hides all blocks and palettes (useful for decluttering the screen during presentations) (also available in Turtle Art)
* show blocks: shows blocks and palettes (useful for resuming programming after a presentation)
* full screen: goes into full-screen mode (hides Sugar toolbars)
* list slide: used for bulleted lists; This block is expandable, allowing you to add as many bullets as you need
* picture slides: used for picture slides (1×1, 2×2, 1×2, and 2×1)
Only available in Turtle Blocks:
* left: holds current x-coordinate value of the left edge of the screen (can be used in place of a number block)
* top: holds current y-coordinate value of the top edge of the screen (can be used in place of a number block)
* right: holds current x-coordinate value of the right edge of the screen (can be used in place of a number block)
* bottom: holds current y-coordinate value of the bottom edge of the screen (can be used in place of a number block)
* width: screen width (can be used in place of a number block)
* height: screen height (can be used in place of a number block)
::Note: The slide blocks expand into stacks that can be edited for customized presentations.

====User custom-stack palette====
[[Image:TAStack.png|800px]]

The custom palette holds any blocks that have been saved with "Save Stack" option in Edit Toolbar. It lets you reuse stacks between projects.
Blocks on this palette will expand into action stacks.

;Note: This palette first appears after using the "Save stack" option on the Edit Toolbar.

====Trash Palette====
[[Image:TAtrash.png|800px]]

This palette holds any blocks that have been put in the trash. You can drag blocks out of the trash to restore them. The trash palette is emptied when you quit Turtle Art.

====Vertical palettes====
[[Image:TAvertical.png|300px]]

An example of a vertical palette. Vertical palettes are used by default on the OLPC XO laptops running older versions of Sugar.

====Palettes en español====

<gallery>
File:TAturtle-es.png
File:TApen-es.png
File:TAcolors-es.png
File:TAnumbers-es.png
File:TAflow-es.png
File:TAboxes-es.png
File:TAmedia-es.png
File:TAsensors-es.png
File:TAextras-es.png
File:TAstack-es.png
File:TAportfolio-es.png
File:TAtrash-es.png
</gallery>

Features/Notification System

2014-04-05T21:26:53Z

Tonyforster: /* How To Test */

== Summary ==
This adds a simple messages notification system for sugar that can be used by the system, journal and activities notifications.

== Owner ==
* Name: [[User:SAMdroid|SAMdroid]]
* Email: sam.parkinson3@gmail.com

* Name: [[User:tch|tch]]
* Email: tch@sugarlabs.org

== Current status ==
* Targeted release: 0.102
* Last updated: 8th of Feb
* Percentage of completion: 90%

== Detailed Description ==
[[File:Notifications-001.png | thumb | center | 640px |

When a notification is received it displays a pulsing icon, that is specified as part of

the notification, at the top left corner of the screen. This icon stays in there for just

a few seconds.]]

[[File:Notifications-002.png | thumb | center | 640px |

The received notification can be found at the activities tray. It is represented by a button with a

notification badge.]]

[[File:Notifications-003.png | thumb | center | 640px |

The button's palette displays, at the bottom of the palette, all the notifications that are related to the same entity.

Entities can be basically anything, ie., the journal, activities or even scripts running in background.]]

[[File:Notifications-004.png | thumb | center | 640px |

Every notification must belong to an entity. If one notification is sent, that notification

should create a new icon if and only if there is not a previous icon for the same entity.]]

[[File:Notifications-005.png | thumb | center | 640px |

If one entity receives more than 5 notifications, scrolling will be used to limit the space.]]

[[File:Notifications-006.png | thumb | center | 640px |

The notification summary and body are limited in width, only 70 characters will be displayed.]]

== Benefit to Sugar ==
This would be nice for chat, calenders, and any other kind of even that the user should be aware
of. It would help bring us into line with the other desktop environs.

== Scope ==
The current implementation covers most the building blocks that are required for journal, activities
and system message notifications. At the moment, only system messages are implemented, using these
same building blocks.

==UI Design==
[[Design Team/Proposals/Notifications]]

== How To Test ==
For system notifications you can run this script, ie., from Terminal activity:

import dbus
BUS_NAME = 'org.freedesktop.Notifications'
OBJ_PATH = '/org/freedesktop/Notifications'
IFACE_NAME = 'org.freedesktop.Notifications'
bus = dbus.SessionBus()
notify_obj = bus.get_object(BUS_NAME,OBJ_PATH)
notifications = dbus.Interface(notify_obj,IFACE_NAME)
notifications.Notify("Software Update", 0, "", "New activities are available!", "Please check your activities list", [], {'x-sugar-icon-name': 'module-updater'}, -1)

From activities you can use this simplified method, (Gtk3 is required):

self.notify_user('This is the summary','This is a much longer body... describing something...')

== User Experience ==
These messages notifications should not distract the user, as they are displayed in each notification area.

== Contingency Plan ==
WORK HARDER

== Comments and Discussion ==

http://lists.sugarlabs.org/archive/sugar-devel/2014-February/047096.html

Features/Notification System

2014-04-05T05:49:57Z

Tonyforster: /* How To Test */ changed to double quotes was giving italic

== Summary ==
This adds a simple messages notification system for sugar that can be used by the system, journal and activities notifications.

== Owner ==
* Name: [[User:SAMdroid|SAMdroid]]
* Email: sam.parkinson3@gmail.com

* Name: [[User:tch|tch]]
* Email: tch@sugarlabs.org

== Current status ==
* Targeted release: 0.102
* Last updated: 8th of Feb
* Percentage of completion: 90%

== Detailed Description ==
[[File:Notifications-001.png | thumb | center | 640px |

When a notification is received it displays a pulsing icon, that is specified as part of

the notification, at the top left corner of the screen. This icon stays in there for just

a few seconds.]]

[[File:Notifications-002.png | thumb | center | 640px |

The received notification can be found at the activities tray. It is represented by a button with a

notification badge.]]

[[File:Notifications-003.png | thumb | center | 640px |

The button's palette displays, at the bottom of the palette, all the notifications that are related to the same entity.

Entities can be basically anything, ie., the journal, activities or even scripts running in background.]]

[[File:Notifications-004.png | thumb | center | 640px |

Every notification must belong to an entity. If one notification is sent, that notification

should create a new icon if and only if there is not a previous icon for the same entity.]]

[[File:Notifications-005.png | thumb | center | 640px |

If one entity receives more than 5 notifications, scrolling will be used to limit the space.]]

[[File:Notifications-006.png | thumb | center | 640px |

The notification summary and body are limited in width, only 70 characters will be displayed.]]

== Benefit to Sugar ==
This would be nice for chat, calenders, and any other kind of even that the user should be aware
of. It would help bring us into line with the other desktop environs.

== Scope ==
The current implementation covers most the building blocks that are required for journal, activities
and system message notifications. At the moment, only system messages are implemented, using these
same building blocks.

==UI Design==
[[Design Team/Proposals/Notifications]]

== How To Test ==
For system notifications you can run this script, ie., from Terminal activity:

import dbus
BUS_NAME = 'org.freedesktop.Notifications'
OBJ_PATH = '/org/freedesktop/Notifications'
IFACE_NAME = 'org.freedesktop.Notifications'
bus = dbus.SessionBus()
notify_obj = bus.get_object(BUS_NAME,OBJ_PATH)
notifications = dbus.Interface(notify_obj,IFACE_NAME)
notifications.Notify("Software Update", 0, "", "New activities are available!", "Please check your activities list", [], {'x-sugar-icon-name': 'module-updater'}, -1)

== User Experience ==
These messages notifications should not distract the user, as they are displayed in each notification area.

== Contingency Plan ==
WORK HARDER

== Comments and Discussion ==

http://lists.sugarlabs.org/archive/sugar-devel/2014-February/047096.html

0.102/Testing

2014-04-05T04:13:04Z

Tonyforster: /* What Should I test */

<noinclude>[[Category:Testing]]
</noinclude>
= Testing Sugar 0.102 =

This page contains information and resources for testing this up-coming Sugar release.

== What Should I test ==

Even though some general testing is required to detect regressions, it is important to give special attention to the new features. Some of these features are:

* Gender and Age in About Me control panel section.
* Limited number of activities and instance of activities that can be opened at once.
* Displaying icons on the Update control panel section.
* Rework of Network control panel section.
* Labels for Web Services control panel section.
* Layout of Languages selection method in control panel section.
* Filters toolbar in the Journal.
* Notification system to display messages from system and activities. [[Features/Notification System]]
* Sound adjustment options in the frame, to adjust microphone.
* Identify external volumes (eg USB drives) by colors.

== Testing with a XO ==

We have created images with the latest Sugar pre-0.102 sources. These builds are based on [https://www.laptop.org.au/ OLPC Australia] images so please note that there are some customized changes too.

* XO-4 [http://harvest.one-education.org/public/3400x/34001xx4.zd 34001xx4.zd] ([http://harvest.one-education.org/public/3400x/34001xx4.zd.md5 md5])

* XO-1.75 [http://harvest.one-education.org/public/3400x/34001xx2.zd 34001xx2.zd] ([http://harvest.one-education.org/public/3400x/34001xx2.zd.md5 md5])

* XO-1.5 [http://harvest.one-education.org/public/3400x/34001xx1.zd 34001xx1.zd] ([http://harvest.one-education.org/public/3400x/34001xx1.zd.md5 md5])

* XO-1 [http://harvest.one-education.org/public/3400x/34001xx0.img 34001xx0.img] ([http://harvest.one-education.org/public/3400x/34001xx0.img.md5 md5])

These images are NOT signed by OLPC, therefore you need an unsecured XO for installing these images. To save some time, you can use [https://github.com/jmcmullen/olpc-teacher-update this tool].

Please consider that these images contains very early work, as we just entered the bug fixing period.

== Known Issues ==

* The font size is too big (unresolved).
* Sound adjustment in the frame is laggy and displays collaboration related errors (unresolved).

0.102/Testing

2014-04-05T02:56:43Z

Tonyforster: /* What Should I test */

<noinclude>[[Category:Testing]]
</noinclude>
= Testing Sugar 0.102 =

This page contains information and resources for testing this up-coming Sugar release.

== What Should I test ==

Even though some general testing is required to detect regressions, it is important to give special attention to the new features. Some of these features are:

* Gender and Age in About Me control panel section.
* Limited number of activities and instance of activities that can be opened at once.
* Displaying icons on the Update control panel section.
* Rework of Network control panel section.
* Labels for Web Services control panel section.
* Layout of Languages selection method in control panel section.
* Filters toolbar in the Journal.
* Notification system to display messages from system and activities.
* Sound adjustment options in the frame, to adjust microphone.
* Identify external volumes (eg USB drives) by colors.

== Testing with a XO ==

We have created images with the latest Sugar pre-0.102 sources. These builds are based on [https://www.laptop.org.au/ OLPC Australia] images so please note that there are some customized changes too.

* XO-4 [http://harvest.one-education.org/public/3400x/34001xx4.zd 34001xx4.zd] ([http://harvest.one-education.org/public/3400x/34001xx4.zd.md5 md5])

* XO-1.75 [http://harvest.one-education.org/public/3400x/34001xx2.zd 34001xx2.zd] ([http://harvest.one-education.org/public/3400x/34001xx2.zd.md5 md5])

* XO-1.5 [http://harvest.one-education.org/public/3400x/34001xx1.zd 34001xx1.zd] ([http://harvest.one-education.org/public/3400x/34001xx1.zd.md5 md5])

* XO-1 [http://harvest.one-education.org/public/3400x/34001xx0.img 34001xx0.img] ([http://harvest.one-education.org/public/3400x/34001xx0.img.md5 md5])

These images are NOT signed by OLPC, therefore you need an unsecured XO for installing these images. To save some time, you can use [https://github.com/jmcmullen/olpc-teacher-update this tool].

Please consider that these images contains very early work, as we just entered the bug fixing period.

== Known Issues ==

* The font size is too big (unresolved).
* Sound adjustment in the frame is laggy and displays collaboration related errors (unresolved).

Activities/Develop

2014-04-04T06:09:53Z

Tonyforster:

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 ''' Develop requires Sugar 0.96 or higher to run.

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample "Hello World!" Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions:

'''Home'''
* The title of the project
* Edit the Journal description
* Sharing (disabled)
* Create a bundle, use the bundle to install your Activity on other laptops

'''View'''
* Switch to dark or light theme
* Zoom in
* Zoom out

'''Edit'''
* Undo
* Redo
* Copy
* Paste

'''Search'''
* Search box
* Search previous
* Search next

'''Show source'''
* The left hand pane shows the files and directories that comprise your Activity.

'''Show file symbols'''
* The left hand pane shows the classes, functions and variables in the file on the right.

'''Show log files'''
* The left pane shows the log files which contain error messages from running your Activity.

'''Create an empty file'''
* Your Activity already comprises a number of files, this adds an additional empty file in the current directory.

'''Remove file'''
* Deletes the most recently viewed file, the one displayed in the right pane.

'''Run activity'''
* Runs your activity.

'''Stop'''
* Quits the Develop Activity.

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py. It contains the text "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it, the triangle points down and you can see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors among other data and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==

Demo of Develop version 40: https://www.youtube.com/watch?v=SChweH6snvw

==Pending tasks==
* If you want help making better Develop, these are our pending issues: [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Develop&groupdesc=1&group=milestone&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=time&col=changetime&col=status_field&col=reporter&order=priority Trac Tickets]

Activities/Develop

2014-03-29T06:56:20Z

Tonyforster: /* Using the Log files to find errors */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample "Hello World!" Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* the left pane shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py. It contains the text "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it, the triangle points down and you can see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors among other data and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-29T06:54:37Z

Tonyforster: /* Changing the icon */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample "Hello World!" Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* the left pane shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py. It contains the text "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it, the triangle points down and you can see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-29T06:52:47Z

Tonyforster: /* Editing your Activity */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample "Hello World!" Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* the left pane shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py. It contains the text "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-29T06:51:09Z

Tonyforster: /* About Develop */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample "Hello World!" Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* the left pane shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-29T06:48:42Z

Tonyforster: /* About Develop */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample "Hello World!" Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-29T06:37:03Z

Tonyforster: /* About Develop */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

There are 4 "Hello World!" templates to choose from:
* Gtk2
* Gtk3 (requires Sugar 0.96 or above to run the Activity you create)
* Sugargame
* Web (requires Sugar 0.100 or above to run the activity you create)

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T09:59:51Z

Tonyforster: /* Sugargame */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change the line that starts with pantalla.blit to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T09:57:18Z

Tonyforster: /* Sugargame */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
NEGRO = (0, 0, 0) #this sets the R G B of the black background
fuente = pygame.font.SysFont(None, 48) #48 is the text size
texto = fuente.render('Hello world!', True, BLANCO, NEGRO) # change Hello world
pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change line 44 to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T09:49:58Z

Tonyforster: /* Sugargame */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
10 NEGRO = (0, 0, 0) #this sets the R G B of the black background
24 fuente = pygame.font.SysFont(None, 48) #48 is the text size
44 pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change line 44 to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T09:38:33Z

Tonyforster: /* Going further */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
* 9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
*10 NEGRO = (0, 0, 0) #this sets the R G B of the black background
*24 fuente = pygame.font.SysFont(None, 48) #48 is the text size
*44 pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change line 44 to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame http://www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T09:35:57Z

Tonyforster: /* Going further */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
* 9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
*10 NEGRO = (0, 0, 0) #this sets the R G B of the black background
*24 fuente = pygame.font.SysFont(None, 48) #48 is the text size
*44 pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change line 44 to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

Pygame www.pygame.org/docs

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T09:32:22Z

Tonyforster: /* Sugargame */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
* 9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
*10 NEGRO = (0, 0, 0) #this sets the R G B of the black background
*24 fuente = pygame.font.SysFont(None, 48) #48 is the text size
*44 pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change line 44 to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse. Or change this line to:

pygame.draw.circle(pantalla,BLANCO, pygame.mouse.get_pos(),20,0)

and a circle follows the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T08:16:09Z

Tonyforster: /* Sugargame */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
* 9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
*10 NEGRO = (0, 0, 0) #this sets the R G B of the black background
*24 fuente = pygame.font.SysFont(None, 48) #48 is the text size
*44 pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try. For example, change line 44 to:

pantalla.blit(texto, pygame.mouse.get_pos())

the text will follow the mouse.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T06:41:58Z

Tonyforster: /* Sugargame */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make:
* 9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text
*10 NEGRO = (0, 0, 0) #this sets the R G B of the black background
*24 fuente = pygame.font.SysFont(None, 48) #48 is the text size
*44 pantalla.blit(texto, ((x / 2) - (x / 10), (y / 2) - (y / 10))) #the location on the screen

Read the documentation at pygame.org, there are lots of exciting things to try.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T06:26:21Z

Tonyforster: /* Going further */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Sugargame===
Sugargame, based on Pygame makes it easy to create games. See pygame.org

To create a game, start a new Develop project but select Sugargame rather than Gtk2.
If you run the Activity created, it prints Hello World on a black background.

Look at the file game.py, there are a number of simple changes you can make
* 9 BLANCO =(255, 255, 255) #this sets the red, green and blue values for the white text

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-28T06:12:29Z

Tonyforster: /* Tutorial - creating your Activity */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity, this is safer than editing an existing Activity. You are offered 4 Activity templates, Gtk2, Gtk3, Sugargame and Web, some of these templates are not compatible with all Sugar versions, Gtk2 should be compatible.

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-27T11:19:16Z

Tonyforster: /* Editing your Activity */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

[[File:Develop-helloworld.jpg]]

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

File:Develop-helloworld.jpg

2014-03-27T11:18:17Z

Tonyforster:

Activities/Develop

2014-03-27T11:08:54Z

Tonyforster: /* Tutorial - creating your Activity */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

===Editing your Activity===
Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-27T08:26:43Z

Tonyforster: /* Using the Log files to find errors */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-27T08:26:11Z

Tonyforster: /* Using the Log files to find errors */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems. The Log Activity is a viewer for these files.

Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Log

2014-03-27T08:24:14Z

Tonyforster:

http://wiki.laptop.org/images/thumb/b/b5/Activity-log.svg/55px-Activity-log.svg.png

Log files are created when Activities run, they also are created by other processes. They list software errors, among other data, and can help diagnose software problems. The Log Activity is a viewer for these files.

* [http://activities.sugarlabs.org/en-US/sugar/addon/4056 Activity Library]
* [https://git.sugarlabs.org/log Source]
* [http://download.sugarlabs.org/activities/4056/ Versions]
* for a guide to using Log to find errors see [[Activities/Develop#Using_the_Log_files_to_find_errors]]
Bug tickets: [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&component=Log&groupdesc=1&group=resolution&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=time&col=changetime&col=status_field&col=reporter&order=priority Sugar Labs], [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=resolution&max=150&component=log-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=reporter&col=time&col=changetime OLPC]

Activities/Develop

2014-03-27T08:13:45Z

Tonyforster: /* Using the Log files to find errors */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , in the string "Hello World!, it got confused at the opening quote. It got to the end of line (EOL) while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Log

2014-03-27T08:12:24Z

Tonyforster:

http://wiki.laptop.org/images/thumb/b/b5/Activity-log.svg/55px-Activity-log.svg.png

* [http://activities.sugarlabs.org/en-US/sugar/addon/4056 Activity Library]
* [https://git.sugarlabs.org/log Source]
* [http://download.sugarlabs.org/activities/4056/ Versions]
* for a guide to using Log to find errors see [[Activities/Develop#Using_the_Log_files_to_find_errors]]
Bug tickets: [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&component=Log&groupdesc=1&group=resolution&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=time&col=changetime&col=status_field&col=reporter&order=priority Sugar Labs], [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=resolution&max=150&component=log-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=reporter&col=time&col=changetime OLPC]

Activities/Develop

2014-03-27T08:08:42Z

Tonyforster: /* Using the Log files to find errors */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , In the string "Hello World!, it got confused at the opening quote. It got to the end of line EOL while scanning the string.

[[File:Develop-logfiles.jpg]]

The Log Activity [[Activities/Log]] can also be used to view log files.

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]

Activities/Develop

2014-03-27T07:47:31Z

Tonyforster: /* Using the Log files to find errors */

<noinclude>
[[Category:Activities|Develop]]</noinclude>
'''Download from http://activities.sugarlabs.org/en-US/sugar/addon/4058 '''

==About Develop==
Develop allows you to edit existing Activities or create new ones. It allows the viewing and editing of multiple files and gives easy access to error logs. It includes templates for a number of sample Hello World Activities.

You get the screen below the first time you start Develop and every time you Start New but not if you resume a project. It gives the option of editing an existing Activity or creating a new one from a "Hello World!" template. It is recommended that beginners create a new Activity.

[[File:Develop open screen.jpeg]]

The main screen is shown below. In this case, a new Activity called testgtk2 has been created from the gtk2 template. The left pane shows the files and directories that comprise the Activity and the right pane shows the contents of its main file, activity.py

[[File:Screenshot of Develop testgtk2 .png | 600px]]

From left to right, the toolbar buttons have the following functions

'''Home'''
* the title of the project
* edit the Journal description
* sharing (disabled)
* create a bundle, use the bundle to install your Activity on other laptops

'''Edit'''
* copy
* paste

'''Search'''

'''Show source'''
* the left hand pane shows the files and directories that comprise your Activity

'''Show file symbols'''
* the left hand pane shows the classes, functions and variables in the file on the right

'''Show log files'''
* shows the log files which contain error messages from running your Activity

'''Create an empty file'''
* your Activity already comprises a number of files, this adds an additional empty file

'''Remove file'''
* deletes the most recently viewed file, the one displayed in the right pane

'''Run activity'''
* runs your activity

'''Stop'''
* quits the Develop Activity

==Tutorial - creating your Activity==
Open Develop, start new

[[File:Develop-start-new.jpeg]]

Create a new Activity

Select the type Gtk2

Name the Activity testgtk2

Start

Press the Run activity button on the toolbar, your testgtk2 Activity will run, it prints Hello World!. (If you look at your Home screen you have a new Activity called testgtk2.)

Stop testgtk2 and return to Develop. Edit line 70 of activity.py, "Hello World!", change this text but be careful only to change the text within the quotation marks. Press the Run activity button, the Activity now displays the new text.

===Changing the icon===
Shown in the left hand pane is the directory activity with a triangle next to it pointing right. Click on it to see its contents, open activity-helloworld.svg

[[File:Develop-left-pane.jpg]]

Line 11 defines the circle of the world in the icon. Change stroke-width to "6.5". You need to restart the laptop to see the changes, the circle is now thicker. [[File:Altered-icon.jpg|50px]]

===Changing the version number===
The Home view, List view shows the version number of all the installed Activities. The version number discriminates between older and newer versions of an Activity. It is used to tell if you are using the latest version. Sometimes the latest version has a bug and you want to go back to an earlier known good version.

Look in your Home view List view and you will see that testgtk2 is version 1. To alter the version number, edit activity.info line 6 which shows the activity_version=1 , change it to 2.

You may need to restart the laptop to see the changes.

[[File:Version-number.jpg]]

===Installing your Activity on another computer===
Press the Create bundle button on the home toolbar[[File:Save-bundle.jpg]], this creates a .xo bundle in the Journal. Copy this to another laptop to install your Activity.

===Using the Log files to find errors===
Assume you made a typing error, you accidentally deleted the closing quote mark " in activity.py line 70 when you were editing "Hello World!". The activity would not run, you might get an error like this:[[File:Failedtostart.jpg]]

Click on the Show log files button [[File:Show-logfiles.jpg]] , the left hand pane will show the list of logfiles. Because our Activity is named testgtk2, we are looking for the file org.sugarlabs.testgtk2. If you have started testgtk2 multiple times then there are multiple logfiles. Click on org.sugarlabs.testgtk to read the logfile. The error message tells that it is line 70 of activity.py , In the string "Hello World!, it got confused at the opening quote. It got to the end of line EOL while scanning the string.

[[File:Develop-logfiles.jpg]]

===Going further===
For more on making Sugar Activities see the ebook http://en.flossmanuals.net/make-your-own-sugar-activities/

For editing icons use Inkscape http://www.inkscape.org

==Videos==
This video shows a very early version of Develop:

I don't know much about this activity but here's my over the shoulder view of the activity: http://www.youtube.com/watch?v=dmXDw-Z2CSI --[[User:Dennis Daniels|Dennis Daniels]] 17:33, 10 September 2009 (UTC)

==Resources==
* Trac Tickets: [http://dev.laptop.org/query?status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&max=150&component=develop-activity&order=id&col=id&col=summary&col=status&col=owner&col=type&col=next_action&col=changetime OLPC] [http://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=closed&status=new&status=reopened&groupdesc=1&group=milestone&component=Develop&order=priority&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=version&col=severity&col=resolution&col=status_field&col=reporter&col=time&col=changetime Sugar Labs]