扩展sphinx autodoc,包括自动摘要

autodocsumm的Python项目详细描述


docsDocumentation Status
testsTravisRequirements StatusCoverage
packagePyPI Package latest releaseSupported versionsSupported implementations

欢迎这个sphinx扩展为sphinx提供了一些有用的扩展 autodoc扩展名。那些是

  1. 它以autosummary扩展的样式创建目录 方法、类、函数和属性
  2. 因为您可以通过 autoclass_content配置值, 我们提供autodata_content配置值以包括 来自__call__方法的文档
  3. 可以排除特定对象的字符串表示形式如果你 使用not_document_data配置有一个大字典 价值。

有关详细信息,请参见Documentation on Readthedocs

安装

只需通过pip

安装即可
$ pip install autodocsumm

或者通过以下方式安装:

$ python setup.py install

source on GitHub开始。

要求

该包只需要安装Sphinx。它已经过测试 高于1.3的版本

快速启动

要激活autodocsumm扩展,必须在 conf.py

extensions=['sphinx.ext.autodoc',...,'autodocsumm',]

完成后,可以使用autodoc的:autosummary:选项 在顶部生成表的指令,例如:

..automodule:: my.awesome.module
    :autosummary:

(可选)默认情况下,可以为所有autodoc激活autodocsumm 通过添加conf.py

autodoc_default_options={'autosummary':True,}

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
安卓将java转换为kotlin会中断contextmenu   输出不正确:使用Java实现二进制搜索树   用户界面如何在java程序中生成“页面”   多线程Java:线程调用Runnable   java Wso2 5.8,具有3个身份验证步骤   数组(Java)使用for循环获取所有组合并添加到ArrayList,但ArrayList只有最后一个添加   java二十题编程   MySql Java错误:检查使用“?”附近的正确语法调用PreparedStatement时在第1行   java我的Android Studio应用程序有什么问题一直停止?   java如何使用docx4j将带有Marathi文本的HTML文本写入PDF文档?   %04X在C中的含义以及如何在java中编写   Java中的优化:涉及实例化时定义的常量的表达式在编译时是否得到简化?   桌面应用程序的java推荐技术选择   java视图在整个单击功能完成之前不会更新