Automatic documentation pages generation
This is a Python package for automatically building the documentation pages to document a given Python package using Sphinx. gendocs allows users to keep all of their documentation directly within their packages as pages are generated directly from the docstrings in the code!
Want to see examples? Check out one of the following projects which use gendocs:
Install gendocs from PyPI:
$ pip install gendocs
Already have a Python package in need of automatic documentation? Follow these steps.
This generator is built for Sphinx (RST) documentation. To document your package, setup sphinx and a conf.py then add the following somewhere near the top of your conf.py:
# Import the package to document: import wonderfulpackage # Automatically generate documentation pages from gendocs import Generator Generator().DocumentPackages(wonderfulpackage)
That’s it! That code block above is all you need to do to document your package(s) thoroughly. Now you can build the Sphinx documentation, and all docs pages will be automatically generated.
Remove the Edit on GitHub Button
Be sure to remove the Edit on GitHub link from your project by following these steps.
Make Your Own Homepage
Note that you can also set up a base index file in your project for the Generator to append if you’d like to include a brief overview of the package. We simply pass the filename of our README to the DocumentPackages method.
Let People Know
If your project generates documentation automatically, please add a badge to your project to let people know! We hope that these badges will stir curiosity, involvement, and community contributions to the gendocs package.
[![Documentation Built by gendocs](https://img.shields.io/badge/docs%20by-gendocs-blue.svg)](https://gendocs.readthedocs.io/en/latest/)
RST / Sphinx:
.. image:: https://img.shields.io/badge/docs%20by-gendocs-blue.svg :target: https://gendocs.readthedocs.io/en/latest/ :alt: Documentation Built by gendocs
Check out gendocs of GitHub to Contribute and make automatic documentation even better!
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size gendocs-0.4.0.tar.gz (8.1 kB)||File type Source||Python version None||Upload date||Hashes View|