========================================
  Canola2 Plugin and Theme development
========================================

This document covers the development of Canola2 Plugins and Themes. It's assumed
that you already have a fully functional installation of Canola2 in your desktop
for development, in case you don't refer to Canola-README.


 === Themes development ===

Canola theme EDC files and images can be found in 'data/themes/<themename>'.
In order to make your customized Canola2 themes just:

1) Open a new terminal session
 
 $ ./run-canola -s

2) Use the 'default' theme as the base for the new theme.

 $ cp -r data/themes/default data/themes/mytheme

3) Overwrite 'default' images with your own images.

 $ cp -r <my-image-folder>/* data/themes/mytheme/images/

4) Change THEME_NAME in default.edc

 $ sed 's/^\(#define THEME_NAME\).*$/\1 "MyTheme"/' default.edc

5) Recompile the theme

 $ cd data/themes/mytheme && edje_cc default.edc mytheme.edj && cd -

6) Copy the '.edj' file to Canola2 THEMES dir

 $ cp data/themes/mytheme/mytheme.edj THEMES


 === Plugins development ===

--> For starters

Gustavo Barbieri, Artur Souza and Eduardo Fleury published plugins tutorials early this
week, anyone willing to start developing plugins should take a look at these.

Gustavo's
http://blog.gustavobarbieri.com.br/2008/03/25/canola-model-plugin-example/

Artur's
http://labs.morpheuz.eng.br/blog/26/03/2008/yet-another-plugin-tutorial/

Fleury's
http://blog.eduardofleury.com/archives/2008/04/24/


--> The next step

For those already familiar with the starter examples, check Canola2's YouTube
plugin source at:

http://openbossa.indt.org.br/canola/developer.html