- c - 在位数组中找到第一个零
- linux - Unix 显示有关匹配两种模式之一的文件的信息
- 正则表达式替换多个文件
- linux - 隐藏来自 xtrace 的命令
我启用了sphinx.ext.intersphinx
在我的项目中并添加了以下配置:
intersphinx_mapping = {
'python': ('https://docs.python.org/3', None),
'pyserial': ('https://pythonhosted.org/pyserial/', None),
}
我的 index.rst
中有以下内容:
This project depends on the :ref:`pyserial <pyserial:???>` library.
我希望链接指向 http://pythonhosted.org/pyserial/
, intersphinx_mapping
中的根 URL , 但我不知道是什么 ???
应该是。
如果我这样做 :ref:`pyserial`
或 :ref:`pyserial <pyserial>`
, 我得到 WARNING: undefined label: pyserial (if the link has no caption the label must precede a section header)
如果我这样做 :ref:`pyserial <>`
我得到 WARNING: undefined label: (if the link has no caption the label must precede a section header)
我可以替换 :ref:
与 `pyserial <<a href="http://pythonhosted.org/pyserial/>%60_" rel="noreferrer noopener nofollow">http://pythonhosted.org/pyserial/>`_</a>
,但我真的很想通过 intersphinx 引用该页面,以避免链接断开。
我在 Anaconda 的 Python 3.6.2 上使用 sphinx 1.6.3。我并不过分依赖我试图链接到的库。我怀疑答案不会真正与图书馆联系在一起。
如果有任何问题,对 pyserial 文档的常规引用工作得很好。例如:py:class:`serial.Serial`
链接到 https://pythonhosted.org/pyserial/pyserial_api.html#serial.Serial .
最佳答案
您已经满足以下要求。这是最后一项令人沮丧的常见原因。
配置要使用的项目intersphinx .
远程文档使用 Sphinx,并且实际上有一个名为 objects.inv
的 list 文件。运行 sphinx-build
时,日志条目应该是这样的:
loading intersphinx inventory from https://docs.python.org/3/objects.inv...
loading intersphinx inventory from https://pythonhosted.org/pyserial/objects.inv...
使用 intersphinx 的 Python 项目的语法如下,就像任何 cross-referencing link 一样:
:role_name:`title <target>`
所以在你的情况下:
:ref:`pyserial <pyserial:reference-label-name>`
最后,给定页面的 list 中可能不存在一些所需的目标。 This answer shows how to see all intersphinx targets ,使用以下内容:
python -m sphinx.ext.intersphinx 'https://pythonhosted.org/pyserial/objects.inv'
出现了所有 API 对象,这就是为什么您可以链接到这些对象,但只出现了有限数量的其他对象:
std:label
examples Examples : examples.html#examples
genindex Index : genindex.html#
miniterm serial.tools.miniterm : tools.html#miniterm
modindex Module Index : py-modindex.html#
search Search Page : search.html#
urls URL Handlers : url_handlers.html#urls
缺少任意标签是作者的常见烦恼。
您也可以check the project's reST source for targets在这种情况下,没有像 .. _my-reference-label:
.
要解决此问题,您可以使用任意目标之一:
:ref:`pyserial <pyserial:genindex>`
...或者更好的是向您至少为索引页面提供标签的项目提交拉取请求,等待其接受,然后将其用于 intersphinx 链接。其他作者会很感激。
关于python - 如何链接到 intersphinx 中的根页面,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/45699577/
我想做的是让 JTextPane 在 JPanel 中占用尽可能多的空间。对于我使用的 UpdateInfoPanel: public class UpdateInfoPanel extends JP
我在 JPanel 中有一个 JTextArea,我想将其与 JScrollPane 一起使用。我正在使用 GridBagLayout。当我运行它时,框架似乎为 JScrollPane 腾出了空间,但
我想在 xcode 中实现以下功能。 我有一个 View Controller 。在这个 UIViewController 中,我有一个 UITabBar。它们下面是一个 UIView。将 UITab
有谁知道Firebird 2.5有没有类似于SQL中“STUFF”函数的功能? 我有一个包含父用户记录的表,另一个表包含与父相关的子用户记录。我希望能够提取用户拥有的“ROLES”的逗号分隔字符串,而
我想使用 JSON 作为 mirth channel 的输入和输出,例如详细信息保存在数据库中或创建 HL7 消息。 简而言之,输入为 JSON 解析它并输出为任何格式。 最佳答案 var objec
通常我会使用 R 并执行 merge.by,但这个文件似乎太大了,部门中的任何一台计算机都无法处理它! (任何从事遗传学工作的人的附加信息)本质上,插补似乎删除了 snp ID 的 rs 数字,我只剩
我有一个以前可能被问过的问题,但我很难找到正确的描述。我希望有人能帮助我。 在下面的代码中,我设置了varprice,我想添加javascript变量accu_id以通过rails在我的数据库中查找记
我有一个简单的 SVG 文件,在 Firefox 中可以正常查看 - 它的一些包装文本使用 foreignObject 包含一些 HTML - 文本包装在 div 中:
所以我正在为学校编写一个 Ruby 程序,如果某个值是 1 或 3,则将 bool 值更改为 true,如果是 0 或 2,则更改为 false。由于我有 Java 背景,所以我认为这段代码应该有效:
我做了什么: 我在这些账户之间创建了 VPC 对等连接 互联网网关也连接到每个 VPC 还配置了路由表(以允许来自双方的流量) 情况1: 当这两个 VPC 在同一个账户中时,我成功测试了从另一个 La
我有一个名为 contacts 的表: user_id contact_id 10294 10295 10294 10293 10293 10294 102
我正在使用 Magento 中的新模板。为避免重复代码,我想为每个产品预览使用相同的子模板。 特别是我做了这样一个展示: $products = Mage::getModel('catalog/pro
“for”是否总是检查协议(protocol)中定义的每个函数中第一个参数的类型? 编辑(改写): 当协议(protocol)方法只有一个参数时,根据该单个参数的类型(直接或任意)找到实现。当协议(p
我想从我的 PHP 代码中调用 JavaScript 函数。我通过使用以下方法实现了这一点: echo ' drawChart($id); '; 这工作正常,但我想从我的 PHP 代码中获取数据,我使
这个问题已经有答案了: Event binding on dynamically created elements? (23 个回答) 已关闭 5 年前。 我有一个动态表单,我想在其中附加一些其他 h
我正在尝试找到一种解决方案,以在 componentDidMount 中的映射项上使用 setState。 我正在使用 GraphQL连同 Gatsby返回许多 data 项目,但要求在特定的 pat
我在 ScrollView 中有一个 View 。只要用户按住该 View ,我想每 80 毫秒调用一次方法。这是我已经实现的: final Runnable vibrate = new Runnab
我用 jni 开发了一个 android 应用程序。我在 GetStringUTFChars 的 dvmDecodeIndirectRef 中得到了一个 dvmabort。我只中止了一次。 为什么会这
当我到达我的 Activity 时,我调用 FragmentPagerAdapter 来处理我的不同选项卡。在我的一个选项卡中,我想显示一个 RecyclerView,但他从未出现过,有了断点,我看到
当我按下 Activity 中的按钮时,会弹出一个 DialogFragment。在对话框 fragment 中,有一个看起来像普通 ListView 的 RecyclerView。 我想要的行为是当
我是一名优秀的程序员,十分优秀!