如何处理 reStructuredText 中重复的目标名称？

Question

例子：

foo is a tool used to do foo.

Download_

.. _Download: http://example.com/foo

blah blah blah (omit a lot of paragraphs)

bar is another tool to do bar.

Download_

.. _Download: http://example.com/bar

由于Download指向不同的url，docutilus给出了这个错误报告：

Duplicate target name, cannot be used as a
unique reference: "Download".

在markdown中，我可以为这两个Download指定不同的id：

[Download][download-foo]
[download-foo]: http://example.com/foo
[Download][download-bar]
[download-bar]: http://example.com/bar

如何在 reStructuredText 中做类似的事情？

Answer 1

选项一

正如@mzjn 指出的，让目标名称更清晰：

`Download foo`_

.. _Download foo: http://example.com/foo

`Download bar`_

.. _Download bar: http://example.com/bar

选项二

来自docutils-user maillist：

使用匿名超链接：

Download__


__ http://example.com/foo


Download__

__ http://example.com/bar

Answer 2

据我从the documentation 得知，ReST 文档中的引用名称共享一个公共命名空间，因此它们必须是唯一的。我想不出比这更好的了：

foo is a tool used to do foo.

`Download foo`_

.. _Download foo: http://example.com/foo

blah blah blah (omit a lot of paragraphs)

bar is another tool to do bar.

`Download bar`_

.. _Download bar: http://example.com/bar