Changes

[[Image:XOEditor-icon.svg]]

[[Image:XOEditor-icon.svg]]

==About XOEditor==

== About XOEditor ==

XOEditor is an activity that can be used to create different color combinations for the XO icon at the heart of the Sugar interface.

XOEditor is an Activity that can be used to create different color combinations for the XO icon at the heart of the Sugar interface.

 

 

The XOEditor Activity is available on the [http://activities.sugarlabs.org/en-US/sugar/addon/4085 Sugar Labs Activity portal]. The source code to XOEditor is available on [http://git.sugarlabs.org/xo-colors gitorious].

== Using XOEditor ==

== Using XOEditor ==

[[Image:XOEditor.png]]

[[Image:XOEditor.png]]

You launch XOEditor from the Home View by clicking on the Activity icon. Once the activity has opened, you will see an XO icon in the center of the screen surrounded by colored circles. The circles are color "stroke-fill" combinations. By clicking on a circle, the XO icon takes on those colors. You can save a selected color combination using the Save Button on the Main Toolbar.

You launch XOEditor from the Home View by clicking on the Activity icon. Once the Activity has opened, you will see an XO icon in the center of the screen surrounded by colored circles. The circles are color "stroke-fill" combinations. By clicking on a circle, the XO icon takes on those colors. You can save a selected color combination using the Save Button on the Main Toolbar.

:'''Did you know''' that as of Version 3, XOEditor will save your colors?

:'''Did you know''' that as of Version 3, XOEditor will save your colors?

On the Main Toolbar, from left to right:

On the Main Toolbar, from left to right:

;The Activity Toolbar button: Used to open the Activity toolbar

;The Activity Toolbar button: Used to open the Activity toolbar

;The Save Button: Used to save the currently selected colors as your new activity colors

;The Save Button: Used to save the currently selected colors as your new Activity colors

;The standard Stop Button: Used to exit the Activity

;The standard Stop Button: Used to exit the Activity

[[Image:XOEditor-drag.png|300px]]

[[Image:XOEditor-drag.png|300px]]

The dots can be dragged across the screen to be organized into different arrangements. These arrangements are saved to the Sugar Journal and restored when you resume the activity.

The dots can be dragged across the screen to be organized into different arrangements. These arrangements are saved to the Sugar Journal and restored when you resume the Activity.

 

The XOEditor Activity is available on the [http://activities.sugarlabs.org/en-US/sugar/addon/4085 Sugar Labs Activity portal]. The source code to XOEditor is available on [http://git.sugarlabs.org/xo-colors gitorious].

== Where to report problems ==

== Learning with XOEditor ==

You can report bugs and make feature requests [https://bugs.sugarlabs.org/newticket?component=Portfolio on our bug-tracking system] (You need to create an account first). To list all open tickets of XOEditor you can use [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Xoeditor query component=Xoeditor]. You are also welcome to leave comments/suggestions on the [[Talk:Activities/XoEditor]] page.

 

== A word to educators ==

While XOEditor is primarily intended to be used as a simple utility for changing the colors in the Sugar interface, it can be used to introduce some color concepts, such as [http://en.wikipedia.org/wiki/Monochrome monochrome], [http://en.wikipedia.org/wiki/Complementary_colors complementary colors], and some aspects of [http://interisciplinary-lab.wikispaces.com/file/view/jacobson.pdf color expression].

While XOEditor is primarily intended to be used as a simple utility for changing the colors in the Sugar interface, it can be used to introduce some color concepts, such as [http://en.wikipedia.org/wiki/Monochrome monochrome], [http://en.wikipedia.org/wiki/Complementary_colors complementary colors], and some aspects of [http://interisciplinary-lab.wikispaces.com/file/view/jacobson.pdf color expression].

:Which color combinations do you like? Why?

:Which color combinations do you like? Why?

== A word to developers ==

 

 

 

 

 

=== A word to developers ===

The [http://activities.sugarlabs.org/en-US/sugar/addons/versions/4085#version-2 original version of XOEditor] was written in Javascript and bundled into an instance of Browse. The original [[Activities/XoEditor/XoEditor.xml|XML file]] is in the wiki. As of Version 3, XOEditor has been rebased to Python.

The [http://activities.sugarlabs.org/en-US/sugar/addons/versions/4085#version-2 original version of XOEditor] was written in Javascript and bundled into an instance of Browse. The original [[Activities/XoEditor/XoEditor.xml|XML file]] is in the wiki. As of Version 3, XOEditor has been rebased to Python.

</pre>

</pre>

== Suggestions for modification ==

== Where to report problems ==

 

You can report bugs and make feature requests [https://bugs.sugarlabs.org/newticket?component=Portfolio on our bug-tracking system] (You need to create an account first). To list all open tickets of XOEditor you can use [https://bugs.sugarlabs.org/query?status=accepted&status=assigned&status=new&status=reopened&component=Xoeditor query component=Xoeditor]. You are also welcome to leave comments/suggestions on the [[Talk:Activities/XoEditor]] page.

* The colors used in XOEditor are from [http://git.sugarlabs.org/sugar-toolkit/mainline/blobs/master/src/sugar/graphics/xocolor.py the standand Sugar colors class]. An interesting challenge would be to modify the program to use a different list of color pairs.

 

* The original Javascript version of XOEditor let you look at the color pairs on top of different background colors. It would be a nice feature to add to the Python version.

== Credits ==

== Credits ==

XOEditor was written and is maintained by [[User:Walter]].

XOEditor was written and is maintained by [[User:Walter]].