Re: [Docutils-users] Internal links with different link text.

[David G. <go...@py...>]

On Mon, Dec 22, 2008 at 09:43, Leandro Lucarella <ll...@gm...> wrote:
> It's possible to add an internal link but using an alternative link name,
> like with external links in the form `Alternative text
> <http://www.example.com>`_?
>
> Something like:
> -------------------------------------------------------------------------
>
> Hello
> =====
>
> This is a `link <Hello>`_.

No, you cannot use inline URIs in angle brackets as above to make
indirect internal links.

However, you can do the equivalent in several ways:

1. Use an anchor directly, as in "This is a `link <#hello>`_". This is
fragile though, and not recommended.

2. Use an anonymous link:

"""
This is a link__.

__ Hello_
"""

(Note: backquotes are required for `multi-word link text`_, anonymous or named.)

3. Use a named link:

"""
This is a link_.

.. _link: Hello_
"""

4. Use an explicit target:

"""
.. _link:

Hello
=====

This is a `link`_.
"""

-- 
David Goodger <http://python.net/~goodger>