Wechseln zu: Navigation, Suche

Hilfe:Links und Referenzen: Unterschied zwischen den Versionen

Zeile 149: Zeile 149:
 
Die Syntax für protokoll-relative externe Links ist <syntaxhighlight lang="html5" enclose="none">[//URL]</syntaxhighlight> und kann wahlweise als namenloser Link oder als Link mit Alternativtext dargestellt werden.
 
Die Syntax für protokoll-relative externe Links ist <syntaxhighlight lang="html5" enclose="none">[//URL]</syntaxhighlight> und kann wahlweise als namenloser Link oder als Link mit Alternativtext dargestellt werden.
  
'''Beispiel:''' Ein protokoll-relativer Link auf [//www.blue-engineering.org blue-engineering.org]. Wird dieser Artikel über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.
+
'''Beispiel:''' Ein protokoll-relativer Link auf [//tu-berlin.de tu-berlin.de]. Wird dieser Artikel über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.
  
'''Code:''' <syntaxhighlight lang="html5" enclose="none">Ein protokoll-relativer Link auf [//www.blue-engineering.org blue-engineering.org]. Wird dieser Artikel über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.
+
'''Code:''' <syntaxhighlight lang="html5" enclose="none">Ein protokoll-relativer Link auf [//tu-berlin.de tu-berlin.de]. Wird dieser Artikel über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.
 
</syntaxhighlight>
 
</syntaxhighlight>
  

Version vom 28. September 2014, 14:16 Uhr

Eines der wesentlichen Elemente von Webseiten ist die Verwendung von Links (plural, kurz für Hyperlink, von engl. to link zu deutsch verknüpfen), mit welchen Inhalte auf verschiedenen Seiten verknüpft werden können. Ein Vorteil gegenüber den Printmedien ist die unkomplizierte Interaktion durch den Rezipient, da das Umblättern und Suchen der entsprechenden Seite entfällt.

Innerhalb der mediaWiki Software werden Links in die Klassen intere Links, externe Links, automatisch generierte Links und Referenzen unterteilt und sollen im Folgenden vorgestellt werden.


Links

interne Links

Unter interne Links werden generell alle Verweise innerhalb des mediaWikis zusammengefasst. Diese können anhand ihrer Funktion noch feiner unterteilt werden und verlinken entweder auf Stellen innerhalb des Artikels, auf andere Artikel oder sie binden andere Artikel in einen bestehenden Artikel ein. Letztere Variation hat vor allem für die Verwendung von Vorlagen eine Bedeutung.

Nutzung von internen Links

Interne Links werden durch zwei öffnende eckige Klammern eingeleitet und mit zwei schließenden eckigen Klammern beendet. Die Verlinkung innerhalb des mediaWikis erfolgt dann über den Artikelnamen womit die Syntax für einen internen Link vollständig wie folgt aussieht: [[Artikelname]]. In der Grundform wird dann der verlinkte Artikelname als Link ausgegeben.

Beispiel: Die Verlinkung der Hauptseite.

Code: Die Verlinkung der [[Hauptseite]].


Da Links oft innerhalb von Texten Anwendung finden besteht die Möglichkeit anstelle des Artikelnamens auch einen alternativen Text auszugeben. Die Syntax wird dann um das Pipe-Symbol | ergänzt und der Alternativtext dahinter geschrieben. Darüber lässt sich der Textfluss ungestört weiter verfolgen.

Beispiel: Statt Hauptseite kann man diese auch Startseite nennen.

Code: Statt Hauptseite kann man diese auch [[Hauptseite | Startseite]] nennen.


Gelegentlich soll ein Link um einige Zeichen ergänzt werden um beispielsweise die Mehrzahl im Textfluss zu verwenden oder um den Artikelnamen der grammatikalischen Gegebenheit des Textes anzupassen. Dies ist mit der Variante des Alternativtextes zwar möglich aber manchmal umständlich. Der mediaWiki Parser bietet aber hier die Möglichkeit diese Satzzeichen einfach ohne Leerzeichen an den Link anzuhängen und interpretiert dies dann zusammenhängend.

Beispiel: Erreichbar sind wir über die auf der Kontaktseite angegebenen Daten.

Code: Erreichbar sind wir über die auf der [[Kontakt]]seite angegebenen Daten.


Soll auf einen Artikel in einem anderen Namensraum als den Standardnamensraum verlinkt werden muss dieser mit angegeben werden. Der Namensraum ist Teil des Artikelnamens und wird bei der Ausgabe mit angegeben. Soll dies nicht geschehen muss der Link um einen Alternativtext ergänzt werden. Der Name des Namensraum kann nur im Hauptnamensraum entfallen.

Beispiel: Der Link Hauptseite liegt im Hauptnamensraum. Daher wird der Name des Namensraum weggelassen. Der Link auf den Artikel Start im Namensraum Hilfe wird ohne Alternativtext mit dem Namensraumnamen als Präfix ausgegeben, also Hilfe:Start

Code: Der Link [[Hauptseite]] liegt im Hauptnamensraum. Daher wird der Name des Namensraum weggelassen. Der Link auf den Artikel [[Hilfe:Start | Start]] im Namensraum ''Hilfe'' wird ohne Alternativtext mit dem Namensraumnamen als Präfix ausgegeben, also [[Hilfe:Start]]


Es gibt einige Sonderfälle bei welchen die Verlinkung geringfügig angepasst werden muss. Betroffen davon sind unter anderem Links auf Dateien oder Kategorien. Möchte man auf eine Kategorie verlinken, muss dem Link ein Doppelpunkt : vorangestellt werden. Auf die Sonderfälle wird im entsprechenden Abschnitt eingegangen.

Beispiel: Die Kategorie:Bausteine ist ein derartiger Sonderfall. Würden man den Doppelpunkt weglassen interpretiert der Parser dies als Packe diesen Artikel in diese Kategorie und unterdrückt die Ausgabe dieses Links.

Code: Die [[:Kategorie:Bausteine]] ist ein derartiger Sonderfall. Würden man den Doppelpunkt weglassen interpretiert der Parser dies als ''Packe diesen Artikel in diese Kategorie'' und unterdrückt die Ausgabe dieses Links.


In einigen Fällen werden bei bestimmten Schlüsselwörtern auch automatische Links erzeugt. Näheres hierzu beschreibt der Abschnitt automatisch generierte Links.


Anker / Sprungziel

Links die artikelintern auf bestimmte Stellen verweisen werden als Anker oder Sprungziel bezeichnet. Sie finden dann Anwendung, wenn auf eine bestimmte Textpassage verwiesen werden soll. Diese Anker können aber nicht nur artikelintern genutzt werden sondern auch auf Textpassagen in anderen Artikeln verlinken.

Die Verwendung von Ankern erfolgt mittels der Link-Syntax. Dem Anker wird das Rautesymbol # voran gestellt wodurch beim parsen der Artikel automatisch ein Link zur entsprechenden Sprungstelle generiert wird. Überschriften werden dabei automatisch als mögliche Sprungziele definiert.

Hinweis: Das Rautesymbol # wird mit ausgegeben. Soll dies nicht geschehen muss dies über die Möglichkeit des Alternativlinktextes umgesetzt werden.


Beispiel:

Anker auf eine Überschrift innerhalb des Artikels.

Code: [[#Name der Überschrift]]


Anker auf eine Überschrift in einem anderen wikiinternen Artikel.

Code: [[Artikelname#Name der Überschrift]]


Dieses vorgehen kann nachteilig sein, wenn man auf einen bestimmten Absatz innerhalb eines längeren Textes verweisen möchte und bei welchem die Überschrift zu weit oben definiert ist. Für diesen Fall wurde eine Vorlage eingerichtet mit der das Setzen von Ankern möglich ist.

Eingebunden werden diese selbstdefinierten Anker über {{Anker|Bezeichnung des Ankers}}. Der Begriff Anker bezeichnet dabei die Vorlage:Anker und Bezeichnung des Ankers definiert den Namen des Ankers. Es können bis zu sechs Namen für den Anker angegeben werden. Für näheres siehe die Beschreibung innerhalb der Vorlage.

Die Verlinkung auf selbstdefinierte Anker erfolgt in der selben Form wie für Überschriften.

Beispiel:

Im Artikel Schön ist das Leben wurde der Anker Sonnenschein definiert (siehe Code).

Code: {{Anker|Sonnenschein}}

Die Verlinkung auf den Anker Sonnenschein erfolgt dann so:

Code im selben Artikel: [[#Sonnenschein]]


Code in einem anderen Artikel: [[Schön ist das Leben#Sonnenschein]]


Beide Links verweisen nun auf die Stelle an welcher der Anker Sonnenschein definiert ist.


Sonderfälle

Es gibt drei Sonderfälle bei denen der Befehl dem eines Links gleicht aber eine andere Funktionsweise hat. Es handelt sich dabei um die Befehle zum Einbinden von Dateien [[Datei:Dateiname.Dateiendung]], dem Hinzufügen des Artikels zu einer Kategorie [[Kategorie:Kategoriename]] und Interlanguage [[Sprachkürzel:Artikelname]] angaben.

Sollen in Artikels Links auf diese Sonderfälle erzeugt werden muss, wie weiter oben bereits beschrieben, diesen ein Doppelpunkt vorangestellt werden. Dies gilt für Dateien und Kategorien.

Beispiele: Eine Verlinkung auf das Bild Be_frozen_lake.jpg erfolgt entweder über Datei:Be_frozen_lake.jpg, da ohne Doppelpunkt sonst das Bild eingebunen werden würde.

Code: Eine Verlinkung auf das Bild ''Be_frozen_lake.jpg'' erfolgt entweder über [[:Datei:Be_frozen_lake.jpg]], da ohne Doppelpunkt sonst das Bild eingebunen werden würde.


Für Dateien gibt es noch eine weitere Verlinkungsmöglichkeit. Statt [[:Datei:Dateiname.Dateiendung]] kann auch [[Medium:Dateiname.Dateiendung]] (auch [[Media:Dateiname.Dateiendung]] ) verwendet werden.

Beispiel: Es wird wieder auf das Bild Be_frozen_lake.jpg verlinkt, diesmal jedoch mittels Medium, also Medium:Be_frozen_lake.jpg bzw. via Media also auch Media:Be_frozen_lake.jpg .

Code: Es wird wieder auf das Bild ''Be_frozen_lake.jpg'' verlinkt, diesmal jedoch mittels ''Medium'', also [[Medium:Be_frozen_lake.jpg]] bzw. via ''Media'' also auch [[Media:Be_frozen_lake.jpg]] .


Die Interlanguage-Links dienen vor allem dazu Übersetzungen zum Artikel mit einzubinden.


externe Links

Als externer Link werden jene Links bezeichnet, welche auf Seiten außerhalb des mediaWikis verweisen. Zu erkennen sind diese Links in den meisten Fällen an der URL (=Uniform Resource Locator, zu deutsch einheitlicher Quellenanzeiger womit meistens die Webadresse gemeint ist). Ausnahmen stellen hierbei Webprojekte dar, welche auf dem selben Webserver betrieben werden. Ein Beispiel hierfür ist die 25-Fragen Geocaching Web-App (http://blue-eng.km.tu-berlin.de/25fgc/), welche auf dem selben Server betrieben wird aber nicht innerhalb des mediaWikis realisiert ist.

Die Syntax für externe Links unterscheidet sich geringfügig von der für interne Links. Diese werden mit nur einer eckigen Klammer eingeleitet und abgeschlossen, also [Webadresse]. Dies soll den Unterschied zwischen externen und internen Links auch optisch hervorheben.

Zusätzlich zur Syntax gibt es auch bei der Verwendung einige Abweichungen. So erzeugt das verlinken ohne Alternativtext einen sogenannten namenlosen Link. Es wird also statt der URL nur eine Ziffer in eckigen Klammern ausgegeben. Jeder auf diese Art eingebundene Link erhält eine fortlaufende Nummer. Wird also ein Link mehrfach namenlos eingebunden erhalten diese unterschiedliche Nummern.

Beispiel: Die Variante mit namenlosen Links kann praktisch sein, wenn die URL-Angabe im Text nicht erwünscht ist. [1] [2] [3]

Code: Die Variante mit namenlosen Links kann praktisch sein, wenn die URL-Angabe im Text nicht erwünscht ist. [http://www.blue-engineering.org] [http://km.tu-berlin.de] [http://www.blue-engineering.org]


Soll statt der Ziffer die Webadresse ausgegeben werden bieten sich zwei Varianten an. In der ersten wird die Funktionalität der automatisch generierten Links aufgegriffen und die zweite verwendet die Möglichkeit des Alternativtextes.

Erstere Variante wird im entsprechenden Abschnitt genauer erklärt und wir begnügen uns an dieser Stelle mit einem einfachen Beispiel.

Beispiel: Die Ausgabe der URL http://www.blue-engineering.org wird durch die Funktionalität der automatisch generierten Links erzeugt.

Code: Die Ausgabe der URL http://www.blue-engineering.org wird durch die Funktionalität der automatisch generierten Links erzeugt.


Die Variante Alternativtext, wie sie bereits von den internen Links bekannt ist, weist für die externen Links ebenfalls eine Abweichung in der Syntax auf. Dabei wird darauf zurückgegriffen, dass Leerzeichen innerhalb von Webadressen unüblich sind. Entsprechend ist die Verwendung des Pipe-Symbols | nicht notwendig und wird weggelassen.

Anmerkung: Das Pipe-Symbol | wird bei externen Links als normaler Text interpretiert und entsprechend mit ausgegeben.

Beispiel: Wenn ein externer Link innerhalb eines Textes verwendet wird, kann die Ausgabe der URL unerwünscht sein. Nutzt man als Einleitung des Alternativtextes das Pipe-Symbol | wird dieser im | Link mit dem Alternativtext mit ausgegeben.

Code: Wenn ein [http://www.blue-engineering.org externer Link] innerhalb eines Textes verwendet wird, kann die Ausgabe der URL unerwünscht sein. Nutzt man als Einleitung des Alternativtextes das Pipe-Symbol {{!}} wird dieser im [http://www.blue-engineering.org | Link mit dem Alternativtext] mit ausgegeben.


Das Thema Rechnersicherheit hat durch das Internet im Laufe der Zeit immer größere Bedeutung bekommen und mit den Snowden-Enthüllungen im Sommer 2013 hat vor allem die Verschlüsselung eine größere Aufmerksamkeit erhalten. Da Externe Links im Allgemeinen die Angabe des Protokolls, mit welchen die Daten übertragen werden, benötigen, ist die Angabe dieser dementsprechend notwendig. Daher müssen externen Links im Regelfall das http:// bzw. https:// vorangestellt werden.

In manchen Fällen ist es daher nicht erwünscht den Protokolltypen vorzugeben. Daher bietet der mediaWiki Parser hierfür die Verwendung von protokoll-relativen externen Links an. Protokoll-relativ bedeutet, dass der Protokolltyp des Nutzers / der Nutzerin darüber entscheidet mit welcher HTTP Variante Links eingebunden werden. Besucht ein/e NutzerIn das mediaWiki und nutzt hierfür die verschlüsselte HTTP Variante werden alle protokoll-relativen Links ebenfalls als verschlüsselte HTTP Variante angeboten.

Die Syntax für protokoll-relative externe Links ist [//URL] und kann wahlweise als namenloser Link oder als Link mit Alternativtext dargestellt werden.

Beispiel: Ein protokoll-relativer Link auf tu-berlin.de. Wird dieser Artikel über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.

Code: Ein protokoll-relativer Link auf [//tu-berlin.de tu-berlin.de]. Wird dieser Artikel über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.


automatisch generierte Links

Referenzen

Unter Referenzen werden in der Regel die Einzelnachweis-' bzw. Quellenangaben zusammengefasst. Ursprünglich gehörten die damit zusammenhängenden Befehle nicht zum Standardbefehlssatz der mediaWiki Software. Mittlerweile gehört die dafür verantwortliche Extension (engl. für [Software-]Erweiterung) zum Standardlieferumfang und kann bei der Installation bereits aktiviert werden.

Die Befehle sollen vor allem dabei helfen Einzelnachweise bzw. Quellen relativ unkompliziert aufzulisten und können entsprechend auch zum Erzeugen einer Literaturliste verwendet werden. Da wissenschaftliche Texte selten ohne Quellenangaben auskommen sollen die entsprechenden Befehle <ref> </ref> und <references /> nun vorgestellt werden.