Changes

Sweetener is a desktop framework which provides compatibility between Sugar and other Desktops. Does all the repetitive parts, for be more friendly with developers. It's divided in modules, they can be included in an activity for do a specific task.

Sweetener is a desktop framework which provides compatibility between Sugar and other Desktops. Does all the repetitive parts, for be more friendly with developers. It's divided in modules, they can be included in an activity for do a specific task.

== Maintainers ==

== Maintainers ==

*[[User:Daniel_Francis|Daniel Francis]]

*[[User:Francis|Daniel Francis]]

== Current Release ==

== Current Release ==

At the moment it hasn't got a stable release. Clone the [http://git.sugarlabs.org/sweetener GIT Repository] and feel free to send patches, request merges or contact the maintainers.

At the moment it hasn't got a stable release. Clone the [http://git.sugarlabs.org/sweetener GIT Repository] and feel free to send patches, request merges or contact the maintainers.

== Get started creating an activity==

== Get started creating an activity==

* Start a repository on [http://git.sugarlabs.org/ Git]

* Start a repository on [http://git.sugarlabs.org/ Git]

* Clone Sweetener

* Clone Sweetener

  git clone git://git.sugarlabs.org/sweetener/sweetener.git

  $ git clone git://git.sugarlabs.org/sweetener/sweetener.git

* Copy to your new activity directory the following files:

* Copy to your new activity directory the following files:

  Makefile

  Makefile

  canvas.py

  canvas.py

  info.py

  info.py

  options.py

  options.py

  setup.py

  setup.py

* Make the following directories inside your activity:

* Make the following directories inside your activity:

  activity/

  activity/

  sugar/sweetener/

  sugar/

  desktop/sweetener/  # (Only if you want to run your activity on Linux desktops)

  desktop/  # (Only if you want to run your activity on Linux desktops)

* Copy basic modules:<br>  Sweetener is divided in modules, for a very basic activity, you'll need to copy to (sugar - desktop)/sweetener:

* Clone sweetener submodules

  __init__.py

$ git submodule add git://git.sugarlabs.org/sweetener/makescripts

  basic_options.py

$ git submodule add git://git.sugarlabs.org/sweetener/sugar sugar/sweetener

  item.py

  itembox.py

# This is only for other Linux desktops.

$ git submodule add git://git.sugarlabs.org/sweetener/desktop desktop/sweetener

Optional if your activity has only the main ToolbarBox and the ActivityToolbar, obligatory for run the activty on Linux desktops:

 

* Fill info.py with information about your activity. See [[Activity_Team/Sweetener#Activity_information|info.py fields]].

* Fill info.py with information about your activity. See [[Activity_Team/Sweetener#Activity_information|info.py fields]].

* Create a sugarized icon on activity/activity-(lower-name).svg where lower-name must be the same as the variable on info.py

* Create a sugarized icon on activity/activity-(lower-name).svg where lower-name must be the same as the variable on info.py

* Generate the activity.info file trough the command make.

* Generate the activity.info file trough the command make.

   make activity

   $ make activity

* Install it

* Install it

   python setup.py dev

   $ python setup.py dev

== Activity information ==

== Activity information ==

Sweetener sets and overwrites some key accelerators for integrate them with Sugar.<br>

Sweetener sets and overwrites some key accelerators for integrate them with Sugar.<br>

Keep this in mind when setting up key accelerators in your activity.

Keep this in mind when setting up key accelerators in your activity.

{| class="wikitable"

{| class="wikitable"

|-

|-