Как да се справим с дублиращи се целеви имена в reStructuredText?

Пример:

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".

Докато съм в маркдаун, мога да посоча различен идентификатор за тези две Download:

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

Как мога да правя подобни неща в reStructuredText?


restructuredtext
person weakish    schedule 30.01.2011    source източник

Отговори (2)


arrow_upward
4
arrow_downward

Вариант едно

Както посочи @mzjn, направете целевото име по-ясно:

`Download foo`_

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

`Download bar`_

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

Вариант две

От пощенски списък на потребителя на docutils:

Използвайте анонимна хипервръзка:

Download__


__ http://example.com/foo


Download__

__ http://example.com/bar
person weakish    schedule 08.02.2011

arrow_upward
1
arrow_downward

Доколкото мога да разбера от документацията, препратка имената в 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
person mzjn    schedule 07.02.2011
comment
Тогава какво ще кажете за това? Our product integrates with `sphinx`_ (omit a lot of paragraphs) Powered by `sphinx`_ , където първият sphinx препраща към началната страница на sphinx search, а вторият sphinx препраща към началната страница на sphinx documentation builder. - person weakish; 08.02.2011