In meinen Dokumenten verwende ich gelegentlich "Müll" -URLs als Beispiele und möchte nicht, dass sie Hyperlinks zu Nirgendwo sind. Gibt es eine Syntax, um diese URLs nicht zu Hyperlinks zu machen?Wie verhindere ich, dass Sphinx eine URL zu einem Hyperlink macht?
Es gibt drei Möglichkeiten, solche URLs zu formatieren, so dass sie keine Hyperlinks sind. Die erste ist, Beispiel-URLs wie andere Codebeispiele zu behandeln und sie in einfachen Anführungszeichen einschließen, wie folgt aus:
open ``http://www.example.com`` in a web browser
Die zweite ist die Sphinx :samp: Rolle zu verwenden, wie folgt aus:
open :samp:`http://www.example.com` in a web browser
Die :samp: Rolle lässt Sie variable Teile betonen. So zum Beispiel, könnten Sie eine vom Benutzer gewählte Portnummer angeben, wie folgt aus:
open :samp:`http://www.example.com:{port}` in a web browser
und das Wort Port hervorgehoben erscheinen würde und Klammern weggelassen.
Die letzte Option ist die Beispiel-URL mit einem umgekehrten Schrägstrich vorangestellt wird, wie folgt aus:
open \http://www.example.com in a web browser
Die URL erscheint als normalen Text, ohne eine Verbindung zu sein oder eine spezielle Formatierung aufweisen.
Zusätzlich zu @ddbeck antworten, um E-Mail-Adressen zu entkommen, das @ mit einem Schrägstrich voranstellen.
login\@<hostname>