Line 9: |
Line 9: |
| As an activity developer in most cases you need only [[Taxonomy#Glucose:_The_base_Sugar_environment|glucose]] module(its included to ''sugar-glucose'' or ''sugar'' packages). | | As an activity developer in most cases you need only [[Taxonomy#Glucose:_The_base_Sugar_environment|glucose]] module(its included to ''sugar-glucose'' or ''sugar'' packages). |
| | | |
− | Place your activity to ~/Activities/'''activity-name'''.activity directory.
| + | == If you want to create your own activity == |
| | | |
− | To test your activity in sugar environment: | + | What you need to do to create or share your activity. |
− | * use ''sugar'' command to run sugar as a regular window manager | + | |
− | * use ''sugar-emulator'' command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning. | + | ==== Start coding ==== |
| + | |
| + | * '''Create''' an account on [http://git.sugarlabs.org git.sugarlabs.org] and '''log in'''. Add your public SSH key to [http://git.sugarlabs.org/account your account]. |
| + | * '''Create a new project''' (http://git.sugarlabs.org, projects, new). Make your project name lowercase, e.g. pippy, turtleart, paint. Put it in '''category "activities"'''. |
| + | * [[Activity_Team/Git_FAQ#How_do_I_create_a_new_project.3F|Initiate]] your project |
| + | * You can copy/paste [http://git.sugarlabs.org/projects/hello-world Hello World] activity to get an example of usual files hierarchy. |
| + | * Place your activity to ~/Activities/'''activity-name'''.activity directory.<br>To test your activity in sugar environment: |
| + | ** use ''sugar'' command to run sugar as a regular window manager |
| + | ** use ''sugar-emulator'' command to run sugar in window mode(in Xephyr), could be useful to test your activity in current environment without re-loginning. |
| + | * Consult with [[Activity Team/Resources]] to get useful links, [[Development Team/Almanac]] could be a good start page |
| + | * '''Start''' coding :) |
| + | |
| + | ==== Share your activity ==== |
| + | |
| + | If you want to share your activity for broad audience: |
| + | |
| + | * Open a ticket on [https://bugs.sugarlabs.org bugs.sugarlabs.org] to create component for your activity e.g. {{bug|788}} |
| + | * Using ''setup.py'' from activity root directory, create .pot file |
| + | * '''Add''' the ''pootle'' user as a committer (from the "add committer" link on the mainline page) on [http://git.sugarlabs.org git.sugarlabs.org] |
| + | * Open a ticket on [https://bugs.sugarlabs.org bugs.sugarlabs.org] to add your activity to [http://translate.sugarlabs.org/ pootle](sugar translation environment) e.g. {{bug|810}} |
| + | * '''Upload a xo bundle'''(use ''setup.py'' to create bundle) to [http://activities.sugarlabs.org/ activities.sugarlabs.org]. |
| + | ** Be sure to include a couple of screenshots of your activity in action. |
| + | ** [[Activity_Library/Glossary#Public_activity|Nominate]] your activity to the public |
| + | * Create activity page ''wiki.sugarlabs.org/go/Activities/<activity-name>''<br>keep in mind that page on [http://activities.sugarlabs.org/ activities.sugarlabs.org] targeted to users and page on wiki targeted to more experienced users and developers |
| | | |
| ==Join the Activity Team== | | ==Join the Activity Team== |
Line 22: |
Line 45: |
| # Create a User page on wiki.sugarlabs.org if you have not already. | | # Create a User page on wiki.sugarlabs.org if you have not already. |
| # Copy your SSH public key into your User page. | | # Copy your SSH public key into your User page. |
− | # Add a link to your User page to [[ActivityTeam/Contacts]]. | + | # Add a link to your User page to [[Activity Team/Contacts]]. |
− | # Send an email introducing yourself to sugar-devel@lists.sugarlabs.org. | + | # [http://lists.sugarlabs.org/listinfo/sugar-devel Subscribe], and send an email introducing yourself to sugar-devel@lists.sugarlabs.org. |
| | | |
| If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org. | | If you are an independent developer who is interested in working on a Sugar activity, please introduce yourself and your project in an email to sugar-devel@lists.sugarlabs.org. |
| | | |
− | ==Quick Start== | + | ==Help the Activity Team== |
| + | |
| If you'd rather just start coding '''right now''', it's easy to do! | | If you'd rather just start coding '''right now''', it's easy to do! |
| | | |
− | * Check [[ActivityTeam/TODO]] for ideas to work on. To start small, pick an Activity Feature Request. If you'd rather work on something harder, try one of the High Impact Tasks. | + | * Check [[Activity Team/TODO]] for ideas to work on. To start small, pick an Activity Feature Request. If you'd rather work on something harder, try one of the High Impact Tasks. |
− | * If you haven't already set up Sugar, see [[ActivityTeam/Resources]]. | + | * If you haven't already set up Sugar, see [[Activity Team/Resources]]. |
| * Clone the Git repository for the project you picked and register it with Sugar. | | * Clone the Git repository for the project you picked and register it with Sugar. |
| <pre> | | <pre> |