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 <[email protected]>. Thanks. -- Jonathan Waltman On Wed, Nov 7, 2012 at 7:15 PM, Jack Morgan <[email protected]> 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 > [email protected]. > For more options, visit https://groups.google.com/groups/opt_out. > > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users?hl=en.
