Metadata-Version: 2.1
Name: Numkdoc
Version: 0.4.0
Summary: Mkdoc plugin to autodoc your numpy docstring
Home-page: https://github.com/napolar/numkdoc
Author: Thomas FEL
Author-email: thomas.fel@protonmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# NumKdoc

[![pypi](https://github.com/fel-thomas/numkdoc/actions/workflows/pypi.yml/badge.svg)](https://github.com/fel-thomas/numkdoc/actions/workflows/pypi.yml)

NumKdoc is a plugin for Mkdoc allowing you to automatically generate documentation from your Numpy style docstring, by making a simple call to classes.

This project is not maintained, and the parsing is not complete. It is based on the NumpyDoc parser.

## Quick start

If you want to try this plugin as-it-is, follow these steps:

1. Download this repo and (eventually) unzip it in a folder

2. Inside the project folder, execute the command
   `python setup.py develop` to install
   the plugin on your local machine.

3. Go to your mkdocs project folder, edit the `mkdocs.yml` file
   and add these few lines at the end:

   ```yaml
   plugins:
     - numkdoc
   ```

That's it.
Now you can call the parsing of a class using the tag `{{ module.ClassName }}`,
Numkdoc will automatically substitue that tag with the class documentation.

### Example

For example, you could edit the `docs/api/core.md`
file and insert the tag in any place, like this:

```markdown
# Core Api

[...]

{{ src.module.Class }}

[...]
```


