python-sphinx 相关问题

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

当从不同的toctrees引用时,生成不同面包屑的重复模板。

我的文档结构是这样的。├── common │ └── shared.rst ├── foo │ └── foo.rst ├── index.rst └── zoo └── zoo.rst 生成的结构是这样的。├── common │ └── shared.html ....

回答 1 投票 0

Sphinx toctree指令在更新后停止工作。

我经常生成的sphinx HTML文档在从fedora 20更新到21之后,突然停止显示toctree。模板仍然没有变化,包含了以下内容

回答 1 投票 0

在Sphinx中,我怎样才能在没有大量开销的情况下创建一个可链接的 "术语 "部分?

我想创建一个 "术语 "部分,其中包含我所使用的术语的定义,这样每次我在这个术语部分使用术语时,都会创建一个指向定义的链接。...

回答 1 投票 8

在Sphinx中使用noindex与词汇表。

当使用Sphinx 1.1.3时,我如何创建一个...词汇表::条目而不显示在自动生成的索引中?我试过在四个地方使用 :noindex:。在词汇表之前和之后使...

回答 1 投票 5

VOH

我有一个像这样的斯芬克斯词汇表术语,用替换来使用下标进行正确的格式化。

回答 1 投票 1

我的笔记的Sphinx来源的位置 - 警告:该文档不包含在任何目录中。

如何修复Sphinx底部的警告?我试图在Sphinx中拥有我的Python笔记。我把我的笔记放在单独的文件中,和index.rst在同一目录下。我得到了以下...

回答 1 投票 2

更改Sphinx的目录模板。

我是用Sphinx用自己的模板弄出一个类似twitter bootstrap文档风格的文档:http:/getbootstrap.com2.3.2getting-started.html 在那里你可以看到导航上的...

回答 1 投票 2

Sphinx文件之间的链接功能

我一直在stackoverflow和官方文档中寻找答案,但仍然找不到解决方案。在Sphinx-doc主文档中,我有以下内容。目录: ... toctree:: viewsindex.rst db...。

回答 1 投票 2

在Sphinx中,单个builddir不工作。

我在Mac上工作,使用Sphinx 1.6.3为我的软件建立文档。最近我尝试了国际化功能,效果不错。但现在我想导出 ...

回答 1 投票 0

在sphinx中使用self创建一个带有toctree的网站地图似乎被破坏了?

我正在为一个相当大的项目更新FAQ,我想在页面顶部添加一个问题索引,这样用户就能更容易地找到他们要找的东西。斯芬克斯...

回答 1 投票 5

如何将对象添加到Sphinx的全局索引中,或者通过别名交叉引用?

每次我必须引用一个方法时,我宁可不要:func:`package.subpackage.module.method`,特别是对于经常使用的方法。有没有办法以某种方式 "注册 "package.subpackage,这样......。

回答 2 投票 1

使用javascript代替Sphinx的默认toctree。

我正在使用sphinx来自动生成html页面。目录很长,所以我想在toctree的div中添加一个新的html类(除其他外),这样我就可以使用一个javascript库。...

回答 1 投票 2

当使用matlabdomain时,导入模块失败。

当我试图使用sphinx matlab域时,我不能让MWE工作,在扩展的pypi网站上提供的总是有这个不能导入模块的错误。我猜测,该扩展有点 ...

回答 1 投票 2

在Python Sphinx中出现了几个导入错误,"没有模块命名"。

我是一个新的斯芬克斯文档。我按照sphinx文档为我的cherrypy项目配置了sphinx,但是当我运行make html时,它向我抛出了很多错误和警告,如下所示。...

回答 1 投票 1


像Python文档或Sphinx文档中的文档主页面?

我试图在Python和Sphinx的文档主页面上获得效果。我指的是目录结构。是否有任何toctree的关键字来获得类似的效果,或者我必须做 ...

回答 1 投票 2

如何用Sphinx RTD和AutoAPI启用完全展开的面包屑?

我正在尝试使用Sphinx AutoAPI来使文档更容易维护。它做得很好,除了一件事:面包屑。在AutoAPI生成的文档中,面包屑不能像我一样工作。

回答 1 投票 0

在index.html页面上显示从contents表中选择的选项(Sphinx库)。

我在Python中使用Sphinx库时遇到了一个问题,当用户从 "CONTENTS: "表中选择一个选项时,所有的文件内容都会显示在内容页上。当用户从 "CONTENTS: "表中选择一个选项时,所有的文件内容都会显示在内容页上。正如你所看到的,...

回答 1 投票 0

自定义(多字)标题为《斯芬克斯训诫》。

我使用Sphinx来发布一个课程。我想创建一个由多个单词组成的标题的自定义训诫(例如 "历史笔记")。我想出了一个肮脏的技巧,在......中使用.admonition-title:after。

回答 1 投票 0

Sphinx 忽略 .rst 文件

make html 和 sphinx-build 'source' 'build/html' -a -E 给出的结果是一样的;当我添加到 :exclud-members:时,我修改的 docssource 中的一个 .rst 文件被覆盖了,生成的文档中包含了上述 ...

回答 1 投票 0

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