草庐IT

build_sphinx

全部标签

python - 官方 AnacondaRecipes/opencv-feedstock 的 conda-build 无法查找 libpng.h

我已经下载了opencvinAnacondaRecipes的官方condarecipe|.我试图构建这个包执行:conda-buildrecipe-cconda-forge在执行[72%]Builttargetopencv_dnn时,配方编译opencv时出现以下错误。错误如下:[67%]BuildingCXXobjectmodules/imgcodecs/CMakeFiles/opencv_imgcodecs.dir/src/grfmt_png.cpp.o/opt/conda/conda-bld/opencv_1521187259162/work/modules/imgcodecs/

python - 是否可以在 Sphinx 中隐藏 Python 函数参数?

假设我有以下记录在Numpydocstyle中的函数,并且文档是使用Sphinx自动生成的autofunctiondirective:deffoo(x,y,_hidden_argument=None):"""Fooabar.Parameters----------x:strThefirstargumenttofoo.y:strThesecondargumenttofoo.Returns-------Thebarredfoo."""if_hidden_argument:_end_users_shouldnt_call_this_function(x,y)returnx+y我不想将隐藏参数

python - 是否可以在 Sphinx 中隐藏 Python 函数参数?

假设我有以下记录在Numpydocstyle中的函数,并且文档是使用Sphinx自动生成的autofunctiondirective:deffoo(x,y,_hidden_argument=None):"""Fooabar.Parameters----------x:strThefirstargumenttofoo.y:strThesecondargumenttofoo.Returns-------Thebarredfoo."""if_hidden_argument:_end_users_shouldnt_call_this_function(x,y)returnx+y我不想将隐藏参数

python - 如何在 Sphinx 中创建自定义指令

我目前正在记录用Python编写的restAPI。该项目的所有文档都是使用Sphinx创建的,对于RESTAPI,我想创建一些特殊指令。例如,假设我定义了这个资源:@resource("/user/",method="GET")defuser_details(email):"""Returnsdetailedinformationaboutauseraccount.:resourceGET:/user/:query_parama_param:Somekindofqueryparam."""#Dostuffandreturnuserdetails这基本上就是文档当前的样子。我希望能够为S

python - 如何在 Sphinx 中创建自定义指令

我目前正在记录用Python编写的restAPI。该项目的所有文档都是使用Sphinx创建的,对于RESTAPI,我想创建一些特殊指令。例如,假设我定义了这个资源:@resource("/user/",method="GET")defuser_details(email):"""Returnsdetailedinformationaboutauseraccount.:resourceGET:/user/:query_parama_param:Somekindofqueryparam."""#Dostuffandreturnuserdetails这基本上就是文档当前的样子。我希望能够为S

python - 为 `sphinx-apidoc` 自定义模板

我最近尝试使用sphinx-apidoc来自Sphinx帮助从Python项目的API生成Sphinx特定的reStructuredText。但是,我得到的结果是:有人知道我是否可以自定义sphinx-api用于输出的模板吗?具体来说,我想:删除所有“子模块”、“子包”和“模块内容”标题,以及让我的__init__.py文件中的docstring的结果直接显示在包下面,这样如果我单击包名称,我首先看到的是包文档。目前,该文档位于每个包部分末尾的稍微奇怪的“模块内容”标题下。我认为“子模块”和“子包”标题是多余的,因为包/模块的正常标题是“xxx.yyy包”和“xxx.yyy.zzz模块

python - 为 `sphinx-apidoc` 自定义模板

我最近尝试使用sphinx-apidoc来自Sphinx帮助从Python项目的API生成Sphinx特定的reStructuredText。但是,我得到的结果是:有人知道我是否可以自定义sphinx-api用于输出的模板吗?具体来说,我想:删除所有“子模块”、“子包”和“模块内容”标题,以及让我的__init__.py文件中的docstring的结果直接显示在包下面,这样如果我单击包名称,我首先看到的是包文档。目前,该文档位于每个包部分末尾的稍微奇怪的“模块内容”标题下。我认为“子模块”和“子包”标题是多余的,因为包/模块的正常标题是“xxx.yyy包”和“xxx.yyy.zzz模块

如何解决 Microsoft Visual C++ 14.0 or greater is required. Get it with “Microsoft C++ Build Tools“

序言在安装、构建python库fasttext时,产生了一下报错日志。为此记录一下解决这个问题的过程:MicrosoftVisualC++14.0orgreaterisrequired.Getitwith“MicrosoftC++BuildTools”:https://visualstudio.microsoft.com/visual-cpp-build-tools/1.下载MicrosoftC++BuildTools打开网址:https://visualstudio.microsoft.com/visual-cpp-build-tools/点击下载【下载生成工具】,并打开。接着在Worklo

python - Sphinx 和 Docstrings 中的 reStructuredText : single vs. 双反引号或反引号差异

从文档来看,双反引号似乎用于文字,而当有代码文本要解释时使用单反引号。这将引导我为下面的方法f()编写文档字符串:classA(B):deff(arg1,arg2):returnB(arg1+arg2+self.index)作为:Takestwoarguments,``arg1`and``arg2``,whichareassumedtobeobjectsoftype(orduck-type)`NiceClass`,andreturnsanewobjectofclass`B`with`B.something`assignedsomehashof``arg1``and``arg2``.这对

python - Sphinx 和 Docstrings 中的 reStructuredText : single vs. 双反引号或反引号差异

从文档来看,双反引号似乎用于文字,而当有代码文本要解释时使用单反引号。这将引导我为下面的方法f()编写文档字符串:classA(B):deff(arg1,arg2):returnB(arg1+arg2+self.index)作为:Takestwoarguments,``arg1`and``arg2``,whichareassumedtobeobjectsoftype(orduck-type)`NiceClass`,andreturnsanewobjectofclass`B`with`B.something`assignedsomehashof``arg1``and``arg2``.这对