I usually have the following in a project README.txt
.. _ChangeLog: ChangeLog
.. `_LICENSE.txt`: LICENSE.txt
Is there a shorter way to create a link to a local file?
From: David Goodger <goodger@py...> - 2008-07-17 17:58:59
On Thu, Jul 17, 2008 at 13:34, Miki Tebeka <miki.tebeka@...> wrote:
> I usually have the following in a project README.txt
> See ChangeLog_
> See `LICENSE.txt_`
The syntax there is not quite right. Probably a typo. Should be
`LICENSE.txt`_ or just LICENSE.txt_
> .. _ChangeLog: ChangeLog
> .. `_LICENSE.txt`: LICENSE.txt
> Is there a shorter way to create a link to a local file?
No explicit target necessary.
David Goodger <http://python.net/~goodger>
From: G. Milde <milde@us...> - 2008-07-18 08:13:07
On 17.07.08, David Goodger wrote:
> On Thu, Jul 17, 2008 at 13:34, Miki Tebeka <miki.tebeka@...> wrote:
> > See `LICENSE.txt`_
> > .. `_LICENSE.txt`: LICENSE.txt
> > Is there a shorter way to create a link to a local file?
> See `<LICENSE.txt>`_.
> No explicit target necessary.
Could this very helpfull feature be documented in the quickref.html?
reStructuredText also provides for embedded URIs (details_), which is
especially handy for local links. A hyperlink reference may directly
embed a target URI inline, within angle brackets. The URI will be
duplicated for use as the reference text if no extra reference text is
given. The following table shows two local links and an equivalent to the
Plain text Typical result
See also `<demo.txt>`__ and See also demo.txt and demo.html.
External hyperlinks, like `Python External hyperlinks, like Python.