Skip to main content

Sphinx SCM interface

Project description

[Latest PyPI version] [Supported Python versions] [pre-commit: enabled] [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. Currenlty, email addresses are not converted into mailto links.

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-scm-0.1.2.tar.gz (19.9 kB view details)

Uploaded Source

Built Distribution

sphinxcontrib_scm-0.1.2-py3-none-any.whl (18.0 kB view details)

Uploaded Python 3

File details

Details for the file sphinxcontrib-scm-0.1.2.tar.gz.

File metadata

  • Download URL: sphinxcontrib-scm-0.1.2.tar.gz
  • Upload date:
  • Size: 19.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for sphinxcontrib-scm-0.1.2.tar.gz
Algorithm Hash digest
SHA256 df000d6b8b3ba6b97643a8c10c159fcce8ea3f53b7af7fc691a5dca7c442d97e
MD5 43f8cc8d2ffe20be6e8cd060faa18feb
BLAKE2b-256 997f72c795eb3cda2ab7714943ae396caa4139b50297400a966ef4ae7aba417a

See more details on using hashes here.

File details

Details for the file sphinxcontrib_scm-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: sphinxcontrib_scm-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 18.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for sphinxcontrib_scm-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 76bb2e2818ba9b8e4d455728a18796495315d41c38e7b536b389a575297eef04
MD5 848174e5ca67eb62ac76c5fc1d73d0a4
BLAKE2b-256 d245b0e32626e64fe0b0084aec076516ea72f319a65402392d553ad155910a98

See more details on using hashes here.

Supported by

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