An exercise for new contributors

Exercise

In order to help you practice in the GCompris framework, I propose you to make this little exercise.

Mandatory: GCompris development is done on a GNU/Linux distribution of your choice.

• Install GNU/Linux on your computer if you don't already have it.
• Get the GCompris code from the Git version control system (or see bellow the GitHub option).
  • git clone --depth=1 git://git.gnome.org/gcompris
  • cd gcompris
• Create a branch for your development
  • git checkout -b exercise
• Compile GCompris.
  • sh autogen.sh && make
  • Check that the python bindings have all they need to be compiled: Python plugin = yes at the end of the configure.
• Create a new Python activity using the supplied createit.sh script. For example, use you nick name as the activity name.
  • cd src
  • ./createit.sh exercise
• Compile GCompris again.
  • make
• Run your activity with the runit.sh script (it is just the template for now).
  • ./runit.sh exercise-activity
• Modify the activity to display an image, an ellipse, a rectangle, a line and a text.
  • You can search for code examples in other activities and check the goocanvas API.
• Add an event to a graphical object so that clicking on it does something visual.
• Test your activity by running runit.sh until you are happy with the result.
• Use git to commit your changes locally.
  • git add exercise-activity
  • git commit -a
• Use git to create the patch
  • git format-patch master --stdout > exercise_activity.patch
  • then email me the patch

Optionally, publish your patch on GitHub

• Create an account on github
• Fork GCompris
  • Look at these instructions
• Code your activity
• Commit the code
  • git add exercise-activity
  • git commit -a
• Push it
  • git push