草庐IT

sphinx-build

全部标签

python - 在安装期间运行自定义 setuptools build

我尝试在setuptools的build期间实现Compass编译,但以下代码在显式build命令期间运行编译,而在install期间不运行。#!/usr/bin/envpythonimportosimportsetuptoolsfromdistutils.command.buildimportbuildSETUP_DIR=os.path.dirname(os.path.abspath(__file__))classBuildCSS(setuptools.Command):description='buildCSSfromSCSS'user_options=[]definitializ

Python 生成错误 : failed to build modules _ssl and _hashlib

我通过将源代码安装到我的RHEL4盒子中来添加python2.7.13作为altinstallwget--no-check-certificatehttps://www.python.org/ftp/python/2.7.13/Python-2.7.13.tar.xztar-xvzfPython2.7.13.tar.xzcdPython2.7.13./configure--with-ensurepip=installmakemaketestmakealtinstall这样我就不会覆盖其他用途所需的默认python。Python2.7.13将成功安装,但缺少我正在处理的项目的几个基本模块

python - 为什么要在扩建内部 build 监督员?

我见过构建supervisor的构建方法进入扩建,我想控制里面的守护进程。但是,在我看来,仍然需要/etc/init.d中的某些内容(例如)才能在启动时运行所述主管实例。那么,为什么要在buildout中构建supervisor?为什么不在系统范围内安装它,而只是为其中涉及的守护进程制作一个配置文件? 最佳答案 当我们为客户创建扩展时,我们希望该扩展能够在具有最小依赖性的任意托管环境上运行,所有这些都可以通过系统包来满足。通过在构建中包含supervisord,我们无需在系统范围内安装它,并且可以精细地调整它的参数,而无需要求系统管

python - 在 Sphinx 文档中包含文档字符串

我只想在我的Sphinx文档中包含特定函数的文档字符串。然而,似乎没有选项可以使用http://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html仅显示这些细节而不关联类和函数定义。我已尝试创建一个类,如Show*only*docstringinSphinxdocumentation?中所述但我不确定这如何适应模板。我也尝试过autodoc-process-docstring事件处理程序,但没有成功。因此,而不是我的文档显示(如当前所示):classmodule.MyClass(param)Thisistheclassd

python - 从 epydoc 的文档字符串格式切换到 sphinx 文档字符串格式的自动方式?

我有一个使用epydoc记录的项目。现在我正在尝试切换到狮身人面像。我为epydocs格式化了我所有的文档字符串,使用B{}、L{}等来加粗、链接等,并使用@param、@return、@raise等来解释输入、输出、异常等。所以现在我改用sphinx,它失去了所有这些功能。是否有一种自动方法可以将针对epydocs格式化的文档字符串转换为针对sphinx格式化的文档字符串? 最佳答案 为了扩展KevinHorn的回答,可以在autodoc-process-docstring触发的事件处理程序中即时翻译文档字符串。事件。下面是一个小

python - 使用 Python Sphinx 引用长名称

我正在为我的Python模块(使用Sphinx和reST)编写文档,我发现当交叉引用其他Python对象(模块、类、函数等)时,完整的对象名称最终变得令人难以置信长。它通常超过80个字符,我想不惜一切代价避免这种情况。这是一个例子:defexampleFunction():'''Hereisanexampledocstringreferencinganother:class:`module1.module2.module3.module4.module5.ReallyLongExampleClassName`'''问题是,在为ReallyLongExampleClassName类创建文

android - 为什么一个 Android Studio 项目中有两个 build.gradle 文件?

将Eclipse项目导入AndroidStudio后,我看到两个build.gradle文件:1-\build.gradle2-\app\build.gradle第一个版本较短,第二个版本包含compileSdkVersion等的定义。拥有两个独立文件的目的是什么?是否有单独的构建任务? 最佳答案 \app\build.gradle特定于应用模块。\build.gradle是一个“顶级构建文件”,您可以在其中添加所有子项目/模块通用的配置选项。如果您在项目中使用另一个模块,作为本地库,您将拥有另一个build.gradle文件:\m

android - 为什么一个 Android Studio 项目中有两个 build.gradle 文件?

将Eclipse项目导入AndroidStudio后,我看到两个build.gradle文件:1-\build.gradle2-\app\build.gradle第一个版本较短,第二个版本包含compileSdkVersion等的定义。拥有两个独立文件的目的是什么?是否有单独的构建任务? 最佳答案 \app\build.gradle特定于应用模块。\build.gradle是一个“顶级构建文件”,您可以在其中添加所有子项目/模块通用的配置选项。如果您在项目中使用另一个模块,作为本地库,您将拥有另一个build.gradle文件:\m

python - 在 Sphinx 中创建 LaTeX 数学宏

我正在用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,这里有一个可能的解决方案。我仍在寻找更好的解决方案,但如果您需要

python - 找不到 'sphinx-build' 命令。

这是我们安装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