Difference between revisions of "User:Humitos/SugarToolkitDocs"

From Sugar Labs
Jump to navigation Jump to search
Line 27: Line 27:
 
* Read the docs: http://read-the-docs.readthedocs.org/en/latest/index.html
 
* Read the docs: http://read-the-docs.readthedocs.org/en/latest/index.html
 
* Mail suggesting this: http://lists.sugarlabs.org/archive/sugar-devel/2012-July/038419.html
 
* Mail suggesting this: http://lists.sugarlabs.org/archive/sugar-devel/2012-July/038419.html
 +
* http://sphinx.pocoo.org/ext/autodoc.html

Revision as of 12:16, 15 July 2012

I started creating the sugar-toolkit-gtk3's documentation using Sphinx. It would be great to do some work on this because I think it's really necessary to have a kind of documentation for this. At the moment there are many errors on the doc generation that should be fixed to get a good polished work.

Commands to get the documentation ready

  • Install Sphinx
sudo yum install python-sphinx
  • Run the command that create some configs
cd /home/humitos/sugar-jhbuild/source/sugar-toolkit-gtk3/src/sugar3
sphinx-apidoc --doc-author="Manuel Kaufmann" --full --doc-version="0.96" --doc-release="0.96" --doc-project="Sugar Toolkit Gtk3"  --output-dir="doc" .
  • Generate the documentation
cd doc/
make html

OnLine Documentation

There is a web page for testing this commands and to know how it will looks and feels

References