Recent Updates to Sugar Almanac

[Faisal Anwar]

Hello All,

As many of you know, I'm writing up a sugar almanac to help new sugar/python
developers get up and running with creating useful activities. I will try to
send frequent updates in terms of what has been added. In addition to using
the documentation, I'd appreciate it if people familiar with the different
modules I am writing can send any better or alternative code examples to the
ones that I have written. Review and feedback is ALWAYS appreciated.

This week, I have updated the section on how to do many of the basic
activity creation tasks (see
http://wiki.laptop.org/go/Sugar.activity.activity). In addition, I've
provided some basic examples of how to read and write your activity to the
datastore so that it can be resumed later from the journal. Below is a list
of the different how to's contained in this section of the almanac. Hope
some of these ring a bell in terms of what you all are trying to get done!

   - 1 Helper Functions in
sugar.activity.activity<http://wiki.laptop.org/go/Sugar.activity.activity#Helper_Functions_in_sugar.activity.activity>
      - 1.1 How do I get the file path for my activity
bundle?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_get_the_file_path_for_my_activity_bundle.3F>
      - 1.2 How do I get the file path where I can write files
      programmatically?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_get_the_file_path_where_I_can_write_files_programmatically.3F>
      - 1.3 How do I get the name of my
activity?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_get_the_name_of_my_activity.3F>
   - 2 Class: Activity<http://wiki.laptop.org/go/Sugar.activity.activity#Class:_Activity>
      - 2.1 How do I set the canvas (main work area) of my activity to a
      specific UI
widget?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_set_the_canvas_.28main_work_area.29_of_my_activity_to_a_specific_UI_widget.3F>
      - 2.2 What are activity id's? How do I obtain the activity id for an
      instance of my
activity?<http://wiki.laptop.org/go/Sugar.activity.activity#What_are_activity_id.27s.3F_How_do_I_obtain_the_activity_id_for_an_instance_of_my_activity.3F>
      - 2.3 How do I create a new activity that is derived from the base
      Activity class?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_create_a_new_activity_that_is_derived_from_the_base_Activity_class.3F>
      - 2.4 How do I implement a write_file method for my activity in order
      to persist my activity in the
journal?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_implement_a_write_file_method_for_my_activity_in_order_to_persist_my_activity_in_the_journal.3F>
      - 2.5 How do I implement a read_file method for my activity so that I
      can resume activities from the sugar
journal?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_implement_a_read_file_method_for_my_activity_so_that_I_can_resume_activities_from_the_sugar_journal.3F>
   - 3 Class: ActivityToolbox
(Toolbox)<http://wiki.laptop.org/go/Sugar.activity.activity#Class:_ActivityToolbox_.28Toolbox.29>
      - 3.1 What is the standard toolbox needed in most activities and how
      do I create
it?<http://wiki.laptop.org/go/Sugar.activity.activity#What_is_the_standard_toolbox_needed_in_most_activities_and_how_do_I_create_it.3F>
      - 3.2 How do I get a handle on the standard activity toolbar given an
      ActivityToolbox
object?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_get_a_handle_on_the_standard_activity_toolbar_given_an_ActivityToolbox_object.3F>
   - 4 Class: ActivityToolbar
(gtk.Toolbar)<http://wiki.laptop.org/go/Sugar.activity.activity#Class:_ActivityToolbar_.28gtk.Toolbar.29>
   - 5 Class: EditToolbar
(gtk.Toolbar)<http://wiki.laptop.org/go/Sugar.activity.activity#Class:_EditToolbar_.28gtk.Toolbar.29>
      - 5.1 How do I add a standard edit toolbar to my
activity?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_add_a_standard_edit_toolbar_to_my_activity.3F>
      - 5.2 How do I hide a button in the edit toolbar that is not needed in
      my activity?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_hide_a_button_in_the_edit_toolbar_that_is_not_needed_in_my_activity.3F>
      - 5.3 How do I disable and enable a button on the edit
toolbar?<http://wiki.laptop.org/go/Sugar.activity.activity#How_do_I_disable_and_enable_a_button_on_the_edit_toolbar.3F>


You can also find the homepage for the documentation at
http://wiki.laptop.org/go/Sugar-api-doc.


Best,


Faisal
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.laptop.org/pipermail/devel/attachments/20080613/9b5590b0/attachment.html>