This document is for developers that want to add an official openravepy example to the subversion repository. Adding an example0 to the openravepy.examples module requires:
svn add example0.py
openrave.py --example example0
Every example must follow this format when documenting it:
"""One sentence introduction.
.. examplepre-block:: example0
[user-specific text]
.. examplepost-block:: example0
"""
examplepre-block and examplepost-block are special sphinx extensions that add the example images, code, and execution instructions.
All images should be put in the docs/images/examples directory and prefixed with the example name. The image that represents the example has to be in JPEG format and have the same name as the example:
This same image will be used as a thumb image on the examples gallery. It can be replaced with a different image by adding:
Other images part of the example can be:
To reference an image use:
.. image:: ../../images/examples/example0_myimage.png
:width: 640