restructuredtext - 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