是否使用狮身人面像/reStructiredText在任意位置锚定？ [英] Anchor in arbitrary position with sphinx/reStructuredText?

问题描述

是否可以在文本中的任意位置添加锚(链接目标，我可以用:ref:引用)？我的情况是这样的：

Some text

.. class:: mylist

**Term 1**
  Definition

*Term 2*
  Definition

:customrole:`Term 3` extra
  Definition

我想添加一个链接，比如Term 2。我不能简单地在块前面添加.. _target:，因为这会将列表一分为二，而第二部分没有获得mylist类(这是故意的还是可能是错误的？)。我可以这样写：

*Term 2*
  .. _target:

  Definition

但目标是定义段落，而不是Term 2元素本身。

将内联角色应用于Term 2也并不简单，因为还有嵌套格式的问题(我为每个术语使用了不同的样式，以表明我可能需要这样做的各种情况)。也许我可以将内联角色应用于一些空文本...

有什么建议吗？

推荐答案

我知道的唯一解决方案是将您的定义列表放入glossary directive 并将其条款与term role...

Some text

.. glossary::

  Term 1
    Definition

  Term 2
    Definition

A link to :term:`Term 1` or :term:`Term 2`

这篇关于是否使用狮身人面像/reStructiredText在任意位置锚定？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！