Sphinx: creating an external link

Question

I want to link some url in my sphinx docs:

<a href="http://some.url">blah</a> 

I found something similar in the docs: http://sphinx-doc.org/ext/extlinks.html - but this is more of a replacement for custom syntax with a link, by convention, Instead, I just want to create a link to an external web resource.

Answer 1

Found the answer in the reStructuredText documentation . This can be done with a named link:

 Test hyperlink: SO_. .. _SO: http://stackoverflow.com/ 

Or with a built-in URI:

 Test hyperlink: `Qaru <http://stackoverflow.com/>`_.