Re: [Gzz] ReST links

[Benja Fallenstein]

Asko Soukka wrote:
> Thu, 27 Feb 2003, Benja Fallenstein kirjoitti:
>
> > > Rendering a ``VobScene`` can happen in two ways, depending on whether OpenGL
> > > or AWT is being used. OpenGL is described in `GLRenderables`__.
> > >
> > > .. _GLRenderables: Gzz_Frontend_GLRend.gen.html
> > >
> > > __ GLRenderables_
> >
> > What's the reason for this weird ReST construct?
>
>
> Probably I was confused of all the possiblities to create links
> in reST :P

:-)

For everybody: You'll want to know two ways. Firstly, named hyperlinks:

    Described in `GLRenderables`_.

    .. _GLRenderables: Gzz_Frontend_GLRend.gen.html

(single underscore.) Second, anonymous hyperlinks:

    Click `here`__ or `here`__.

    __ target1.html
    __ http://www.target2.org/

Anonymous hyperlinks are useful when you have more than one link with 
the same link text, or when the link text is long and you don't want to 
type as much.

Other variations aren't as important probably.

- Benja