Sphinx是一种工具,可以轻松创建智能和漂亮的文档。 Sphinx特别适用于Python文档,但它是一个通用工具,可用于记录任何内容。
我的 Sphinx 树中有许多 .rst 文件,这些文件被有意从任何索引树中排除。我收到类似警告 /filename.rst:: 警告:文档不包含在任何目录树中 我怎样才能支持...
我试图了解如何创建自定义 Sphinx 扩展,该扩展只能在创建 XML 时执行。我想放置一个自定义 RST 指令 ..我的定制:: 并输出后续的 XM...
如何在自定义 python-sphinx 指令/扩展中使用现有指令?
我想创建一个自定义指令,在其实现中使用现有指令(本例中的代码块)。 reStructuredText 中的手动等效项是: ..我的目录...
我正在使用 sphinx 为一个项目创建文档,其中包含一组我正在使用 sphinx-gallery 运行的示例,但是在生成的 html 文件、sphinx 角色和指令中(例如 :class:、:meth...
autodoc_pydantic:如果父模型和子模型位于不同文件中,则显示父模型中的字段
这个问题存在一个答案,如何在子类中显示父母属性。然而它对我不起作用,因为我的父类和子类位于不同的文件中: ..当前模块...
在链接前加上 !禁止创建引用(例如 :ref:`!no link` 将简单地呈现为无链接): 如果您在内容中添加前缀 !,则不会创建任何参考/超链接...
我有一个Python包,感觉它有一个方法: 从伐木.src.email 导入 send_email 根据 Pandas 如何处理需要导入的内容(例如,felling.__init__.py 中的 pandas.DataFrame),我有: # 铁...
我正在尝试从 file_1.py 创建到 file2.py 的链接。为了简单起见,我们可以假设两者都在同一个包中。 我在 Java 中(通过 Intellij)要做的是使用 {@link AnotherClass} 但这是......
如何在 sphinx_rtd_theme 中将“查看页面源代码”替换为“在 GitHub 上编辑”链接?
在使用 sphinx_rtd_theme 主题构建 Sphinx 网站时,如何将文档页面顶部的“查看页面源代码”超链接替换为“在 GitHub 上编辑”链接? 我正在手动构建一个 readthe...
在 sphinx-gallery 中捕获 sympy 数学输出
我正在尝试为使用 sympy 的模块编写一个 sphinx-gallery 示例。 我找不到一种方法来获得像数学一样的输出格式。 例如,在 jupyter 笔记本中,sympy expr 的输出...
在 Sphinx(ReStructuredText 发布系统)中,是否有任何晦涩的规则限制文字块可以包含的内容? 背景:我的文档包含许多跟随双
我想将引用放入 reStructuredText 文档中的新块中。做到这一点的规范方法是什么?我在这里看到“引用的文字块”,但至少 GitHub 渲染器确实...
我的代码(此演示减少到只有几行)如下所示: AgentAssignment = 列表[int] def assignment2str(分配:AgentAssignment): 经过 生成的 html 文档有...
引用 myst-parser markdown 文件中的(sphynx autodoc 生成的)python 方法 (:py:meth:)?
我有一段由 sphinx :autoclass: 指令生成的 sphinx 文档 我想引用 mystmarkdown 文件中 python 方法的(文档字符串)生成的文档 从 我已经尝试过这个: {:p...
我为使用 Sphinx 编写的应用程序的用户提供了文档。到目前为止,文档都是用户可以访问的静态 HTML 页面。 我想在应用程序和
如何将第一个文件中的信息制成表格? 或者,如何保留文本中已插入的空白? 这样,当我将第一个文件(通过 Sphinx)渲染为 HTML 时,表格格式......
我正在尝试在本地为 sphinx 实现我自己的自定义主题。我一直遇到这个错误: 找不到名为“custom_theme”的主题(缺少 theme.conf?)。 我的 custom_theme/ 中有一个 theme.conf
目前我正在使用以下代码生成代码块并在其中显示一些信息。 我想使用以下第一个指令设置标题。 .. 代码块:: python :标题:
我正在使用 sphinx 和 RST 生成一些 HTML 格式的技术文档,但在获取本地 PDF 参考作为超链接时遇到问题。我见过人们使用 :download: 链接到本地 PDF,b...