跳转到主要内容

Sphinx扩展,可自动记录click应用程序

项目描述

Build Status Documentation Status

sphinx-click 是一个 Sphinx 插件,允许您从基于 Click 的应用程序中自动提取文档,并将其包含在您的文档中。

安装

使用 pip 安装插件

$ pip install sphinx-click

或者,通过克隆此存储库然后在本地上运行 pip 来从源安装

$ pip install .

使用方法

在您的Sphinx conf.py 文件中启用插件

extensions = ['sphinx_click']

启用后,您现在可以在文档的任何必要位置使用此插件。

.. click:: module:parser
   :prog: hello-world
   :nested: full

文档 中提供了有关各种选项的详细信息。

代替

此插件非常适合在 Sphinx 中记录基于点击的 CLI,因为它可以正确地以美观的 HTML 格式渲染帮助屏幕及其选项,并包含深链接和样式。

然而,如果您想记录基于点击的 CLI 的源代码及其执行结果,您可能想查看 click-extra。后者提供了 .. click:example::.. click:run:: Sphinx 指令,以便您可以在文档中 捕获和渲染 CLI 的结果,并带有完整的颜色

项目详情


下载文件

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

源代码分发

sphinx_click-6.0.0.tar.gz (29.6 kB 查看散列)

上传时间

构建分发

sphinx_click-6.0.0-py3-none-any.whl (9.9 kB 查看散列)

上传时间 Python 3

由以下机构支持

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