sphinxcontrib-scm 0.1.0

Sphinx SCM interface

This package provides sphinxcontrib.scm, a simple SCM interface for Sphinx-based documentation.

Installation

1. pip install sphinxcontrib-scm

Configuration

1. Add 'sphinxcontrib.scm' to the extensions list in conf.py.

   extensions = [ 'sphinxcontrib.scm' ]

2. Configure in conf.py

   scm_contribs_email = ["true"|"false"]          # Show email. Default: "true"
   scm_contribs_limit_contributors" = [None|int]  # Limit number of contributors. Use None
                                                  # to deactivate. Default: None
   scm_contribs_min_commits" = int                # Filter by number of commits. Default: 0
   scm_contribs_sort" = ["name"|"num"]            # Sort by name or number of commits.
                                                  # Default: "name"
   scm_contribs_type" = ["author"|"committer"]    # Show info of author or committer.
                                                  # Default: "author"

Usage

Directive

.. scm-sectionauthor::
   :email: [true|false]
   :limit_contributors: [<int>]
   :min_commits: [<int>]
   :sort: [name|num]
   :type: [author|committer]

Populates sectionauthor directive with a list of SCM contributors. All options are optional and override the config settings in conf.py.

Role

:scm-contribs:`.`

Can be used inline (eg as content for the sectionauthor directive. Currenlty, email addresses are not converted into mailto links.