2012-11-12 5 views
6

Ich bin sehr neu in Sphinx. Es tut mir leid, wenn es sehr grundlegende Frage ist.Enthalten lange URL in Sphinx-Dokumentation

Ich habe eine sehr lange URL, die ich gerne in meine Dokumentation aufnehmen würde. Wenn ich den Link in meinem doc nur schließen, es hässlich aussieht, weil sie zu lang ist

Ich habe versucht, es in eine Schachtel

Klicken Sie auf den folgenden Link tun enthalten ::

http://my_very_looooooooooooooooooooooog_url 

Dann sieht es viel besser aus, da es nur auf einer Zeile ist, aber nicht mehr klickbar ist.

Was kann ich tun, um es klickbar und in einer einzigen Zeile zu haben?

Vielen Dank für Ihre Hilfe

Antwort

13

Sie können eine beliebige der Hyperlink-Konstrukte in reStructuredText verfügbar verwenden. Ein Beispiel dafür ist URI ein eingebettet verwenden, wie in der reStructuredText Spezifikation definiert (siehe zum Beispiel die quick reference), schreibend:

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

macht wie folgt aus:

Externe Hyperlinks, wie Python.

+0

Vielen Dank. Aber ich möchte, dass ich die URL immer noch sehen kann, ich möchte sie im obigen Beispiel nicht durch einen Link wie Python ersetzen. – lizzie

+0

Ist das normal, funktioniert die Hyperlink-Methode nicht, wenn sie in einem Block ist? Wenn ich das tue: Externe Hyperlinks, wie 'Python ' _. das ist ok (ich bekomme eine anklickbare Python), aber wenn ich: siehe den folgenden Link :: Externe Hyperlinks, wie 'Python ' _. Dann habe ich die volle Zeile gedruckt – lizzie

+0

Das '::' startet einen literalen Block, der standardmäßig einfach ein Text in einer Monospace-Schriftart gesetzt ist. Keine weitere Bearbeitung des Textes ist erfolgt (AFAIK). Also ja, das ist normal. – Chris

Verwandte Themen