狮身人面像添加代码格式化到：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部分）

我的目标是格式化re以:py:attr:或类似的样式而不是由:ref:呈现的默认文本样式来确定链接。

无下列选项工作：

• ... ``:ref:`__slots__ <python:slots>``` ... yeilds像

  ... :ref:`__slots__ <python:slots>`输出...

• ... ``:ref:`__slots__ <python:slots>` `` ... yeilds输出像

  ... __slots__ ...

• ... :ref:```__slots__`` <python:slots>` ... yeilds像

  输出...：REF：```__slots__`` <蟒：槽>`...

  在这种情况下，有两个单独的内部链接到#id1。

• ... :ref:` ``__slots__`` <python:slots>` ... yeilds像

  输出...：REF：``` __slots__`` <蟒：槽>`...

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

我想有导致一些与代码风格和链接使得内嵌的角色，像

... __slots__ ...

如何获得基本:ref:（或等效）与:py:attr:使用的代码样式格式一起出现？

我在Anaconda环境中使用Sphinx 1.6.3和Python 3.6.2。

逆问题就在这里：Sphinx remove code formatting from custom code reference

切向相关的问题：Nested/Compounded roles: apply multiple roles to overlapping text

Answer 1

的:any:角色你想要做什么：

:any:`__slots__ <python:slots>` 

这是一种 “便民作用”，看起来交叉在当前域中的引用目标以及与:ref:一起使用的目标。

对于不同类型的对象，Python域有几个specific cross-reference roles。