python-sphinx 相关问题

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

狮身人面像上table-csv内部的reStructuredText替换

我正在尝试替换Sphinx上的table-csv指令加载的文件。我的想法是执行以下操作:.. csv-table :: My CSV Table:header:“ Column 1”,“ Column 2”:file:some / ...

回答 1 投票 0

将Sphinx与Django一起使用时出现Autodoc错误

我正在尝试在Django项目中使用sphinx autodoc,但始终收到相同的错误。我的项目的结构如下:| project | --- app | ------ models.py | --- docs | ------ build | ------...

回答 1 投票 0

有关toctree引用的警告

Contents:.. toctree :::maxdepth:2 foo.rst bar.rst索引和表格================= *:ref:`genindex` *:ref :`modindex` *:ref:`search`我正在尝试使用sphinx-build来构建它。 ...

回答 2 投票 4

Sphinx复制html文件

我使用Sphinx生成文档,有些文档是纯HTML文件。我想狮身人面像复制这样的文件,以建立目录到相应的路径原样。我可以吗?

回答 1 投票 3

将对象添加到Sphinx的全局索引和交叉引用语法中吗?

每次我都必须引用一个方法,而不是package.subpackage.module.method,特别是对于常用方法。有没有办法以某种方式“注册” package.subpackage,以便...

回答 1 投票 1

如何向Sphinx的全局索引添加模块?

[每次我都必须引用一个方法,而不是引用package.subpackage.module.method,特别是对于经常使用的方法。有没有办法以某种方式“注册” package.subpackage,以便...

回答 1 投票 0

如何向Sphinx的全局索引添加模块?

[每次我都必须引用一个方法,而不是引用package.subpackage.module.method,特别是对于经常使用的方法。有没有办法以某种方式“注册” package.subpackage,以便...

回答 1 投票 0

Python:Sphinx不输出转换

我正在使用Sphinx记录我正在编写为网页的软件包。包的每个成员都有一个文档字符串,我使用autosummary自动将其转换为单独的rst文件。我的...

回答 1 投票 0

reStructuredText和词汇术语翻译

我想知道如何翻译(如在i18n中)术语表中的术语。我使用Sphinx 1.1.3,假设我有:..词汇表::术语定义运行make gettext后,我得到了.po文件...

回答 1 投票 2

:func::class的交叉参考目标路径:仅根工作目录的路径

我对为什么我的交叉引用的目标是不能正常工作有些困惑。只有完整的路径似乎起作用。我具有以下项目结构:my_project -my_project -adapters -...

回答 1 投票 0

numpydoc:记录鸭子类型的参数

根据numpy / scipy文档指南中的约定,应以以下方式记录函数参数:def foo(x):“”“”该函数不执行任何操作参数---...

回答 1 投票 3

我应该记录类似功能签名的参数吗?

我有一些辅助函数,除了第一个参数外,其他函数与核心函数的参数相同。这些参数已在核心功能中完整记录。我应该复制粘贴此内容吗?

回答 1 投票 0

Sphinx文档中的人类可迭代对象

Sphinx-autodoc展平字典,列表和元组-使长条几乎不可读。也不总是需要漂亮的打印格式,因为与嵌套的容器相比,某些嵌套的容器最好保持扁平化。...

回答 1 投票 1

[Python Sphinx在生成pdf时跳过第一部分

我使用sphynx从静态.rst文件生成文档(不提取文档字符串)。我的存储库中有两个文件:index.rst .. toctree :: intro和intro.rst将被跳过========= ...

回答 2 投票 4

狮身人面像用于多个单独的文档

我对Sphinx很陌生,在服务器上记录了我的项目。现在,一位同事看到了我的工作,她想做同样的事情-在同一台服务器上记录她的项目。这些项目是...

回答 1 投票 4

在toctree中添加self的各个部分

我在获取目录(TOC)以显示文档首页的小节时遇到问题。我的首页上有很多部分,我希望这些是...

回答 1 投票 3

首先列出本地节,在TOC中最后列出链接的页面

假设我具有以下index.rst:一些全局主题===================== .. toctree :::glob:嵌套/索引全局主题介绍------------------------和nested / index.rst:...

回答 1 投票 3


sphinx生成类模块概述

我想让狮身人面像生成类似于doxygen生成的模块概述,这是一个示例,我找不到狮身人面像可以做什么,可以使用Graphviz生成某种图形,但是...] >

回答 1 投票 9

如何使用sphinx-autodoc引用字典?

:data:`〜package._module._DICT_NAME`不起作用; _DICT_NAME就像被引用一样呈现,但是没有超链接。与:obj:相同。不能将其放入函数中。

回答 1 投票 0

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