Home | Download/Install | Documentation | Packages | Screenshots | News | Forum/Mailing-lists | Contact | GForge
target: developers and administrators
The Sphinx documentation of each OpenAlea/VPlants/Alinea packages can be uploaded on the Wiki Sphinx documentation.
Once a package has a stable documentation, administrators, or developers can upload the HTML version on the wiki using the following command
python setup.py build_sphinx python setup.py sphinx_upload
at the package directory level. The directories ./doc/_build/html and ./doc/_build/latex will then be copied on the gforge using the <project> and <package> name that should be found in the file metainfo.ini or setup.cfg
http://openalea.gforge.inria.fr/doc/<project>/<package>/doc/_build/html/index.html.
Your username will be asked. For the time being the protocol to copy the files is SCP so you must have you ssh key on the GFORGE.
An alternative is to use FileZilla by connecting to scm.gforge.inria.fr via SFTP/SSH.
See also for more help sphinx usage in OpenAlea
If the package documentation has never been uploaded, the command to upload the files will surely fail because the directory where to upload the files does not exist.
For instance, let us say you want to upload the sphinx documentation of a package in openalea project that is called brandnew. Then, you will need to create the following directories in
http://openalea.gforge.inria.fr/doc/openalea/brandnew/doc/_build/html/ http://openalea.gforge.inria.fr/doc/openalea/brandnew/doc/_build/latex
Yet, your package will not appear on the main Sphinx page amongst the other packages. To do so, you will need to update the templates in ./openalea/misc/share/_templates/openalea_packages or ./openalea.misc/share/_templates/vplants_packages and so on (for alinea). Then, go to ./openalea/doc/ and type
make html
Finally, in the same directory type
python upload_sphinx --username <your username>