Skip to content

sphinx-contrib/scm

Repository files navigation

sphinxcontrib-scm

[Latest PyPI version] [Supported Python versions] [pre-commit: enabled] [pre-commit.ci status] [Code style: black] [Code style: prettier]

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). Currently, email addresses are not converted into mailto links.