Re: Underscore after links

40 views
Skip to first unread message

Jonathan Waltman

unread,
Nov 8, 2012, 2:40:54 AM11/8/12
to sphinx...@googlegroups.com
One underscore means it is a internal or external hyperlink reference [1].

Two underscores means an anonymous hyperlink [2].

:ref: is a Sphinx extension to reStructuredText that is similar to the
first one but is not constrained to the current document.

[1] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#hyperlink-references

[2] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#anonymous-hyperlinks

[3] http://sphinx-doc.org/markup/inline.html?highlight=ref#cross-referencing-syntax

For future reference, we are redirecting non-development
related questions to the new sphinx-users mailing list
<sphinx...@googlegroups.com>. Thanks.

--
Jonathan Waltman


On Wed, Nov 7, 2012 at 7:15 PM, Jack Morgan <jackmor...@gmail.com> wrote:
> I'm new to Sphinx, and wondering what the underscore achieves with these
> links:
>
> `Link text <http://www.google.com>`_
> ref:`brainstorming`__
>
> They seem to work perfectly fine without the underscore. The document I have
> been given sometimes has 1 underscore after a link, sometimes 2. The author
> is currently out of reach, so thought I would ask you guys.
>
> --
> You received this message because you are subscribed to the Google Groups
> "sphinx-dev" group.
> To unsubscribe from this group, send email to
> sphinx-dev+...@googlegroups.com.
> For more options, visit https://groups.google.com/groups/opt_out.
>
>
Reply all
Reply to author
Forward
0 new messages