python-sphinx 相关问题

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

禁用单个 Sphinx 警告消息

我的 Sphinx 树中有许多 .rst 文件,这些文件被有意从任何索引树中排除。我收到类似警告 /filename.rst:: 警告:文档不包含在任何目录树中 我怎样才能支持...

回答 2 投票 0

RST Sphinx xml 自定义扩展

我试图了解如何创建自定义 Sphinx 扩展,该扩展只能在创建 XML 时执行。我想放置一个自定义 RST 指令 ..我的定制:: 并输出后续的 XM...

回答 1 投票 0

如何在自定义 python-sphinx 指令/扩展中使用现有指令?

我想创建一个自定义指令,在其实现中使用现有指令(本例中的代码块)。 reStructuredText 中的手动等效项是: ..我的目录...

回答 2 投票 0

Sphinx 角色和指令在笔记本文本块中不起作用

我正在使用 sphinx 为一个项目创建文档,其中包含一组我正在使用 sphinx-gallery 运行的示例,但是在生成的 html 文件、sphinx 角色和指令中(例如 :class:、:meth...

回答 1 投票 0

autodoc_pydantic:如果父模型和子模型位于不同文件中,则显示父模型中的字段

这个问题存在一个答案,如何在子类中显示父母属性。然而它对我不起作用,因为我的父类和子类位于不同的文件中: ..当前模块...

回答 1 投票 0

使用感叹号禁止交叉引用超链接

在链接前加上 !禁止创建引用(例如 :ref:`!no link` 将简单地呈现为无链接): 如果您在内容中添加前缀 !,则不会创建任何参考/超链接...

回答 2 投票 0

使用 Sphinx 记录包 __init__ 导入

我有一个Python包,感觉它有一个方法: 从伐木.src.email 导入 send_email 根据 Pandas 如何处理需要导入的内容(例如,felling.__init__.py 中的 pandas.DataFrame),我有: # 铁...

回答 2 投票 0

“很棒的狮身人面像主题”中不需要的段落符号

我刚刚开始研究 Sphinx 文档,并且正在使用“很棒的 Sphinx 主题”。我只是碰巧意识到

回答 1 投票 0

在评论中链接到另一个Python文件

我正在尝试从 file_1.py 创建到 file2.py 的链接。为了简单起见,我们可以假设两者都在同一个包中。 我在 Java 中(通过 Intellij)要做的是使用 {@link AnotherClass} 但这是......

回答 2 投票 0

如何在 sphinx_rtd_theme 中将“查看页面源代码”替换为“在 GitHub 上编辑”链接?

在使用 sphinx_rtd_theme 主题构建 Sphinx 网站时,如何将文档页面顶部的“查看页面源代码”超链接替换为“在 GitHub 上编辑”链接? 我正在手动构建一个 readthe...

回答 1 投票 0

在 sphinx-gallery 中捕获 sympy 数学输出

我正在尝试为使用 sympy 的模块编写一个 sphinx-gallery 示例。 我找不到一种方法来获得像数学一样的输出格式。 例如,在 jupyter 笔记本中,sympy expr 的输出...

回答 1 投票 0

Sphinx 在文字块中发出神秘错误

在 Sphinx(ReStructuredText 发布系统)中,是否有任何晦涩的规则限制文字块可以包含的内容? 背景:我的文档包含许多跟随双

回答 2 投票 0

reStructuredText/Sphinx 中的引用

我想将引用放入 reStructuredText 文档中的新块中。做到这一点的规范方法是什么?我在这里看到“引用的文字块”,但至少 GitHub 渲染器确实...

回答 1 投票 0

类型提示中的类型别名不会被保留

我的代码(此演示减少到只有几行)如下所示: AgentAssignment = 列表[int] def assignment2str(分配:AgentAssignment): 经过 生成的 html 文档有...

回答 3 投票 0

引用 myst-parser markdown 文件中的(sphynx autodoc 生成的)python 方法 (:py:meth:)?

我有一段由 sphinx :autoclass: 指令生成的 sphinx 文档 我想引用 mystmarkdown 文件中 python 方法的(文档字符串)生成的文档 从 我已经尝试过这个: {:p...

回答 1 投票 0

文档(Sphinx)和 Django 应用程序之间的链接

我为使用 Sphinx 编写的应用程序的用户提供了文档。到目前为止,文档都是用户可以访问的静态 HTML 页面。 我想在应用程序和

回答 1 投票 0

添加选项卡重组文本(第一个)文件

如何将第一个文件中的信息制成表格? 或者,如何保留文本中已插入的空白? 这样,当我将第一个文件(通过 Sphinx)渲染为 HTML 时,表格格式......

回答 1 投票 0

在 Sphinx 上实现自定义主题

我正在尝试在本地为 sphinx 实现我自己的自定义主题。我一直遇到这个错误: 找不到名为“custom_theme”的主题(缺少 theme.conf?)。 我的 custom_theme/ 中有一个 theme.conf

回答 3 投票 0

如何在 sphinx 中为生成的代码块设置标题

目前我正在使用以下代码生成代码块并在其中显示一些信息。 我想使用以下第一个指令设置标题。 .. 代码块:: python :标题:

回答 1 投票 0

Sphinx:链接到嵌入式二进制文件 (PDF)

我正在使用 sphinx 和 RST 生成一些 HTML 格式的技术文档,但在获取本地 PDF 参考作为超链接时遇到问题。我见过人们使用 :download: 链接到本地 PDF,b...

回答 2 投票 0

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