From: Guenter M. <mi...@us...> - 2013-02-13 09:34:49
|
On 2013-02-11, David Goodger wrote: > On Mon, Feb 11, 2013 at 9:30 AM, Guenter Milde <mi...@us...> wrote: >> On 2013-02-10, David Goodger wrote: >>> On Sun, Feb 10, 2013 at 12:11 AM, Guenter Milde <mi...@us...> wrote: >>>> On 2013-02-10, David Goodger wrote: >>>>> On Sat, Feb 9, 2013 at 3:44 AM, Dmitry Shachnev <mi...@gm...> wrote: >>>>>> It would be good if Docutils supported something similar to Markdown >>>>>> named references[1]. ... >>>>> Does anyone see a problem with this syntax? Or can anyone propose a >>>>> better syntax? I proposed the alternative `internal link <#anchor>`_ but with the wrong explanation. Actually, my proposed syntax is already documented: .. _citation: A hyperlink reference may directly embed a target URI inline, within angle brackets ("<...>") as follows:: See the `Python home page <http://www.python.org>`_ for info. -- `reStructuredText Markup Specification`__ __ http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris In the example of a file in the current directory given in the original post, the "scheme" specifier is omitted. In the same way, the "file" part can be omitted for anchors in the current document like in this `internal link <#citation>`_ with embedded URI. This even works in the reference implementation: Docutil's HTML writer. I suggest to extend the support to other writers instead of introducing a new special case for internal links. Günter |