python-sphinx 相关问题

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

Sphinx RTD 主题不正确地嵌套副标题

我有一个index.rst 文件,其中包含使用.. include:: 指令包含的README.rst 的内容。当使用 make Latexpdf 或在 html 中使用 ..contents:: 指令渲染此内容时...

回答 1 投票 0

sphinx apidoc/autodoc 不会在侧边栏或目录中创建“子模块”和“子包”组

我正在使用 sphinx-rtd-主题。 在 autodoc 生成的页面的侧边栏和目录中,目录和文件被分组为特殊的“子包”和“子模块”类别,如下所示:

回答 1 投票 0

无法让本地 sphinx-apidoc 模板工作

回复:使用 sphinx-apidoc 通过 autodoc 扩展从文档字符串自动生成 API 参考... 我将全局 /site-packages/sphinx/templates/apidoc/package.rst_t 模板复制到 ...

回答 1 投票 0

Sphinx:如何添加角色和指令别名

我经常使用 :math: 角色和 .. math:: 指令,它们太频繁了,以至于我想为它们创建一个更短的别名 m 。我怎样才能在Sphinx中实现它?

回答 2 投票 0

如何以编程方式从 Python 字典生成一些文档并使用 Sphinx 将其插入到 .rst 文件中

我正在编写一个配置工具,可以自动部署一些监控仪表板。每个仪表板都有书面说明,可以在工具中找到,并且可以在部署的文件中找到

回答 1 投票 0

在Sphinx中添加自定义标签

我正在使用 Sphinx 工具进行文档记录,并遇到了一种情况,我只想以一种文件格式公开一条信息。 我发现这个链接解决了类似的问题...

回答 2 投票 0

“称号等级不一致”是什么意思?

我在文档版本中收到了各种“标题级别不一致”的警告。 据我所知,我有一个一致的结构,如下所示: 大标题 =========

回答 5 投票 0

在 sphinx 中构建反映项目文件夹结构的目录

我想为Python项目自动生成文档。我设法获得了一个与 sphinx 一起使用的准系统管道,但输出不是很漂亮,我希望得到一些关于如何...

回答 1 投票 0

在 sphinx 文档中选择性地包含私有成员函数

我想为Python项目自动生成文档。我设法获得了一个与 sphinx 一起使用的准系统管道,但输出目前几乎包括所有内容,我想要更多

回答 1 投票 0

如何解决使用 Sphinx 使用包含西里尔字符的 LaTeX 公式生成 Confluence 文档时“ascii”编解码器无法解码的错误?

我正在尝试为 Confluence 生成文档。源数据是包含 LaTeX 公式的 RST 文档,其中有时包含西里尔字符。 这是我的conf.py配置文件:

回答 1 投票 0

如何将第3方html添加到sphinx index.rst内容?

我正在用 C++ 记录一个项目。 工作流程设置如下:我在 .h 文件中编写文档。然后将标头加载到 Doxygen 中并生成 html 文件。这些文件...

回答 1 投票 0

Github 操作失败 - 没有这样的文件或目录

我一直在尝试使用 Sphinx 自动化 github 工作流程来记录我编写的一些 Python doce。目标是在对

回答 1 投票 0

Sphinx 字段列表中出现意外的未缩进——但没有?

参见img了解行号 :jsonparam 列表[对象] item1 :jsonparam 列表[对象] item2 :jsonparam 列表[对象] item3 :jsonparam 列表[字符串] item4 :jsonparam 字符串 item5 :json参数...

回答 1 投票 0

我可以阻止 sphinx numpydoc 将 Returns 分成两部分吗

使用 sphinx numpydoc 时,我记录了 Returns 部分。 退货 -------- 输出:浮动 关于返回类型的一句话 然而,渲染后它被分成两部分。 返回: 出 - A

回答 1 投票 0

GItLab 页面部署时出现 Sphinx 错误/找不到我的部分模块

我正在尝试在 GitLab 上部署我的 Sphinx 文档。但它忽略了一些模块。请告诉我我做错了什么。我在我的主机上做了同样的事情并且它可以工作,但是在 gitlab 页面上则不行

回答 1 投票 0

覆盖 sphinx autodoc 中的函数声明

我有一个类似这样的模块: #!/usr/bin/env python #:文档在这里。 #: 等等等等等等 foobar = r'这里有一些很长的正则表达式。' def myfunc(val=foobar): '''巴拉巴拉巴拉...

回答 1 投票 0

docutils 遍历节并使用其路径创建子节列表

这个问题试图扩展 Jason S 的代码(谢谢,Jason),可以在这里找到:Docutils: traversesections?。 原文出自 Jason S 导入文档 def doctree_resolved(应用程序,文档树,文档名)...

回答 1 投票 0

是否可以从 Jupyter Book 设置 Sphinx autodoc 模块路径?

是否可以从 Jupyter Book 设置 Sphinx autodoc Python 模块路径,例如通过 _config.yml? 我正在使用 Jupyter Book 来记录 Python 系统并发布到“阅读文档”。我可以看到...

回答 1 投票 0

Sphinx 不会为标题生成侧边栏目录

我正在努力处理 Sphinx 生成的文档中的侧边栏目录。 我只想在文档的左侧有一种自动生成的索引树。相反,我看到

回答 3 投票 0

Sphinx 侧边栏目录:包括部分标题

我在 Sphinx 中使用 Alabaster 主题。 侧边栏设置为显示本地目录和其他一些内容。 来自conf.py: html_sidebars = { '**':[ 'localtoc.html', '

回答 1 投票 0

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