python-sphinx 相关问题

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

Python MagicMock在使用装饰器时嘲弄太多

我试图通过Sphinx获取基于ReadTheDocs安装的文档。我正在记录的类继承自一个更大的框架,我无法轻松安装,因此希望......

回答 1 投票 0

如何在Windows中使用Sphinx创建PDF文档

我正在使用Sphinx为我在Windows中的Python项目创建文档。我需要生成PDF文档。我在Linux中找到了很多解释如何做到这一点,但没有很好的解释如何做...

回答 3 投票 12

使用restructuredText网格表设置列宽

我在rST中有以下网格表。我想控制HTML输出的列宽,以便Field类型占表宽度的20%,Description占30%,Example占50%。 ...

回答 1 投票 4

如何使用sphinx autodoc停止出现“索引”和“Python模块索引”?

我正在使用sphinx autodoc来检索类和模块文档字符串。当我使用autodoc时,sphinx会自动生成一个名为Python Module Index的丑陋页面。如果我......我只能禁用此页面

回答 1 投票 2

递归使用Sphinx autosummary生成API文档

我想使用Sphinx的autosummary扩展和模板从docstrings递归生成API文档。我想为每个模块,类,方法,属性和功能分别设置页面。但它不......

回答 1 投票 8

从版本1.5.2降级Sphinx。到版本1.4.9

升级到1.5.1版后,我的Sphinx文档中的搜索功能已停止工作。我正在使用sphinx_rtd_theme。如何将Sphinx降级到1.4.9?

回答 1 投票 -1

从外部文件中获取价值

我有一个名为version.h的文件,其中包含以下行:#define VERSION 0.4.2-b现在,在这个软件的Sphinx文档中,我想显示这个......

回答 1 投票 0

如何在Sphinx处理的文档字符串中为单个参数或返回值表示多个类型?

有时Python中的函数可能接受灵活类型的参数。或者它可以返回灵活类型的值。现在我不记得现在这样一个功能的好例子,因此我...

回答 1 投票 22

sphinx严重:意外的部分标题 - 函数docstring中的任意标题

使用autodoc和类似工具可以从源文档字符串编译文档。但是,它似乎不允许函数或类docstrings中的任意ReST部分标题,并且......

回答 1 投票 10

在Windows上安装python / sphinx环境?

我们在Linux / OSX python环境中使用Sphinx作为文档,但我们在Windows上有人希望能够获得一个可以编辑和构建Sphinx的环境......

回答 3 投票 9

在sphinx中更新docstring

我正在努力为dask项目的文档做出贡献。我想按照本期的建议添加pandas参考。我能够在我的开发者机器上重建文档 - 但我......

回答 1 投票 1

如何为namedtuple(使用autodoc)提供Sphinx文档?

我正在尝试使用Sphinx记录Python项目,但是我在将autodoc扩展与namedtuple生成的类组合时遇到了麻烦。在一个文件gammatone.rst中,我有:: mod:`...

回答 3 投票 12

在gh-pages上托管的sphinx html中的散景图JS路径

我试图在RST文件中使用散景图扩展使用散景图扩展来在gh-pages上托管一些基于sphinx的文档。我能够提供生成的HTML和...

回答 1 投票 0

autodoc:基类以全名显示,而不是尊重导入

我希望我能找到解决这个非常复杂问题的解决方案。我使用sphinx和intersphinx来记录我的项目。我有一个继承自mongoengine.Document的类。当我构建sphinx文档时......

回答 1 投票 0

如何使用sphinx生成sitemap.xml文件?

这里它说:“特殊条目名称self代表包含toctree指令的文档。如果你想从toctree生成一个”站点地图“,这很有用。”我一直在看......

回答 1 投票 4

是否可以将sphinx预生成的html文档上传到ReadTheDocs网站?

我有一个使用plot-directive的python-3项目,但ReadTheDocs目前不支持这个项目。因此,我想生成并上传文件,就像我通常使用PyPi一样...

回答 1 投票 18

Sphinx matlab文档错误:缺少模块'std'

我正在尝试使用sphinx记录我的MATLAB类。但每当我想运行make html时,我都会收到以下错误:%make html sphinx-build -b html -d _build / doctrees。 _build / html正在运行...

回答 2 投票 3

我如何在Sphinx中模拟wxPython?

我使用wx-python v4.0.0b2(Phoenix)创建了一个项目,我正在尝试使用Sphinx来记录它。我有一个目录结构如下:app / | ---- models / | | ----__ init__.py | ...

回答 1 投票 1

在使用Sphinx文档时,我应该告诉VCS忽略哪些文件? [关闭]

我想开始使用Sphinx记录我的项目。我告诉Sphinx在sphinx-quickstart期间使用单独的源代码和构建目录。现在我的目录布局如下:MyProject / ...

回答 2 投票 18

如何在reStructuredText中创建嵌套列表?

我正在尝试使用以下代码创建一个正确的嵌套列表(遵循Sphinx和docutils文档):1。X a。你b。 V c。 W 2. Y 3. Z我希望这会产生两个OL,但我得到......

回答 2 投票 71

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