Sphinx将代码格式添加到:ref：

Question

我想将代码格式添加到如下引用中：

:ref:`__slots__ <python:slots>`

我的intersphinx_mapping像这样定义了python：

intersphinx_mapping = {
    'python': ('https://docs.python.org/3', None),
}

所以链接是指向https://docs.python.org/3/reference/datamodel.html#slots (slots是在https://docs.python.org/3/objects.inv的std:label部分中定义的)

我的目标是将呈现的链接格式化为:py:attr:或类似的样式，而不是:ref:呈现的默认文本样式。

下列任何选项都不起作用：

• ... ``:ref:`__slots__ <python:slots>``` ...酵母菌的输出 . :ref:`__slots__ <python:slots>` .
• ... ``:ref:`__slots__ <python:slots>` `` ...酵母菌的输出 . _ .
• ... :ref:```__slots__`` <python:slots>` ...酵母菌的输出 参考文献： ` .

在本例中，有两个单独的到#id1的内部链接。

• ... :ref:` ``__slots__`` <python:slots>` ...酵母菌的输出 参考文献：[``](http://#id1)\_\_slots\_\_`` <python:slots> ..。

将``...``与:code:`...`或:literal:`...`放在:ref:内部或外部都没有任何帮助。事实上，似乎根本不允许嵌套角色。

我希望有一个内联角色，它会产生一些代码样式和链接呈现的内容，如

. __slots__ .

如何使基本的:ref: (或等效的)以:py:attr:使用的代码样式格式出现。

我在Anaconda环境中使用Sphinx1.6.3和Python3.6.2。

反问题在这里：Sphinx从自定义代码引用中删除代码格式设置

一个切线相关的问题：嵌套/复合角色:将多个角色应用于重叠文本

Answer 1

:any:角色可以做您想做的事情：

:any:`__slots__ <python:slots>`

这是一个“方便角色”，它查找当前域中的交叉引用目标以及与:ref:一起工作的目标。

Python域有几个特定的交叉参照角色，用于不同类型的对象。