草庐IT

SPHINX_PATH

全部标签

python - os.path.basename 与 URL 一起使用,为什么?

>>>os.path.basename('http://example.com/file.txt')'file.txt'..我认为os.path.*仅适用于本地路径而不适用于URL?请注意,上面的示例也在Windows上运行......结果相似。 最佳答案 在实践中,os.path的许多函数只是字符串操作函数(它们碰巧对路径操作特别方便)——因为这是无害的,偶尔方便,虽然正式地说“不正确”,但我怀疑这会很快改变——有关更多详细信息,请在shell/命令提示符下使用以下简单的单行代码:$python-c"importsys;impor

Python os.path.walk() 方法

我目前在uni作业中使用walk方法。一切正常,但我希望有人能向我解释一些事情。在下面的示例中,myvisit方法中使用的a参数是什么?>>>fromos.pathimportwalk>>>defmyvisit(a,dir,files):...printdir,":%dfiles"%len(files)>>>walk('/etc',myvisit,None)/etc:193files/etc/default:12files/etc/cron.d:6files/etc/rc.d:6files/etc/rc.d/rc0.d:18files/etc/rc.d/rc1.d:27files/et

python - window : Z3Exception ("init(Z3_LIBRARY_PATH) must be invoked before using Z3-python")

在使用使用Z3(我在VisualStudio命令提示符中构建)的python脚本(oyente)时,我遇到了以下错误:File"C:\Python27\Lib\site-packages\oyente\z3\z3core.py",line23,inlibraiseZ3Exception("init(Z3_LIBRARY_PATH)mustbeinvokedbeforeusingZ3-python")z3.z3types.Z3Exception:init(Z3_LIBRARY_PATH)mustbeinvokedbeforeusingZ3-pythonExceptionAttribute

python - 使用 toctree 时防止在 Python Sphinx 中嵌套子部分

我在构建我的Sphinx用户指南时遇到了问题。我想通过一个包含章节标题和概述的主登录页面(index.rst)来形成一个章节,然后将不同的子部分包含在不同的文件(part1.rst,part2.rst)中。我正在尝试使用“toctree”来插入单独的小节,但我遇到了一个嵌套问题,我的toctree被吸进了我的概述部分。(注意:我没有使用..include::指令,因为我希望显示在不同网页上的子部分按顺序链接。我还希望结构正确,以便它们在pdf中很好地布局UG的渲染版本)。index.rstChapter3===============================Overview--

python - 在 Sphinx 中自动为 autodoc 类创建目录树

我希望增加我的一个库中的文档。我一直在使用sphinx来帮助构建文档,最近开始探索autodoc扩展。似乎在大多数专业文档中,每个类文档页面都有一个所有文档化方法的列表,顶部有链接。或者,换句话说,顶部的目录树带有指向每个更深入的方法文档的超链接。有没有办法为使用autodoc记录的每个类自动创建此toctree? 最佳答案 在你的conf.py文件中为sphinx添加extensions=['sphinx.ext.autosummary',]#NOTE:Don'toverwriteyouroldextensionlist!Just

Python sphinx 自动摘要错误

我有一个sphinx文档,当我包含以下几行时:..currentmodule::myMod..autosummary::MyClass出现以下错误ERROR:Unknowndirectivetype"autosummary".然而,autosummary从0.6版本开始可用,我使用Sphinx1.1.3。什么可能导致问题?谢谢!编辑:为了更清楚一点,我说的是python-sphinx,文档工具。 最佳答案 sphinx.ext.autosummary是Sphinxextension.为了使用扩展,您必须将其名称添加到extensio

python - 写入文件后,为什么 os.path.getsize 仍然返回之前的大小?

Iamtryingtosplitupalargexmlfileintosmallerchunks.我写入输出文件,然后检查它的大小以查看它是否超过阈值,但我认为getsize()方法没有按预期工作。Whatwouldbeagoodwaytogetthefilesizeofafilethatischanginginsize.Ivedonesomethinglikethis...importstringimportosf1=open('VSERVICE.xml','r')f2=open('split.xml','w')forlineinf1:ifstr(line)=='\n':breake

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