python-sphinx 相关问题

Sphinx是一种工具,可以轻松创建智能和漂亮的文档。 Sphinx特别适用于Python文档,但它是一个通用工具,可用于记录任何内容。

可以更改python autodoc元组/列表格式吗?

我在一个项目中有一些我想要记录的python代码,但是我遇到了一个问题,它记录了作为元组或列表的类常量。请参阅下面的代码和图片。这很难......

回答 1 投票 5

如何使用类名停止Sphinx automethod前缀方法名称

当我使用Sphinx automethod来记录如下的特定方法时:.. automethod :: my_module.MyClass.my_method生成的文档将类名附加到方法名称,如下所示:MyClass ....

回答 2 投票 5

当python包名称与导入名称不同时

问题在于python包的名称与导入期间的用法不同,例如:$ pip list | grep -i“yaml \ | qt”PyYAML 3.13 QtPy 1.5.2 pyyaml(pip instal ...

回答 2 投票 1

'autodoc_default_flags'如何在python Sphinx配置中工作?

我正在尝试使用Sphinx 1.4和sphinx-apidoc以及sphinx.ext.autodoc扩展为我的python类生成文档。我有很多模块,我希望每个模块只显示类名,...

回答 1 投票 7

将sphinx输出中的部分链接到RST源

sphinx文档页面或部分是否有方法或插件可以链接到源 - 而不是指向应用程序源代码的链接,而是实际的sphinx RST文件。例如,链接......

回答 1 投票 0

Sphinx不会记录所有课程

我正在尝试使用Sphinx作为我的文档。令人惊讶的是,它适用于某些类和模块,而有些则不适用。下面你可以找到一个源文件和.rst文件,其中sphinx没有添加...

回答 2 投票 0

如果在同一级别,Doxygen(或其他工具)文档类和命名空间类似

我有一堆命名空间(包含自由函数)和类(显然包含成员函数),每个都在顶层有一个Doxygen注释,并且有一些Doxygen注释...

回答 2 投票 0

如何调整Python Sphinx以便我可以获得精美的网站搜索结果?

我真的很喜欢Python-Sphinx文档工具,但有一件事让我烦恼的是我几乎无法从sphinx搜索框中获得正确的搜索结果:所以我想知道是否有任何技巧让我可以...

回答 2 投票 0

使用阅读文档主题时如何将Sphinx生成的索引添加到边栏?

我想在使用sphinx-rtd-theme时,在侧边栏中有一个自动生成索引的链接。我已经尝试将它添加到toctree:.. toctree ::第一个第二个索引

回答 2 投票 14

修改 Sphinx 主题“阅读文档”的内容宽度

我正在为我的文档使用“阅读文档”Sphinx 主题。在原始主题中,如下所示 阅读文档 Sphinx 主题 内容或主要布局宽度设计为适合移动设备。然而...

回答 6 投票 0

如何使用Sphinx记录单击命令?

click是一个流行的Python库,用于开发CLI应用程序。 sphinx是一个流行的库,用于记录Python包。有些人面临的一个问题是整合这两个......

回答 2 投票 5

如何将源代码添加到使用sphinx生成的LaTeX文档中

我正在使用Sphinx生成我的python库的文档。我使用扩展名sphinx.ext.viewcode extensions = [“sphinx.ext.autodoc”,“sphinx.ext.doctest”,“sphinx.ext.intersphinx”,“...

回答 2 投票 0

斯芬克斯文档 |能支持Algolia的Doc Search吗

我想知道是否有人知道 Algolia 的文档搜索免费服务是否可以集成到 Sphinx 文档网站中。谢谢..

回答 2 投票 0

将我的降价自述文件包含在Sphinx中

我想将我的项目的README.md包含到我的Sphinx文档中,就像在Can sphinx链接到不在根文档下面的目录中的文档一样? - 这是......

回答 2 投票 13

如何在Sphinx中插入图像之前和之后的空间

我使用make latexpdf命令通过Sphinx创建了一个文档。现在我遇到的问题是,LaTeX正在将文字设置在文本之后的顶部,而在图像底部放置3或......

回答 2 投票 3

Readthedocs不显示docstring文档

我已经按照Readthedocs的入门指南进行了操作,并使用autodoc在https://github.com/akdiem/bloodflow上为我的Python包创建了文档。 (文件......

回答 1 投票 0

相对导入需要'package'参数

我想使用Sphinx,因此它可以为我的python代码自动生成一个pydoc但是我收到了一个错误。我做错了什么? conf.py sphinx配置文件从django.conf导入sys import os ...

回答 4 投票 13

为什么sphinx自动模块没有显示任何模块成员?

我开始研究python模块,并希望将代码“就地”记录下来。所以我在sphinx-quickstart的子目录中设置sphinx导致这个目录结构(只有文件我...

回答 1 投票 1

使用不同链接文本隐式链接到标题

我知道你可以使用以下链接链接到同一页面上的标题:链接到标题:`这是一个标题`_这是一个标题================但是可以选择用于链接的文本吗? ...

回答 1 投票 2

reStructuredText / Sphinx中的图像网格

我正在使用Sphinx为我正在开发的Python项目创建文档。我有三个想要在1x3网格中显示的图像(即所有在同一行上),我正在试图弄清楚如何...

回答 4 投票 15

© www.soinside.com 2019 - 2024. All rights reserved.