.. image:: https://travis-ci.org/SolutionsCloud/apidoc.png?branch=master :target: https://travis-ci.org/SolutionsCloud/apidoc .. image:: https://coveralls.io/repos/SolutionsCloud/apidoc/badge.png :target: https://coveralls.io/r/SolutionsCloud/apidoc .. image:: https://pypip.in/v/ApiDoc/badge.png :target: https://preview-pypi.python.org/project/ApiDoc .. image:: https://pypip.in/d/ApiDoc/badge.png :target: https://preview-pypi.python.org/project/ApiDoc .. image:: https://requires.io/github/SolutionsCloud/apidoc/requirements.png?branch=develop :target: https://requires.io/github/SolutionsCloud/apidoc/requirements/?branch=develop
ApiDoc <http://solutionscloud.github.io/apidoc>
is a documentation generator designed for API built with Python and given by SFR Business Team <http://www.sfrbusinessteam.fr>
.
.. image:: https://raw.github.com/SolutionsCloud/apidoc/master/docs/source/_static/screenshot_sample.png
The fastest way to get started is by using the command line tool
.. code-block:: console
$ sudo apt-get install python3-pip
$ pip3 install apidoc
If the package python3-pip does not exists
.. code-block:: console
$ sudo apt-get install python3-setuptools $ sudo easy_install3 pip $ sudo pip3-2 install apidoc
You can download a sample file and try to render it documentation
.. code-block:: console
$ mkdir apidoc
$ cd apidoc
$ wget https://raw.github.com/SolutionsCloud/apidoc/master/example/demo/source.yml
$ apidoc -i source.yml -o output/index.html
$ firefox output/index.html