Как предотвратить сфинкс от создания гиперссылки?

В моих документах я иногда использую "мусорные" URL-адреса в качестве примеров и не хочу, чтобы они были гиперссылками в никуда. Есть ли какой-либо синтаксис, чтобы эти URL не были гиперссылками?

Ответ 1

Существует три способа форматирования таких URL-адресов, чтобы они не были гиперссылками. Во-первых, обрабатывать образцы URL-адресов, например, другие образцы кода, и заключать их в обратные кавычки, например:

open ``http://www.example.com`` in a web browser

Вторым является использование роли Sphinx :samp:, например:

open :samp:`http://www.example.com` in a web browser

Роль :samp: позволяет вам выделять переменные части. Например, вы можете указать номер порта, выбранного пользователем, например:

open :samp:`http://www.example.com:{port}` in a web browser

и порт слова появится подчеркнутым, а фигурные скобки опущены.

Последний параметр заключается в том, чтобы добавить образец URL с обратной косой чертой, например:

open \http://www.example.com in a web browser

URL-адрес будет отображаться как обычный текст без ссылки или специального форматирования.

Ответ 2

В дополнение к ответу @ddbeck, чтобы избежать адресов электронной почты, префикс @слэш.

login\@<hostname>