From: Guenter M. <mi...@us...> - 2013-03-08 13:23:58
|
Dear Dmitry, On 2013-03-08, SourceForge.net wrote: > Comment By: Dmitry Shachnev (mandriver) > Date: 2013-03-08 02:44 ... > You can respond by visiting: > https://sourceforge.net/tracker/?func=detail&atid=422030&aid=3607029&group_id=38414 >> @Dmitry: the suggestion to let a URI scheme override the trailing >> backslash should be discussed separately. > It doesn't solve that, but it makes sure that we don't break existing > projects (like Python's documentation). I see. > For example, at the moment I don't see any way to make my example work > with both "old" and "new" docutils. There is a workaround for existing projects: use separate targets :: link to `__init__`_ .. _`__init__`: http://example.com/#__init__ but I agree that this is not convenient. As the Docutils has its main use in program documentation and URIs of the above type are more common in this domain than in general, I'd agree to a change along your proposal. How about: -If a target URI happens to end with an underscore, this needs to be -backslash-escaped to avoid being parsed as hyperlink reference. For -example :: +`Standalone hyperlinks`_ are treated as URIs, even if they end with an +underscore like in the example of a Python function documentation:: + `__init__ <http://example.com/#__init__>`__ + +If a target URI that is not recognized as `standalone hyperlink`_ happens to +end with an underscore, this needs to be backslash-escaped to avoid being +parsed as hyperlink reference. For example :: + Use the `source <parrots.txt\_>`__. creates an anonymous reference to the file ``parrots.txt_``. Günter .. _standalone hyperlink: .. _standalone hyperlinks: http://docutils.sf.net/docs/ref/rst/restructuredtext.html#standalone-hyperlinks>`_. |
From: Dmitry S. <mi...@gm...> - 2013-03-11 09:20:13
|
Guenter Milde <milde <at> users.sf.net> writes: | How about: | | -If a target URI happens to end with an underscore, this needs to be | -backslash-escaped to avoid being parsed as hyperlink reference. For | -example :: | +`Standalone hyperlinks`_ are treated as URIs, even if they end with an | +underscore like in the example of a Python function documentation:: | | + `__init__ <http://example.com/#__init__>`__ | + | +If a target URI that is not recognized as `standalone hyperlink`_ happens to | +end with an underscore, this needs to be backslash-escaped to avoid being | +parsed as hyperlink reference. For example :: | + | Use the `source <parrots.txt\_>`__. | | creates an anonymous reference to the file ``parrots.txt_``. Looks like exactly what I meant, thank you! -- Dmitry Shachnev |
From: Guenter M. <mi...@us...> - 2013-03-11 17:15:01
|
On 2013-03-11, Dmitry Shachnev wrote: > Guenter Milde <milde <at> users.sf.net> writes: >| How about: >| -If a target URI happens to end with an underscore, this needs to be >| -backslash-escaped to avoid being parsed as hyperlink reference. For >| -example :: >| +`Standalone hyperlinks`_ are treated as URIs, even if they end with an >| +underscore like in the example of a Python function documentation:: >| + `__init__ <http://example.com/#__init__>`__ >| + >| +If a target URI that is not recognized as `standalone hyperlink`_ happens to >| +end with an underscore, this needs to be backslash-escaped to avoid being >| +parsed as hyperlink reference. For example :: >| + >| Use the `source <parrots.txt\_>`__. >| creates an anonymous reference to the file ``parrots.txt_``. > Looks like exactly what I meant, thank you! I hope David will give his OK. Günter |
From: David G. <go...@py...> - 2013-03-11 18:13:21
|
On Mon, Mar 11, 2013 at 12:14 PM, Guenter Milde <mi...@us...> wrote: > On 2013-03-11, Dmitry Shachnev wrote: >> Guenter Milde <milde <at> users.sf.net> writes: >>| How about: > >>| -If a target URI happens to end with an underscore, this needs to be >>| -backslash-escaped to avoid being parsed as hyperlink reference. For >>| -example :: >>| +`Standalone hyperlinks`_ are treated as URIs, even if they end with an >>| +underscore like in the example of a Python function documentation:: > >>| + `__init__ <http://example.com/#__init__>`__ >>| + >>| +If a target URI that is not recognized as `standalone hyperlink`_ happens to >>| +end with an underscore, this needs to be backslash-escaped to avoid being >>| +parsed as hyperlink reference. For example :: >>| + >>| Use the `source <parrots.txt\_>`__. > >>| creates an anonymous reference to the file ``parrots.txt_``. > >> Looks like exactly what I meant, thank you! > > I hope David will give his OK. It looks fine to me, thanks. -- David Goodger <http://python.net/~goodger> |