Python sphinx: Difference between revisions

From wikinotes
 
No edit summary
Line 45: Line 45:
|}
|}
</blockquote><!-- core -->
</blockquote><!-- core -->
= API Docs =
<blockquote>
{|
|-
|
|-
|}
</blockquote><!-- API Docs -->

Revision as of 12:39, 4 July 2022

Sphinx is a python program that is built to assist in the creation of technical documentation.
You can autogenerate API docs for various languages, or define free-form docs.

Documentation

sphinx docs http://www.sphinx-doc.org/en/master/contents.html
sphinx directives https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html
sphinx napoleon docs http://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html

Locations

${PROJECT}/source/conf.py config

Core

sphinx install
sphinx configuration
sphinx static files
sphinx hosting
sphinx usage
sphinx syntax
sphinx extending
sphinx extensions

API Docs