这个问题在这里已经有了答案:Addingacross-referencetoasubheadingoranchorinanotherpage(6个回答)关闭去年。如何在Sphinx文档中创建内部超链接？我正在使用::role:`target`但它不起作用。 最佳答案 交叉引用是使用ref:ref:`label-name`您可以使用以下方式提供标签:.._label-name:见:https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#role-re
我正在尝试使用Sphinx来记录我的Python类。我使用自动文档这样做:..autoclass::Bus:members:虽然它正确地为我的方法获取文档字符串，但那些被修饰的方法:@checkStaledefopen(self):"""Somedocs."""#Code@checkStale存在defcheckStale(f):@wraps(f)defnewf(self,*args,**kwargs):ifself._stale:raiseExceptionreturnf(self,*args,**kwargs)returnnewf有一个不正确的原型(prototype)，例如ope
我正在构建一个Python包，并使用Sphinx创建文档。除了我的包代码之外，我还包含了许多使用argparse的命令行Python脚本。我想知道是否有办法让Sphinx自动记录这些脚本？最终目标将是一个pretty-print的脚本列表，以及相关的帮助打印、参数和选项。需要明确的是，我正在寻找一种预先存在的方法来执行此操作，而不是自己实现此操作的方法。这并不像我通常在S.O.上问的那样具体，如果有更合适的S.E.发布此问题的网站，请告诉我。 最佳答案 使用sphinx-argparse扩展:http://sphinx-argpar
我尝试使用nbsphinx嵌入一个包含绘图的Jupyter笔记本，但这些绘图没有显示在文档中，即使它们在Jupyter笔记本上看起来不错。如何在Sphinx中嵌入绘图图documentation?我可以将它们包含为图像，但有更好的方法吗？有互动就好了!我想做的是复制thispage.它具有Jupyter笔记本风格的进出block，并显示使用plotly制作的交互式绘图。我该怎么做？GitHub问题提出here. 最佳答案 我可以看到两种解决方案，可以在sphinx文档中嵌入带有plotly图形的笔记本单元格。使用nbconvert或
如何将本地目录包含到Sphinx文档中？我试过了..toc::但这似乎没有任何效果:文档中没有插入任何内容。基本上，我需要将指向当前页面中各个部分的链接放置在每个页面的特定位置。这可能吗？ 最佳答案 我不能100%确定这是您要查找的内容，但..contents::指令可能会有所帮助。默认情况下，无论您将指令放在何处，它都会为您提供整个页面的标题。指定:local:后，它将为您放置指令的下面的标题生成一个本地TOC(对于小节目录很方便)。..contents::TableofContents:depth:3更多详情:http://do
就目前而言，这个问题不适合我们的问答形式。我们希望答案得到事实、引用资料或专业知识的支持，但这个问题可能会引发辩论、争论、投票或扩展讨论。如果您觉得这个问题可以改进并可能重新打开，visitthehelpcenter寻求指导。关闭9年前。Sphinx是一个新的Python文档工具。它看起来非常漂亮。我想知道的是:这对于记录C++项目有多合适？是否有任何工具可以将现有文档(例如doxygen)转换为Sphinx格式？是否有使用Sphinx的C++项目的在线/可下载示例？使用过Sphinx的人有什么建议吗？ 最佳答案 如前所述here和
我正在使用Sphinx来记录一个非Python项目。我想在每个子模块中分发./doc文件夹，其中包含submodule_name.rst文件以记录该模块。然后，我想将这些文件吸入主层次结构中，为整个设计创建规范。即:Projectdocsspecproject_spec.rstconf.pymodulesmodule1docsmodule1.rstsrcmodule2docsmodule2.rstsrc我试图在主project_spec.rst文档目录树中包含文件，如下所示:..toctree:::numbered::maxdepth:2Module1但是这个错误信息的结果:WARNI
默认情况下，Sphinx不会为__init__(self)生成文档。我尝试了以下方法:..automodule::mymodule:members:和..autoclass::MyClass:members:在conf.py中，设置以下内容仅将__init__(self)文档字符串附加到类文档字符串(theSphinxautodocdocumentation似乎同意这是预期的行为，但没有提及我要解决的问题):autoclass_content='both' 最佳答案 这里有三种选择:为确保始终记录__init__()，您可以使用au
在Eclipse中通过AndroidJUnit测试使用来自android-support-v7-appcompat的ActionBarActivity的应用程序时，我遇到了问题。在模拟器或设备中运行时，一切似乎都正常。我尝试使用模拟应用程序，如ActivityUnitTestCaseandstartActivitywithActionBarActivity并按照ActionBarCompat:java.lang.IllegalStateException:YouneedtouseaTheme.AppCompat中的建议更改了values-v11等中的父主题但是还是不行。Youneedt
就目前而言，这个问题不适合我们的问答形式。我们希望答案得到事实、引用资料或专业知识的支持，但这个问题可能会引发辩论、争论、投票或扩展讨论。如果您觉得这个问题可以改进并可能重新打开，visitthehelpcenter寻求指导。关闭10年前。我正在寻找具有以下属性的独立全文搜索服务器:必须作为独立服务器运行，可以为来自多个客户端的搜索请求提供服务必须能够通过索引SQL查询的结果来进行“批量索引”:比如“SELECTid,text_to_indexFROMdocuments;”必须是免费软件，并且必须在以MySQL作为数据库的Linux上运行必须快速(排除MySQL的内部全文搜索)我发现具
