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和org-mode。

http://hyperpolyglot.org/lightweight-markup