reStructuredText中的链接图像

Question

如何使用reStructuredText创建链接图像？

我发现

.. image:: /path/to/image.jpg 

的图像，以及外部链接像

'Python <http://www.python.org/>'_ 

的链接，但我不知道如何把它们结合在一起，或者说是在所有可能的。

Answer 1

两种方式做到这一点：

1. 在内嵌图像

   ：

   .. image:: pageflip-200.png 
       :target: pageapplet/index.html 
   

2. 与参考，如：

   Click on my |ImageLink|_ 
   
   .. |ImageLink| image:: /images/link.png 
   .. _ImageLink: http://link.url/ 
   

Answer 2

以下网站有reStructuredText参考，还有Markdown，MediaWiki ，asciidoc &组织模式。

http://hyperpolyglot.org/lightweight-markup