Sphinx是一种工具,可以轻松创建智能和漂亮的文档。 Sphinx特别适用于Python文档,但它是一个通用工具,可用于记录任何内容。
[每次我都必须引用一个方法,而不是引用package.subpackage.module.method,特别是对于经常使用的方法。有没有办法以某种方式“注册” package.subpackage,以便...
我正在使用Sphinx记录我正在编写为网页的软件包。包的每个成员都有一个文档字符串,我使用autosummary自动将其转换为单独的rst文件。我的...
我想知道如何翻译(如在i18n中)术语表中的术语。我使用Sphinx 1.1.3,假设我有:..词汇表::术语定义运行make gettext后,我得到了.po文件...
:func::class的交叉参考目标路径:仅根工作目录的路径
我对为什么我的交叉引用的目标是不能正常工作有些困惑。只有完整的路径似乎起作用。我具有以下项目结构:my_project -my_project -adapters -...
根据numpy / scipy文档指南中的约定,应以以下方式记录函数参数:def foo(x):“”“”该函数不执行任何操作参数---...
我有一些辅助函数,除了第一个参数外,其他函数与核心函数的参数相同。这些参数已在核心功能中完整记录。我应该复制粘贴此内容吗?
Sphinx-autodoc展平字典,列表和元组-使长条几乎不可读。也不总是需要漂亮的打印格式,因为与嵌套的容器相比,某些嵌套的容器最好保持扁平化。...
我使用sphynx从静态.rst文件生成文档(不提取文档字符串)。我的存储库中有两个文件:index.rst .. toctree :: intro和intro.rst将被跳过========= ...
我对Sphinx很陌生,在服务器上记录了我的项目。现在,一位同事看到了我的工作,她想做同样的事情-在同一台服务器上记录她的项目。这些项目是...
我在获取目录(TOC)以显示文档首页的小节时遇到问题。我的首页上有很多部分,我希望这些是...
假设我具有以下index.rst:一些全局主题===================== .. toctree :::glob:嵌套/索引全局主题介绍------------------------和nested / index.rst:...
我想让狮身人面像生成类似于doxygen生成的模块概述,这是一个示例,我找不到狮身人面像可以做什么,可以使用Graphviz生成某种图形,但是...] >
:data:`〜package._module._DICT_NAME`不起作用; _DICT_NAME就像被引用一样呈现,但是没有超链接。与:obj:相同。不能将其放入函数中。
我正在使用sphinx进行文档记录,并且我具有返回列表/元组等的函数。因此,对于参数,以下指向python文档的链接::param list myVar:但对于返回值...
是否可以使用Sphinx在函数中记录条件语句和其他语句?如果没有,是否还有其他具有这种功能的python库?
生成文档时,函数名有点问题。当我使用.. autofunction ::注解时,我得到的是函数描述以及函数名。生成时...
我正在使用Sphinx设置文档。我精确地说,我真的是这个库的新手。我的文档可以使用默认主题之一进行构建。一切正常:)现在,我想自定义...
我如何在Sphinx globaltoc侧边栏中包含所有文档?
我希望将整个TOC中的每个文档都包含在globaltoc侧边栏中。我该如何实现?在主题文件中,有对{{toctree()}}的调用,但我不知道什么是toctree()...
我正在使用Sphinx + autodoc + autosummary为我的项目(mrpy)生成文档。我正在做一个两层的摘要,在index.rst中,我(至少)有mrpy ==== .. autosummary :::...