Links (1 von 2)#
Verlinkung zu einer externen Website#
Quelltext#
# Definition (vielleicht am Textende)
.. _Website Python: https://python.org
-------+------ ---------+--------
| |
| o---- Link (nicht direkt sichtbar)
o---------------------- Linkbeschriftung (sichtbar)
# Anwendung (im Text)
`Website Python`_
Ergebnis#
Verlinkung zu einer anderen Seite (intern)#
Referenzen, damit können Querverweise im Dokument erzeugt werden.
einen Zielnamen definieren (siehe andere Seite)
Quelltext:
.. _links2:
Zum Ziel verweisen…
:ref:`Sprung zu einer anderen Seite mit dem Sprungziel *link2* <link2>`
Hint
Kein Leerzeichen zwischen :ref: und dem ersten Akzent (`)!
Ergebnis#
Download-Link#
Quelltext:
Download: :download:`UML-Diagramme im SVG-Format (zip-Datei) <files/bilder-im-svg-format.zip>`
Ergebnis:
Download: UML-Diagramme im SVG-Format (zip-Datei)
Link-Referenz#
Links sind oft sehr lang und können zahlreich im Text verteilt sein. Eine Möglichkeit der »zentralen Verwaltung« am Ende der Datei verbessert die Lesbarkeit im Text und die Übersicht.
Sammeln sie alle Links am Ende eines Dokumentes.
.. _PDF zum Lehrgang in Hamburg: /static/download/hamburg/hamburg2014.pdf .. _PDF zum Lehrgang in Stuttgart: /static/download/stuttgart/stuttgart2015.pdf
Im Text verweisen Sie dann auf diese Links:
`PDF zum Lehrgang in Stuttgart`_ `PDF zum Lehrgang in Hamburg`_
Hat sich der Dateiname geändert, muss er nur an einer Stelle (am Textende) ausgetauscht werden. Der Verweis im Text ist davon nicht betroffen.