python-sphinx 相关问题

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

sphinx 中的左对齐表格标题

有没有办法在Sphinx输出中左对齐表格标题(使用sphinx_rtd_theme)? 自定义 CSS 包含在 conf.py 中: 默认设置(应用程序): app.add_stylesheet('_static/custom.css') 这是...

回答 2 投票 0

在 readthedocs.org 上构建 Sphinx 文档时将所有警告视为错误

我们的开源 Python 项目 (PyAbel) 使用 readthedocs.org 使用 Sphinx 自动为每个拉取请求构建文档。如果有任何警告,我们希望文档构建失败

回答 2 投票 0

Sphinx:如何包含位于模块内但在类和方法之外的文档字符串/注释

我的 python 模块中有一条注释,记录了后面的几个类,例如 ### # 代理类别:患者和临床医生 ### 类 EngagementLadder(transitions.Machine): “””...

回答 2 投票 0

在Sphinx中生成外部链接

我想链接到我的 Sphinx 文档中的某个 URL: 废话 我在文档中发现了类似的内容:http://sphinx-doc.org/ext/extlinks.html - 但我...

回答 3 投票 0

在sphinx文档中嵌入ipython笔记本

我正在为自己的项目编写API文档。 我发现这个很酷的文档(yt项目)直接使用ipython笔记本来给出示例。当我查看他们的文档存储库时

回答 2 投票 0

如何在 Sphinx .rst 文件中输出配置值?

我在conf.py中有以下内容: 默认设置(应用程序): app.add_config_value('base_url','http://localhost:2000', True) 如何将其放入我的 .rst 文件中?我写了这个: :base_url:/my_app/api/

回答 3 投票 0

从sphinx中的侧边栏删除多余的toctree

编辑:另一篇文章似乎相关 我正在使用 fulltoc 扩展在侧边栏中显示目录。 全局目录在全局index.rst 文件中定义。是

回答 1 投票 0

sphinx-apidoc 中的 module.rst 是什么?

我正在使用sphinx==6.2.1和sphinx_rtd_theme==1.3.0。我运行了 sphinx-apidoc,它生成了一个 module.rst,如下所示: 包裹 ====== .. 目录树:: :最大深度:4 包裹 当我去的时候...

回答 1 投票 0

覆盖 # 样式嵌套列表的空格缩进数量

使用 Sphinx 3.2.1 和 reST 你好, 我想进行 3 个空格的缩进,以便图像与上面的文本右对齐。 但是,它会破坏列表并执行 2 个单独的嵌套列表。因此,我...

回答 1 投票 0

如何将重组文本解析回第一个文件?

我的问题是如何在Python中解析重构文本?其中 @mbdevpl 提供了将文件解析为树并在树上进行一些处理的代码。 我想自动格式化 Python

回答 2 投票 0

在http://127.0.0.1:8000上提供服务:WinError 10013:端口被其他进程使用

尝试获取文档页面时出错: [I 230831 20:02:57 服务器:335] 服务于 http://127.0.0.1:8000 回溯(最近一次调用最后一次): 文件“”,第 198 行,位于

回答 1 投票 0

如何从目录树中排除 autodoc 对象?

我们在一个文件中多次使用 autoclass 指令,但这些指令出现在 TOC 树中是没有意义的。 但是,还有其他文件对于 autodoc objec 确实有意义......

回答 1 投票 0

如何创建使用图像指令的自定义sphinx指令?

我需要显示一堆存储在 json 文件(我们的赞助商列表)中的图像,如下所示: { "toto": "路径/到/图像", “tutu”:“路径/到/图像”...

回答 1 投票 0

在构建文档 PDF 时使用 Sphinx LaTeXBuilder 忽略 LaTeX 错误

在我的项目中,我正在使用 Sphinx 的 LaTeXBuilder 构建文档的 PDF 版本,其中有几个文件和扩展名可能会导致输出问题。该项目是

回答 1 投票 0

如何向 Sphinx 文档添加自定义页脚?

如果我有一些文档,例如 Galleria 的文档,我该如何设置它,以便在运行 make html 命令时它会向每个页面添加自定义页脚? 我发现我可以

回答 1 投票 0

使用 Sphinx 的 Python 文档:不会生成文档字符串文档

我正在尝试使用 Sphinx 6.2.1 和 Python3 生成我的项目文档。我正在处理一个名为 sphinx-basic-test 的测试项目。我创建了一个 docs 文件夹并在里面运行 sphinx-quickstart....

回答 1 投票 0

如何让Sphinx为纯RST中的属性生成TOC条目

我有一组“纯 RST”Sphinx 文件,用于编写多类 API 文档。这是该项目的开始,因此您可以看到我正在使用的结构和指令。我们要去...

回答 1 投票 0

sphinxs 在 readthedocs 上生成的文档出现错误

我已经使用 Sphinx 编写了 Node.js 库的文档。在我的本地 PC 上,我可以毫无问题地生成 html 文档。然而,当我尝试将其发布在“阅读文档”上时,编译...

回答 1 投票 0

API 参考在本地构建,但不在 RTD 上

我正在尝试使用自动摘要为 Python 包 GemGIS 构建 API 参考(请参阅此处)。 API 参考是在本地构建的,没有任何问题,但我收到了 ImportErrors 和

回答 1 投票 0

使用 Python Sphinx 收到警告:myproject 的重复对象描述/使用 :noindex: 对于其中之一

我正在使用 Sphinx 为 Python 项目创建 HTML 文档。 TL;DR 我无法摆脱这个警告消息。 警告:myproject 的重复对象描述,类存根中的其他实例...

回答 1 投票 0

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