2014-09-23 72 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