如何選擇文本在與獅身人面像交叉引用中使用？

Question

使用sphinx，我使用下面的語法包含一個圖。

.. _struct_NiO: 

.. figure:: img/NiO.png 
    :align: center 
    :width: 400px 

    long long very long caption ... 

在文本的另一部分我爲了做到圖中的交叉引用使用

See figure :ref:`struct_NiO` bla bla bla 

。這項工作，但輸出看起來像：

看到圖「長長的非常長的標題......」bla bla bla。

這是獅身人面像的正常行爲，但如果你有一個數字有點複雜的3或4行標題它沒有真正適應。

是否可以選擇交叉引用中使用的文本？

Answer 1

可以爲:ref:目標提供自定義鏈接文本，像這樣：

See figure :ref:`Link text <struct_NiO>` bla bla bla 

見http://sphinx-doc.org/markup/inline.html#role-ref。