Re: [Docutils-users] indirect references to citations

[Guenter M. <mi...@us...>]

On 2017-07-18, Guenter Milde via Docutils-users wrote:
> On 2017-07-18, Alan Isaac wrote:
> I expected this_ to work, but it produced an invalid link.

> .. this:: [mycite]_

> .. [mycite]
>     My Citation Details.

>> Are such indirect references allowed?

> Yes, if you use the correct syntax::

>   .. _this: [mycite]_

>   .. [mycite]
>       My Citation Details.

> (In your example, you used a *directive* "this".)

Actually, the correct syntax is ::

  .. _this: mycite_

  .. [mycite]
      My Citation Details.

as the brackets don't become part of the hyperlink reference name.

See docutils/docs/ref/rst/restructuredtext.html#hyperlink-targets

Günter