跳转到主要内容

Sphinx SCM接口

项目描述

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

此软件包提供了sphinxcontrib.scm,它是Sphinx文档的一个简单版本控制接口。

安装

  1. pip安装scm-sphinx

配置

  1. 'sphinxcontrib.scm'添加到conf.py中的extensions列表。

    extensions = [ 'sphinxcontrib.scm' ]
  2. 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"

用法

指令

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

将SCM贡献者列表填充到sectionauthor指令中。所有选项都是可选的,并覆盖conf.py中的配置设置。

角色

:scm-contribs:`.`

可以作为内联内容使用(例如,作为sectionauthor指令的内容)。目前,电子邮件地址不会被转换为mailto链接。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源分发

sphinxcontrib_scm-0.1.5.tar.gz (21.4 kB 查看哈希值)

上传时间

构建分发

sphinxcontrib_scm-0.1.5-py3-none-any.whl (17.9 kB 查看哈希值)

上传时间 Python 3

由...

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面