Include long url in sphinx documentation

Question

I am very new in Sphinx. So sorry if it is very basic question.

I have a very long url I would like to include in my documentation. If I just include the link in my doc, it looks ugly because it is too long

I tried, to include it in a box doing

Click on the following link ::

   http://my_very_looooooooooooooooooooooog_url

Then, it looks much better since it is on one line only but it is not clickable anymore.

What can I do to have it clickable and on one single line ?

Thank you for your help

Answer 1

You can use an any one of the hyperlink constructs available in reStructuredText. One example is to use an embedded URI, as defined in the reStructuredText specification (see, for example, the quick reference), writing:

External hyperlinks, like `Python <http://www.python.org/>`_.

renders like the following:

External hyperlinks, like Python.