Skip to main content

Sphinx auto-document generator for SaltStack sls files

Project description

https://travis-ci.com/Tanoti/sphinxcontrib-autosaltsls.svg?branch=master Updates Python 3

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-autosaltsls

Next, 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinxcontrib-autosaltsls-0.2.1.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl (18.8 kB view details)

Uploaded Python 3

File details

Details for the file sphinxcontrib-autosaltsls-0.2.1.tar.gz.

File metadata

  • Download URL: sphinxcontrib-autosaltsls-0.2.1.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for sphinxcontrib-autosaltsls-0.2.1.tar.gz
Algorithm Hash digest
SHA256 4900cef7d70eb840c59788146faf5af40ba4067bf74ffabe5cf8ed1f3999cff7
MD5 d06827405417f30faa58e0e64ee7c70f
BLAKE2b-256 e636a766cc01e8c3497086879518043135f9b9ebfc267168cf2330c993bbc8cf

See more details on using hashes here.

File details

Details for the file sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 18.8 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for sphinxcontrib_autosaltsls-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 adb9fc4e5bf84af768716305455e72015b051a68f3fa93aa615b5997add00123
MD5 55d202a1c7a3d3dad7f539129b57990f
BLAKE2b-256 83856dfb11f752c8cbcebdc034b57dc8493b474ddc22d137fb126501314a3a72

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page