sphinx-autoapi/docs/index.rst

59 lines
861 B
ReStructuredText
Raw Normal View History

2015-04-22 22:53:37 +00:00
Sphinx AutoAPI
==============
2015-04-22 22:50:34 +00:00
A tool that generates a full API ref (Javadoc style) for your project.
It requires no RST and is fully automated,
while being integrated into Sphinx.
Contents
--------
.. toctree::
:glob:
config
2015-04-22 23:08:49 +00:00
templates
2015-04-22 22:50:34 +00:00
design
2015-04-22 23:23:57 +00:00
autoapi/index
2015-04-22 22:50:34 +00:00
Install
-------
First you need to install autoapi.
.. code:: bash
pip install sphinx-autoapi
Then add it to your Sphinx project's ``conf.py``:
.. code:: python
extensions = ['autoapi.extension']
autoapi_type = 'python'
autoapi_dir = 'path/to/my/project/files'
autoapi_output = 'path/to/output'
See all available configuration options in :doc:`config`.
Design
------
Read more about the deisgn in our :doc:`design`.
Currently Implemented
---------------------
* Python
* .Net
Future
------
Our goal is to support the following soon:
* Javascript
* PHP
* Python
* Go