Sphinx AutoSaltSLS provides a way to automatically document Salt .sls files (e.g. states, pillar, reactors, etc) using simple directives in the comments blocks of those files.
A comment block is identified using a block start string (default is ‘###’) and contains all subsequent lines that start with a given comment character (default is ‘#’’). The block ends when a new start string or a non-comment line is read. Directives can be given in the comment block to control how the lines are parsed.
Getting Started
The following steps will walk through how to add AutoSaltSLS to an existing Sphinx project. For instructions on how to set up a Sphinx project, see Sphinx’s documentation on Getting Started.
Installation
AutoSaltSLS can be installed through pip:
pip install sphinxcontrib-autosaltslsNext, add and configure AutoSaltSLS in your Sphinx project’s conf.py.
extensions.append('sphinxcontrib-autosaltsls')
autosaltsls_sources = {
'states': {
'title': 'States',
'template_path': '_templates/autosaltsls/states',
},
'pillar' : {
'title': 'Pillar'
},
}The documentation will be built into the location specified by autosaltsls_build_root (defaults to ‘.’)
To configure AutoAPI behaviour further, see the Configuration documentation.
1 maintainer
Release files for sphinxcontrib-autosaltsls 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sphinxcontrib-autosaltsls-0.2.1.tar.gz | 16.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 34.9 kB
Release files / sphinxcontrib-autosaltsls-0.2.1.tar.gz
| Download URL | sphinxcontrib-autosaltsls-0.2.1.tar.gz |
|---|---|
| Size | 16.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4900cef7d70eb840c59788146faf5af40ba4067bf74ffabe5cf8ed1f3999cff7
|
|
BLAKE2b-256 checksum How to use checksums |
e636a766cc01e8c3497086879518043135f9b9ebfc267168cf2330c993bbc8cf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.7.1
|
Release files / sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl
| Download URL | sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl |
|---|---|
| Size | 18.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
adb9fc4e5bf84af768716305455e72015b051a68f3fa93aa615b5997add00123
|
|
BLAKE2b-256 checksum How to use checksums |
83856dfb11f752c8cbcebdc034b57dc8493b474ddc22d137fb126501314a3a72
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.2 CPython/3.7.1
|
