Activity Team/Sweetener

(Note: This page is not finished.)

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

• User:Daniel_Francis

Current Release

At the moment it hasn't got a stable release. Clone the GIT Repository and feel free to send patches, request merges or contact the maintainers.

Get started creating an activity

• Start a repository on Git
• Clone Sweetener

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

• Copy to your new activity directory the following files:

Makefile
activity.py
canvas.py
info.py
makescripts/
options.py
setup.py

Optional, only if you want to get your activity working on other Linux desktops:

application.py
hello-integration # (rename it to your activity name)

• Make the following directories inside your activity:

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

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

 __init__.py
 basic_options.py
 item.py
 itembox.py
 stock.py

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

 itemgroup.py

• Fill info.py with the information about your activity.

Key accelerators

Gtk Stock sets by default some accelerators for convention, like Ctrl+Q for Quit. Sweetener sets and overwrites some key accelerators for integrate them with Sugar.
Keep this in mind when setting up key accelerators in your activity.

Stock label	Key accelerator on Sugar	Key accelerator on Linux desktops
Add	Ctrl + A	Ctrl + A
Fullscreen	Alt + Return	F11
Normal Size	Ctrl + 0	Ctrl + 0
Remove	Shift + Del	Ctrl + R
Save as	Unused :)	Ctrl + Shift + S
Select Color	Ctrl + L	Ctrl + L
Zoom In	Ctrl + +	Ctrl + +
Zoom Out	Ctrl + -	Ctrl + -

Activities using Sweetener

• Activities/Graph_Plotter

Gtk2 and Gtk3 Support

There are efforts to port Sweetener to Gtk3[1], but at the moment it isn't possible thanks to the upstream bug GNOME#652697.