python-sphinx 相关问题

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

返回Python Sphinx中的列表或元组

我正在使用sphinx进行文档记录,并且我具有返回列表/元组等的函数。因此,对于参数,以下指向python文档的链接::param list myVar:但对于返回值...

回答 1 投票 2

条件文档

是否可以使用Sphinx在函数中记录条件语句和其他语句?如果没有,是否还有其他具有这种功能的python库?

回答 1 投票 0

如何在报表上禁用函数名称

生成文档时,函数名有点问题。当我使用.. autofunction ::注解时,我得到的是函数描述以及函数名。生成时...

回答 1 投票 0

自定义globaltoc和localtoc html渲染

我正在使用Sphinx设置文档。我精确地说,我真的是这个库的新手。我的文档可以使用默认主题之一进行构建。一切正常:)现在,我想自定义...

回答 1 投票 3

我如何在Sphinx globaltoc侧边栏中包含所有文档?

我希望将整个TOC中的每个文档都包含在globaltoc侧边栏中。我该如何实现?在主题文件中,有对{{toctree()}}的调用,但我不知道什么是toctree()...

回答 1 投票 2

Sphinx自动摘要为每个类生成两个摘要

我正在使用Sphinx + autodoc + autosummary为我的项目(mrpy)生成文档。我正在做一个两层的摘要,在index.rst中,我(至少)有mrpy ==== .. autosummary :::...

回答 1 投票 2

[尝试自动打包软件包时发生导入错误

我正在尝试开始使用Sphinx来记录我的一些小项目,但是似乎无法使它工作。我已经搜索过了,但是直到现在我尝试过的所有方法都没有解决...

回答 1 投票 2

Sphinx的extlinks扩展名可以配置为显示url吗?

我非常喜欢我可以使用Sphinx extlinks扩展名缩短文本中URL的事实。我也希望在这里和那里也可以在呈现的文档中显示完整的URL,而无需...

回答 1 投票 0

将xml内容添加到sphinx生成的文档中

所以这是我的问题。我正在尝试使用sphinx为我的项目生成文档,并设法获得基本工作,例如添加模块和图像。因此基本的index.rst看起来像:.. | ...

回答 1 投票 1

不同文件的标题不匹配

我在Sphinx中有一个非常基本的设置。 TOC如下:.. toctree :::maxdepth:3一二,文件一和二看起来像这样:one.rst #### Part #### *******章*** **** ...

回答 1 投票 2

Sphinx python自动生成的文档失败

我想为名为Ulyxes PyAPI的API编写文档。我已经开始了,但是自动生成过程无法正常工作。当我单击...中的“自动生成的文档”链接时...

回答 1 投票 1


Sphinx-让自定义HTML知道变量

#conf.py language ='en'html_extra_path = [“ customize.html”] {{变量}} {{语言}} 方式...

回答 1 投票 1

“准备文档”挂起-Sphinx中的toctree循环引用

我尝试使用Sphinx生成文档,但是生成过程挂在“准备文档..”上。我在寻找解决方案,但没有找到解决该问题的建议。 ...

回答 1 投票 1

搜索按钮中的狮身人面像问题

目前,我正在尝试学习狮身人面像以html格式生成文档,但是我发现一个问题是我无法使用搜索按钮来查找任何内容。我只搜索一个关键字,结果将...

回答 1 投票 1

指令和条目之间缺少空白行错误

我刚刚使用Sphinx创建了文档,这是我的问题:最初在Toc树指令中为空,然后在下面添加“教程”,它看起来像这样:.. toctree :::......>] >

回答 2 投票 1

如何引用以单数形式定义但以复数形式表示的词汇表术语?

如果我定义了一个词汇表和一个叫做foobar的术语,那么我可以在文本中使用该术语,因为这是对:term:`foobar`术语的引用。然后,这会将foobar变成可点击的引用,将我带到...

回答 1 投票 1

Sphinx:如何更改html标题?

我正在处理我的RTFM文档,我想更改html标题。目前,我的标题如下: [页面标题]-我的文档文档 一切...

回答 1 投票 0

make html期间由于sys.path而出错

我正在尝试为软件包构建Sphinx文档,但我不断收到错误消息,可能会需要一些帮助。我的项目目录为bb_lite,代码位于后端文件夹中。 bb_lite ...

回答 1 投票 0

toctree中的菜单项在单击时会扩展/折叠,并且不会更改页面内容吗?

按照标题,是否可以有一个菜单项,其中整个项的作用类似于+/-,用于展开和折叠,并且不更改活动页面?有点像您已经在...

回答 1 投票 0

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