2014-09-23 68 views
2

是否可以在文本中的任意位置添加一个锚(链接目标,我可以参考:ref:)?我有这样的情况:用sphinx/reStructuredText锚定在任意位置?

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也不是那么简单,因为这样就存在嵌套格式问题(我对每个术语使用了不同的样式,以表明可能存在各种我需要的情况) 。也许如果我可以将内联角色应用于某些空文本...

任何建议?

回答

0

我刚才已经回答了类似的问题在这里,希望这能解决你的问题:

Python Sphinx anchor on arbitrary line

总之,您可以使用ref作用:http://sphinx-doc.org/markup/inline.html#role-ref

具体读第二子弹点哪些地址如果引用未放在标题之前会发生什么情况。

+0

我的问题不在于编写参考,而是放置锚点,该锚点打破了列表或将锚点放在描述中,而不是项目本身。 ':term:'解决方案只适用于词汇表,显然(或者我怎么会在我的例子中使用它?) – Jellby 2015-06-23 11:46:46