Sphinx是一种工具,可以轻松创建智能和漂亮的文档。 Sphinx特别适用于Python文档,但它是一个通用工具,可用于记录任何内容。
我有一个模块,其中包含两个有文档记录的全球特别会员。在本地运行Sphinx会创建包含其文档的文档,但“阅读文档”则不会。它使用内置类型的文档...
我试图弄清楚如何在不使用Dict [str,str]的情况下为传递给函数的字典参数提供类型提示,因为这不提供键的含义。我已经尝试过...
我正在使用scipy主题和狮身人面像以及autodoc + autosummary。构建文档时,在参数说明旁边会出现一个灰色框区域。相反,我希望它看起来......>
我如何在reStructuredText(reST)中编写乘法符号?
我正在编写reST文档,这些文档将使用Sphinx呈现为HTML和PDF。我的源文件是UTF-8,并且希望我的HTML显示为UTF-8。编写...
我有大量的python文件,我想为我的项目生成公共API文档。我用装饰器装饰过的api的所有功能。例如:...
从epydoc移至狮身人面像以自动记录简单的python .py文件
Epydoc即使在应用补丁程序后也无法正常工作,因此我正尝试迁移到Sphinx。我想从一个简单的python文件自动生成文档:test.py安装后,然后...
我知道用于为Google样式构建文档字符串的语法,例如:def function_with_types_in_docstring(param1,param2):“”“示例函数具有文档字符串中记录的类型。...
在Sphinx中,我可以注册一堆应该始终转换为链接的关键字吗?
我的文档字符串引用了我定义的其他python类。每次Sphinx遇到这些类之一时,我希望它为该其他类插入指向文档的链接。是...
使用Sphinx,如何根据输出格式进行替换?基本上,我想使用html:| CLICK | Unicode :: U + 21E8 elif乳胶:| CLICK | raw:...
为文本块应用CSS和角色,而不是在Sphinx中使用内联跨度
前面的问题解释了如何为某些reStructuredText添加颜色范围。回顾一下过程:首先,您扮演角色。 ..角色::红色使用:red:`解释后的示例...
您如何在底部修复Sphinx的警告?我试图在Sphinx中添加Python注释。我的笔记与index.rst位于同一目录级别的单独文件中。我得到以下内容...
Sphinx是一个Python库,用于从一组ReST格式的文本文件中生成漂亮的文档。不是用于全文搜索的工具,我也完全了解doxygen / phpdoc工具。我是...
我正在寻找一种在python sphinx中突出显示文本的方法。我看过有关如何更改单个单词的字体颜色的文档,但是我想更改单个单词的背景颜色...。
这是我第一次使用Sphinx,到目前为止我已经弄清楚了很多,但是有一个特别的警告提示我无法弄清楚它在告诉我什么。根据文档...
我已经编写了一个Python模块,其中包括用C编写的子模块:该模块本身称为foo,C部分为foo._bar。结构如下:src / foo / __ init__.py
我正在使用Java编写的库来开发多个Jython项目。由于autodoc扩展,我想用Sphinx创建一些好的文档。但是,当我尝试创建html时,我...
SPHINX-numref适用于HTML,但不适用于LaTex
我正在从事Sphinx项目的软件文档编制,其中包含很多数字。我使用“ numref”来引用图片。在HTML中可以正常工作。在LaTex中,我得到图。只有...
Sphinx autodoc和OpenCV(cv2)错误(Python 3.7)
[首先,说我对狮身人面像完全陌生。我正在使用opencv的图像处理项目。虽然我已经能够设置狮身人面像(并使用一些简单的模块成功对其进行了测试),但我还是...