Sphinx是一种工具,可以轻松创建智能和漂亮的文档。 Sphinx特别适用于Python文档,但它是一个通用工具,可用于记录任何内容。
Sphinx 在 django 的自定义包中使用 django `get_user_model` 模拟问题
我正在为 django 项目创建一个自定义包。该包包含两个身份验证后端。我的模块配置如下, # 后端1模块 从 django.contrib.auth 导入
从 Sphinx 生成的 github.io 页面中渲染 Mathjax 的问题
我正在使用 Sphinx 为我的 python 项目编写文档。 这是我的conf.py 数学在本地主机上渲染得很好,但是当部署在 github.io 上时,它似乎不起作用。 在本地主机上 在 github 上...
有没有办法在Sphinx输出中左对齐表格标题(使用sphinx_rtd_theme)? 自定义 CSS 包含在 conf.py 中: 默认设置(应用程序): app.add_stylesheet('_static/custom.css') 这是...
在 readthedocs.org 上构建 Sphinx 文档时将所有警告视为错误
我们的开源 Python 项目 (PyAbel) 使用 readthedocs.org 使用 Sphinx 自动为每个拉取请求构建文档。如果有任何警告,我们希望文档构建失败
Sphinx:如何包含位于模块内但在类和方法之外的文档字符串/注释
我的 python 模块中有一条注释,记录了后面的几个类,例如 ### # 代理类别:患者和临床医生 ### 类 EngagementLadder(transitions.Machine): “””...
我想链接到我的 Sphinx 文档中的某个 URL: 废话 我在文档中发现了类似的内容:http://sphinx-doc.org/ext/extlinks.html - 但我...
我正在为自己的项目编写API文档。 我发现这个很酷的文档(yt项目)直接使用ipython笔记本来给出示例。当我查看他们的文档存储库时
我在conf.py中有以下内容: 默认设置(应用程序): app.add_config_value('base_url','http://localhost:2000', True) 如何将其放入我的 .rst 文件中?我写了这个: :base_url:/my_app/api/
编辑:另一篇文章似乎相关 我正在使用 fulltoc 扩展在侧边栏中显示目录。 全局目录在全局index.rst 文件中定义。是
sphinx-apidoc 中的 module.rst 是什么?
我正在使用sphinx==6.2.1和sphinx_rtd_theme==1.3.0。我运行了 sphinx-apidoc,它生成了一个 module.rst,如下所示: 包裹 ====== .. 目录树:: :最大深度:4 包裹 当我去的时候...
使用 Sphinx 3.2.1 和 reST 你好, 我想进行 3 个空格的缩进,以便图像与上面的文本右对齐。 但是,它会破坏列表并执行 2 个单独的嵌套列表。因此,我...
我的问题是如何在Python中解析重构文本?其中 @mbdevpl 提供了将文件解析为树并在树上进行一些处理的代码。 我想自动格式化 Python
在http://127.0.0.1:8000上提供服务:WinError 10013:端口被其他进程使用
尝试获取文档页面时出错: [I 230831 20:02:57 服务器:335] 服务于 http://127.0.0.1:8000 回溯(最近一次调用最后一次): 文件“”,第 198 行,位于
我们在一个文件中多次使用 autoclass 指令,但这些指令出现在 TOC 树中是没有意义的。 但是,还有其他文件对于 autodoc objec 确实有意义......
我需要显示一堆存储在 json 文件(我们的赞助商列表)中的图像,如下所示: { "toto": "路径/到/图像", “tutu”:“路径/到/图像”...
在构建文档 PDF 时使用 Sphinx LaTeXBuilder 忽略 LaTeX 错误
在我的项目中,我正在使用 Sphinx 的 LaTeXBuilder 构建文档的 PDF 版本,其中有几个文件和扩展名可能会导致输出问题。该项目是
如果我有一些文档,例如 Galleria 的文档,我该如何设置它,以便在运行 make html 命令时它会向每个页面添加自定义页脚? 我发现我可以
使用 Sphinx 的 Python 文档:不会生成文档字符串文档
我正在尝试使用 Sphinx 6.2.1 和 Python3 生成我的项目文档。我正在处理一个名为 sphinx-basic-test 的测试项目。我创建了一个 docs 文件夹并在里面运行 sphinx-quickstart....
我有一组“纯 RST”Sphinx 文件,用于编写多类 API 文档。这是该项目的开始,因此您可以看到我正在使用的结构和指令。我们要去...
sphinxs 在 readthedocs 上生成的文档出现错误
我已经使用 Sphinx 编写了 Node.js 库的文档。在我的本地 PC 上,我可以毫无问题地生成 html 文档。然而,当我尝试将其发布在“阅读文档”上时,编译...