我在阅读sphinx文档页面时讽刺地发现关于var、ivar和cvar之间区别的文档非常缺乏。我想知道是否有人可以解释内联代码中每个不同namespace之间的区别。例子:classfoo(object):""":varstrfirst::ivarstrlast::cvarstrmiddle:"""这些sphinx标签之间的每一个有何不同，我如何知道哪一个是正确的，可以按设计正确使用？ 最佳答案 var当然是通用变量。当您不想对正在记录的变量做任何进一步区分时使用它。ivar是一个“实例变量”，或者说是在实例对象(类的实例)上设置的
我正在尝试在Sphinx(版本1.1.2-1)中的多行数学模式中做三件非常基本的事情。即使在数学模式下，也可以将下划线作为变量名的一部分；使用\big、\biggl等定界符组成大括号和圆括号；并将常规文本作为方程式的一部分。注意以下两点。(1)我在Sphinx标记文档的Python代码中使用原始字符串，因此转义字符不需要额外的反斜杠，并且(2)我没有使用内联数学模式，它在Sphinx中是这样分隔的::math:`Somemathstuffgoeshere`regulartextcouldgohere...相反，我正在做多行的东西，通常像LaTeX中的eqnarray:..math::D
我有以下文档字符串:defprogress_bar(progress,length=20):'''Returnsatextualprogressbar.>>>progress_bar(0.6)'[##########--------]':paramprogress:Numberbetween0and1describestheprogress.:typeprogress:float:paramlength:Thelengthoftheprogressbarinchars.Defaultis20.:typelength:int:rtype:string'''有没有办法告诉sphinx将“默
我只想在我的Sphinx文档中包含特定函数的文档字符串。然而，似乎没有选项可以使用http://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html仅显示这些细节而不关联类和函数定义。我已尝试创建一个类，如Show*only*docstringinSphinxdocumentation?中所述但我不确定这如何适应模板。我也尝试过autodoc-process-docstring事件处理程序，但没有成功。因此，而不是我的文档显示(如当前所示):classmodule.MyClass(param)Thisistheclassd
我有一个使用epydoc记录的项目。现在我正在尝试切换到狮身人面像。我为epydocs格式化了我所有的文档字符串，使用B{}、L{}等来加粗、链接等，并使用@param、@return、@raise等来解释输入、输出、异常等。所以现在我改用sphinx，它失去了所有这些功能。是否有一种自动方法可以将针对epydocs格式化的文档字符串转换为针对sphinx格式化的文档字符串？ 最佳答案 为了扩展KevinHorn的回答，可以在autodoc-process-docstring触发的事件处理程序中即时翻译文档字符串。事件。下面是一个小
我正在为我的Python模块(使用Sphinx和reST)编写文档，我发现当交叉引用其他Python对象(模块、类、函数等)时，完整的对象名称最终变得令人难以置信长。它通常超过80个字符，我想不惜一切代价避免这种情况。这是一个例子:defexampleFunction():'''Hereisanexampledocstringreferencinganother:class:`module1.module2.module3.module4.module5.ReallyLongExampleClassName`'''问题是，在为ReallyLongExampleClassName类创建文
我正在用Python编写一些数学代码并使用Sphinx生成文档。我知道Sphinx可以处理Python文档字符串中的LaTeX代码；见https://www.sphinx-doc.org/en/master/usage/extensions/math.html#module-sphinx.ext.mathbase.如何创建LaTeX宏，例如\newcommand{\cG}{\mathcal{G}}，以在Python文档字符串中使用？ 最佳答案 如果您使用MathJax，这里有一个可能的解决方案。我仍在寻找更好的解决方案，但如果您需要
这是我们安装Sphinx的过程。>chocoinstallpython-y-f>pipinstallsphinx我们知道sphinx安装是因为以下输出。>pipshowsphinx---Metadata-Version:2.0Name:SphinxVersion:1.4.3Summary:PythondocumentationgeneratorHome-page:http://sphinx-doc.org/Author:GeorgBrandlAuthor-email:georg@python.orgLicense:BSDLocation:c:\programdata\chocolate
我们有一个Sphinx配置，可以为我们的整个代码库生成大量HTML文档。有时，我正在处理一个文件，我只想查看该文件的HTML输出，以确保语法正确，而无需运行整个套件。我寻找可以在终端中运行的最简单的命令来在这个文件上运行sphinx，我确信信息在那里，但我没有看到它。 最佳答案 Sphinx处理reST文件(不是直接处理Python文件)。这些文件可能包含对Python模块的引用(当您使用autodoc时)。我的经验是，如果自上次完整输出构建以来仅修改了一个Python模块，Sphinx不会重新生成所有内容；仅处理“引入”该特定Py
我目前正在用autodoc记录整个模块.但是，我在模块级别定义了几个包含长列表或字典的变量。它们与值一起包含在文档中，并且值未格式化，因此看起来像10行乱七八糟的东西。我想要的是包含这些变量的文档字符串，但省略值或至少格式化得很好。我试图从automodule指令中排除变量并像这样添加它:..automodule::foo.bar:members::exclude-members:longstuff..py:data::longstuff这导致仅包含变量名称，而文档字符串和longstuff的值均未出现在文档中。我怎样才能在保留文档字符串的同时删除值(或将其格式化)？
