[Docutils-users] Re: A list of links

[Felix W. <Fel...@gm...>]

Morten Lied Johansen wrote:

> I'm using a few replace & link constructs like the one below, but I was
> wondering if it is possible to include a list of such links somehow?
>
> .. |Python| replace:: Python_
> .. _Python: http://www.python.org
>
> (Yes, I know it's a minimalist example, and the replace is hardly
> needed, but I wanted consistency :)

I'd rather not use substitutions, but links.  So instead of |Python|,
write Python_.

Then compile a list of links like this::

    .. _Python: http://www.python.org/
    .. _XML: http://www.w3.org/XML/

which you could even save in a separate file so that you can simply
``.. include::`` it at the end (or at the beginning) of your reST
documents to have the link targets available.
    
> I'm thinking of the cases where the end document type doesn't support
> links (for instance when printed on paper ;),

The LaTeX writer allows setting the link color to black with
--hyperlink-color=black.  I guess there is a similar possibility for the
XSL:FO stylesheets.

-- 
When replying to my email address, please ensure
that the mail header contains 'Felix Wiemann'.

http://www.ososo.de/