Как бороться с дублирующимися именами целей в 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-адреса, documenttilus выдает следующее сообщение об ошибке:

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

Во время уценки я могу указать разные идентификаторы для этих двухDownload:

[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

Вариант два

От Documentstils-user maillist :

Использовать анонимную гиперссылку:

Download__


__ http://example.com/foo


Download__

__ http://example.com/bar

Answer 2

Насколько я могу судить по документации , имена ссылок в документах 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