Sphinx: формирование внешней ссылки

Я хотел бы сделать ссылку на какой-то URL в моих сфинксов документы:Sphinx: формирование внешней ссылки

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

я нашел что-то похожее в Документах http://sphinx-doc.org/ext/extlinks.html - но это скорее о замене пользовательского синтаксиса со ссылкой, по соглашению. Вместо этого я просто хочу создать ссылку на внешний веб-ресурс.

источник

2013-06-19 Anton Arhipov

Нашел ответ в reStructuredText documentation. Это может быть сделано либо с именем ссылки:

Test hyperlink: SO_. 

.. _SO: http://stackoverflow.com/

Или со встроенным URI:

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

источник

2013-06-19 11:13:36

Как насчет нескольких слов в тексте ссылки? –

@MichaelGoerz во втором примере, он содержит несколько слов в тексте ссылки, не так ли? –

Да, но для случая названной ссылки мне потребовалось некоторое время, чтобы понять, что правильный синтаксис - «Stack Overflow_' »(без пробелов - не может правильно форматировать это в комментарии), а затем «.. Переполнение стека: http://stackoverflow.com». Это не в документации. –

Sphinx: формирование внешней ссылки

ответ

Смежные вопросы