Wechseln zu: Navigation, Suche

Hilfe:Links und Referenzen: Unterschied zwischen den Versionen

 
(16 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 6: Zeile 6:
 
= Links =
 
= Links =
 
== interne 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.
+
Unter ''interne Links'' <ref>[http://de.wikipedia.org/wiki/Hilfe:Links#Links_innerhalb_der_Wikipedia Beschreibung zu Links innerhalb der Wikipedia (de.wikipedia.org im Hilfe Bereich)]</ref> 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.
  
<syntaxhighlight lang="html5" enclose="none">{{Anker|Bezeichnung des Ankers}}</syntaxhighlight>
+
=== 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: <syntaxhighlight lang="html5" enclose="none">[[Artikelname]]</syntaxhighlight>. In der Grundform wird dann der verlinkte Artikelname als Link ausgegeben. Ist das Ziel des Links der Artikel selbst wird dieser automatisch fett hervorgehoben und nicht als Verlink dargestellt. Dies ist besonders für [[Help:Vorlagen | Vorlagen]] interessant, welche eine Navigation durch Artikelreihen realisiert.
  
<syntaxhighlight lang="html5" enclose="none">[[Artikelname#Bezeichnung des Ankers]]</syntaxhighlight>
+
'''Beispiel:''' Die Verlinkung der [[Hauptseite]]. Und eine Verlinkung auf den [[Hilfe:Links_und_Referenzen | Artikel selbst]].
 +
 
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">Die Verlinkung der [[Hauptseite]]. Und eine Verlinkung auf den [[Hilfe:Links_und_Referenzen | Artikel selbst]].</syntaxhighlight>
 +
 
 +
 
 +
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 [[Hauptseite | Startseite]] nennen.
 +
 
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">Statt Hauptseite kann man diese auch [[Hauptseite | Startseite]] nennen.</syntaxhighlight>
 +
 
 +
 
 +
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 [[Kontakt]]seite angegebenen Daten.
 +
 
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">Erreichbar sind wir über die auf der [[Kontakt]]seite angegebenen Daten.</syntaxhighlight>
 +
 
 +
 
 +
 
 +
Soll auf einen Artikel in einem anderen [[Hilfe:Aufbau_und_Struktur_eines_mediaWikis#Namensräume (engl. namespaces) | 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 [[Hilfe:Start | Start]] im Namensraum ''Hilfe'' wird ohne Alternativtext mit dem Namensraumnamen als Präfix ausgegeben, also [[Hilfe:Start]]
 +
 
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">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]]</syntaxhighlight>
 +
 
 +
 
 +
 
 +
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 [[#Sonderfälle | 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:''' <syntaxhighlight lang="html5" enclose="none">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.</syntaxhighlight>
 +
 
 +
 
 +
In einigen Fällen werden bei bestimmten Schlüsselwörtern auch automatische Links erzeugt. Näheres hierzu beschreibt der Abschnitt [[#automatisch generierte Links | automatisch generierte Links]].
  
<syntaxhighlight lang="html5" enclose="none">[[#Bezeichnung des Ankers]]</syntaxhighlight>
 
  
 
=== Anker / Sprungziel ===
 
=== Anker / Sprungziel ===
Links die Artikelintern auf bestimmte Stellen verweisen werden auch als Anker oder Sprungziel bezeichnet.  
+
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:''' <syntaxhighlight lang="html5" enclose="none">[[#Name der Überschrift]]</syntaxhighlight>
 +
 
 +
 
 +
Anker auf eine Überschrift in einem anderen wikiinternen Artikel.
 +
 
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">[[Artikelname#Name der Überschrift]]</syntaxhighlight>
 +
 
 +
 
 +
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 <syntaxhighlight lang="html5" enclose="none">{{Anker|Bezeichnung des Ankers}}</syntaxhighlight>. 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:Anker | 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:''' <syntaxhighlight lang="html5" enclose="none">{{Anker|Sonnenschein}}</syntaxhighlight>
 +
 
 +
Die Verlinkung auf den Anker ''Sonnenschein'' erfolgt dann so:
 +
 
 +
'''Code im selben Artikel:''' <syntaxhighlight lang="html5" enclose="none">[[#Sonnenschein]]</syntaxhighlight>
 +
 
 +
 
 +
'''Code in einem anderen Artikel:''' <syntaxhighlight lang="html5" enclose="none">[[Schön ist das Leben#Sonnenschein]]</syntaxhighlight>
 +
 
 +
 
 +
Beide Links verweisen nun auf die Stelle an welcher der Anker ''Sonnenschein'' definiert ist.
 +
 
 +
 
 +
=== Sonderfälle ===
 +
Es gibt drei Sonderfälle <ref>[http://de.wikipedia.org/wiki/Hilfe:Links#Sonderfälle_und_Doppelpunkt Beschreibung zu den Sonderfällen und der Bedeutung des Doppelpunkts (de.wikipedia.org im Hilfe Bereich)]</ref> bei denen der Befehl dem eines Links gleicht aber eine andere Funktionsweise hat. Es handelt sich dabei um die Befehle zum Einbinden von Dateien <syntaxhighlight lang="html5" enclose="none">[[Datei:Dateiname.Dateiendung]]</syntaxhighlight>, dem Hinzufügen des Artikels zu einer Kategorie <syntaxhighlight lang="html5" enclose="none">[[Kategorie:Kategoriename]]</syntaxhighlight> und Interlanguage <syntaxhighlight lang="html5" enclose="none">[[Sprachkürzel:Artikelname]]</syntaxhighlight> 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:''' <syntaxhighlight lang="html5" enclose="none">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.</syntaxhighlight>
 +
 
 +
 
 +
Für Dateien gibt es noch eine weitere Verlinkungsmöglichkeit. Statt <syntaxhighlight lang="html5" enclose="none">[[:Datei:Dateiname.Dateiendung]]</syntaxhighlight> kann auch <syntaxhighlight lang="html5" enclose="none">[[Medium:Dateiname.Dateiendung]]</syntaxhighlight> (auch <syntaxhighlight lang="html5" enclose="none">[[Media:Dateiname.Dateiendung]]</syntaxhighlight> ) 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:''' <syntaxhighlight lang="html5" enclose="none">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]] .</syntaxhighlight>
 +
 
 +
 
 +
Die Interlanguage-Links dienen vor allem dazu Übersetzungen zum Artikel mit einzubinden.
  
  
 
== externe Links ==
 
== externe Links ==
 +
Als externer Link <ref>[http://de.wikipedia.org/wiki/Hilfe:Links#Links_zu_externen_Webseiten_(Weblinks) Links zu externen Websiten im mediaWiki (de.wikipedia.org im Hilfe Bereich)]</ref> werden jene Links bezeichnet, welche auf Seiten außerhalb des mediaWikis verweisen also sogenannte Weblinks. 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 <syntaxhighlight lang="html5" enclose="none">[Webadresse]</syntaxhighlight>. 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. [http://www.blue-engineering.org] [http://km.tu-berlin.de] [http://www.blue-engineering.org]
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">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]</syntaxhighlight>
 +
 +
 +
Soll statt der Ziffer die Webadresse ausgegeben werden bieten sich zwei Varianten an. In der ersten wird die Funktionalität der [[#automatisch generierte Links | 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:''' <syntaxhighlight lang="html5" enclose="none">Die Ausgabe der URL http://www.blue-engineering.org wird durch die Funktionalität der automatisch generierten Links erzeugt.</syntaxhighlight>
 +
 +
 +
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 [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.
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">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.</syntaxhighlight>
 +
 +
 +
 +
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 <syntaxhighlight lang="html5" enclose="none">http://</syntaxhighlight> bzw. <syntaxhighlight lang="html5" enclose="none">https://</syntaxhighlight> 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 <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.tu-berlin.de www.tu-berlin.de]. Wird dieser [[Help:Links_und_Referenzen| mediaWiki 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.tu-berlin.de www.tu-berlin.de]. Wird dieser [[Help:Links_und_Referenzen| mediaWiki Artikel]] über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.</syntaxhighlight>
 +
 +
 +
'''Hinweis:''' Leider bieten noch nicht alle Webspace-/Webserver-Anbieter eine SSL Verschlüsselung in der Grundausstattung an, wodurch der Aufruf über https mit einem 404-Fehler ''Error: Page not found'' beantwortet wird. Es muss daher sichergestellt sein, dass die anzusteuernde Website auch über https angesteuert werden kann!
  
  
 
== automatisch generierte Links ==
 
== automatisch generierte Links ==
 +
Die Funktionalität der automatisch generierten Links greift bei bestimmten Schlüsselwörtern welche den mediaWiki Parser dazu veranlassen die entsprechende Verlinkung zu erzeugen. Momentan reagiert der Parser bei den Schlüsselwörtern <kbd>ISBN</kbd> (kurz für '''I'''nternationale '''S'''tandard'''b'''uch'''n'''ummer <ref>[http://de.wikipedia.org/wiki/Internationale_Standardbuchnummer Artikel zur ISBN auf de.wikipedia.org]</ref>), <kbd>RFC</kbd> (kurz für '''R'''equest '''f'''or '''C'''omments <ref>[http://de.wikipedia.org/wiki/Request_for_Comments Request for Comments Artikel auf de.wikipedia.org]</ref>) und <kbd>PMID</kbd> (kurz für '''P'''ub'''M'''ed '''id'''entifier <ref>[http://de.wikipedia.org/wiki/PubMed Eintrag zu PubMed auf de.wikipedia.org]</ref>). Damit aus diesen Schlüsselwörtern ein entsprechender Link erzeugt wird erwartet der Parser die Angaben in Form des Musters <syntaxhighlight lang="html5" enclose="none">Schlüsselwort Wert</syntaxhighlight>, wobei bei ''Wert'' ein dem Schlüsselwort entsprechende Form haben muss. Wird dieses Muster unterbrochen erfolgt keine automatische Generierung eines Links und die Ausgabe erfolgt als normaler Text.
 +
 +
Bei einer ISBN wird auf die [[Spezial:ISBN-Suche | ISBN-Suche mediaWiki Extension (=Erweiterung)]] verlinkt. Diese generiert eine Liste zu den entsprechenden Buchbeschreibungen diverser Buchhändlerseiten und dem [http://www.ubka.uni-karlsruhe.de Karlsruher Virtueller Katalog (KVK)].
 +
 +
'''Beispiele'''
 +
 +
'''ISBN:''' ISBN 978-0-12-345678-9, auch möglich ist ISBN 978-0123456789 oder ISBN 9780123456789.
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">ISBN 978-0-12-345678-9, auch möglich ist ISBN 978-0123456789 oder ISBN 9780123456789.</syntaxhighlight>
 +
 +
 +
'''RFC:''' RFC 4321
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">RFC 4321</syntaxhighlight>
 +
 +
 +
'''PMID:''' PMID 12345678
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">PMID 12345678</syntaxhighlight>
 +
 +
 +
 +
'''Hinweis:''' In manchen Situation ist es wünschenswert, dass kein Link automatisch generiert wird. Dies kann über drei Wege unterbunden werden.
 +
# Zwischen dem ''Schlüsselwort'' und dem ''Wert'' wird ein geschütztes Leerzeichen <syntaxhighlight lang="html5" enclose="none">&nbsp;</syntaxhighlight> eingefügt, also <syntaxhighlight lang="html5" enclose="none">Schlüsselwort&nbsp;Wert</syntaxhighlight>
 +
# Das Parsing (=Interpretation durch den Parser) wird unterbunden. Dies kann damit erreicht werden, dass der entsprechende Abschnitt über den mediaWiki-Tag <syntaxhighlight lang="html5" enclose="none"><nowiki> </nowiki></syntaxhighlight> vom Parsing ausgenommen wird, also <syntaxhighlight lang="html5" enclose="none"><nowiki>Schlüsselwort Wert</nowiki></syntaxhighlight>. Alle zwischen diesem Tag befindlichen Zeichen werden der Webbrowser Software als Rohdaten übermittelt und dieser übernimmt die entsprechende Interpretation.
 +
# Es wird der mediaWiki-Tag <syntaxhighlight lang="html5" enclose="none"><nowiki /></syntaxhighlight> zwischen ''Schlüsselwort'' und ''Wert'' platziert, also <syntaxhighlight lang="html5" enclose="none">Schlüsselwort<nowiki />Wert</syntaxhighlight>.
 +
 +
 +
= Sonderzeichen in Links =
 +
Ein wesentliches Problem bei Weblinks stellen Sonderzeichen <ref>[http://de.wikipedia.org/wiki/Hilfe:Links#Sonderzeichen_in_URL_und_Linktitel Verwendung von Sonderzeichen in URL und Linktitel (de.wikipedia.org im Hilfe Bereich)]</ref> dar. Ursprung dieser Probleme sind unter anderem das nicht vorhanden sein des Sonderzeichens in den gängigen Zeichenkodierungen mancher Sprachen (größtenteils durch die Einführung des Unicode <ref>[http://de.wikipedia.org/wiki/Unicode Beschreibung des Unicode Standards auf de.wikipedia.org]</ref> Standards gelöst, betraff hauptsächlich Umlaute wie Ä, Ö, Ü oder ß im Deutschen) oder die Verwendung des Sonderzeichen als Steuerzeichen (beispielsweise in Programmier- und Scriptsprachen oder auch Protokollen). Letzteres trifft beispielsweise auf die eckigen Klammern [ und ] zu, mit welchen Links beispielsweise erzeugt werden und weshalb die Verwendung dieser in einem Link zu fehlerhaften Interpretationen des Parsers führt.
 +
 +
'''Beispiel:''' In diesem Beispiel soll ein Link eckige Klammern enthalten, also [http://blue-engineering.org Dies [-;-] ist eine tolle Seite.].
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">In diesem Beispiel soll ein Link eckige Klammern enthalten, also [http://blue-engineering.org Dies [-;-] ist eine tolle Seite.].</syntaxhighlight>
 +
 +
Durch das verwenden der beiden eckigen Klammern innerhalb des Alternativtextes interpretiert der mediaWiki Parser diese als Steuerzeichen für den externen-Link-Befehl. Um diese Fehlinterpretation zu vermeiden müssen die eckigen Klammern durch deren Unicode-Kodierung ersetzt werden.
 +
 +
'''Beispiel mit URL-Encoder:''' Das gleiche Beispiel nun mit dem Unicode Zeichencode womit eckige Klammern, also [http://blue-engineering.org Dies &#x5B;-;-&#x5D; ist eine tolle Seite.], nun genau das Erzeugen was wir haben wollen.
 +
 +
'''Code:''' <syntaxhighlight lang="html5" enclose="none">Das gleiche Beispiel nun mit dem Unicode Zeichencode womit eckige Klammern, also [http://blue-engineering.org Dies &#x5B;-;-&#x5D; ist eine tolle Seite.], nun genau das Erzeugen was wir haben wollen.</syntaxhighlight>
 +
 +
 +
Werden Sonderzeichen in Artikelnamen verwendet (was wiederum Auswirkungen auf die URL hat) kann alternativ auch in Links der URL-Encoder Kodierung genutzt werden. Dies hängt mit dem [zumindest theoretisch vorhandene] Probleme zusammen, dass einige Webserver diese Sonderzeichen nicht interpretieren können. Die entsprechende Umformung nimmt der Webbrowser meist automatisch vor und wird man beispielsweise beim Kopieren und Einfügen von wikipedia Links des Öfteren schon gesehen haben.
 +
 +
'''Beispiel:''' http://de.wikipedia.org/wiki/Graph_%28Graphentheorie%29
 +
 +
Hier wurden die runden Klammern ( ) durch Firefox automatisch in die URL-Encoder Kodierung überführt.
 +
 +
Eine kleine Auflistung der Sonderzeichen und deren Kodierungsmöglichkeiten bietet die folgende Tabelle.
 +
 +
 +
{| class="wikitable sortable"
 +
|+ Tabelle mit den Kodierungen für Sonderzeichen
 +
! Zeichen
 +
! Bezeichnung
 +
! HTML-Kodierung
 +
! colspan="2" | Unicode-Kodierung
 +
! URL-Encoder-Kodierung
 +
! mediaWiki-Kodierung
 +
|-
 +
| [
 +
| öffnende eckige Klammer
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#91;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x5B;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%5B</syntaxhighlight>
 +
|
 +
|-
 +
| ]
 +
| schließende Eckige Klammer
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#93;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x5D;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%5D</syntaxhighlight>
 +
|
 +
|-
 +
| (
 +
| öffnende [runde] Klammer
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#40;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x28;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%28</syntaxhighlight>
 +
|
 +
|-
 +
| )
 +
| schließende [runde] Klammer
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#41;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x29;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%29</syntaxhighlight>
 +
|
 +
|-
 +
| <
 +
| öffnende spitze Klammer
 +
| <syntaxhighlight enclose="none" lang="html5">&lt;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#60;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x3C;</syntaxhighlight>
 +
|
 +
|
 +
|-
 +
| >
 +
| schließende spitze Klammer
 +
| <syntaxhighlight enclose="none" lang="html5">&gt;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#62;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x3E;</syntaxhighlight>
 +
|
 +
|
 +
|-
 +
| {
 +
| öffnende geschweifte Klammer
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#123;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x7B;</syntaxhighlight>
 +
|
 +
|
 +
|-
 +
| }
 +
| schließende geschweifte Klammer
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#125;</syntaxhighlight>
 +
|  <syntaxhighlight enclose="none" lang="html5">&#x7D;</syntaxhighlight>
 +
|
 +
|
 +
|-
 +
| "
 +
| Anführungszeichen
 +
| <syntaxhighlight enclose="none" lang="html5">&quot;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#34;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x22;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%22</syntaxhighlight>
 +
|
 +
|-
 +
| !
 +
| Ausrufezeichen
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#33;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x21;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%21</syntaxhighlight>
 +
|
 +
|-
 +
| &#124;
 +
| vertikaler Strich / Pipe-Symbol
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#124;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x7C;</syntaxhighlight>
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">{{!}}</syntaxhighlight> *
 +
|-
 +
| &
 +
| kaufmännisches Und / Et-Zeichen
 +
| <syntaxhighlight enclose="none" lang="html5">&amp;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#38;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x26;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%26</syntaxhighlight>
 +
|
 +
|-
 +
| ?
 +
| Fragezeichen
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#63;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x3F;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%3F</syntaxhighlight>
 +
|
 +
|-
 +
| =
 +
| Gleichheitszeichen
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#61;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x3D;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%3D</syntaxhighlight>
 +
|
 +
|-
 +
| #
 +
| Raute / Doppelkreuz
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#35;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x23;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%23</syntaxhighlight>
 +
|
 +
|-
 +
|
 +
| Leerzeichen
 +
|
 +
| <syntaxhighlight enclose="none" lang="html5">&#32;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">&#x20;</syntaxhighlight>
 +
| <syntaxhighlight enclose="none" lang="html5">%20</syntaxhighlight>
 +
|
 +
|-
 +
|}
 +
 +
'''*''' Kann innerhalb von normalen Texten (hier kann auch das | selbst genutzt werden) oder innerhalb von internen Links. Keine Wirkung innerhalb von Tabellen, hier muss stattdessen mit den Unicode-Kodierungen gearbeitet werden.
 +
 +
'''Hinweis:''' Es gibt wesentlich mehr Sonderzeichen mit entsprechenden Kodierungen. <ref>[http://de.wikipedia.org/wiki/Hilfe:Sonderzeichenreferenz#In_Web-Adressen_reservierte_Zeichen Sonderzeichenreferenz im Hilfe Bereich von de.wikipedia.org]</ref>
  
  
 
= Referenzen =
 
= 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.
+
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 <syntaxhighlight enclose="none" lang="html5"><ref> </ref></syntaxhighlight> und <syntaxhighlight enclose="none" lang="html5"><references /></syntaxhighlight> nun vorgestellt 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 <syntaxhighlight enclose="none" lang="html5"><ref> </ref></syntaxhighlight> und <syntaxhighlight enclose="none" lang="html5"><references /></syntaxhighlight> nun vorgestellt werden.
 +
 +
Mit <syntaxhighlight enclose="none" lang="html5"><references /></syntaxhighlight> wird an der entsprechenden Stelle eine ''Referenzenliste'' erzeugt, in welcher in Reihenfolge der Setzung die Referenzen ausgegeben werden. Der Befehl für die ''Referenzenliste'' kann alleine stehen ohne das im Artikel eine Referenz über <syntaxhighlight enclose="none" lang="html5"><ref> </ref></syntaxhighlight> gesetzt wurde bleibt dann aber ohne Effekt und erzeugt keine Ausgabe. In der Regel wird dies am Artikelende platziert. Ein Beispiel hierfür kannst du am Ende dieses Artikels sehen.
 +
 +
Der entsprechende '''Code''' sieht dann so aussehen:
 +
<syntaxhighlight line enclose="div" lang="html5">
 +
= Einzelnachweis =
 +
<references />
 +
</syntaxhighlight>
 +
 +
 +
 +
Eine ''Referenzenliste'' ist allerdings ohne ''Referenzen'', also ''Einzelnachweise'' bzw. ''Quellenangaben'', ziemlich sinnfrei. Um eine ''Referenz'' zu erzeugen wird der Tag <syntaxhighlight enclose="none" lang="html5"><ref> </ref></syntaxhighlight> genutzt, welcher automatisch einen Eintrag in der ''Referenzenliste'' erzeugt. Dabei wird der Text zwischen dem Tag in der ''Referenzenliste'' ausgegeben.
 +
 +
'''Codebeispiel:'''
 +
<syntaxhighlight line enclose="div" lang="html5">
 +
<ref>
 +
[http://de.wikipedia.org/wiki/Hilfe:Einzelnachweise Artikel über Einzelnachweise im Hilfebereich von de.wikipedia.org]
 +
</ref>
 +
</syntaxhighlight>
 +
 +
 +
Üblicherweise schreibt man den Befehl hintereinander weg und ist hier nur der Übersichtlichkeit wegen zeilenweise aufgeschlüsselt. Dementsprechend würde im Text dann eine ''Referenz'' wie folgt gesetzt werden:
 +
 +
'''Beispiel:''' Die Einzelnachweise <ref>[http://de.wikipedia.org/wiki/Hilfe:Einzelnachweise Artikel über Einzelnachweise im Hilfebereich von de.wikipedia.org]</ref> in einem mediaWiki bieten eine einfache Möglichkeit der Einzelnachweis- bzw. Quellenlistenerzeugung.
 +
 +
'''Code:''' <syntaxhighlight enclose="none" lang="html5">Die Einzelnachweise <ref>[http://de.wikipedia.org/wiki/Hilfe:Einzelnachweise Artikel über Einzelnachweise im Hilfebereich von de.wikipedia.org]</ref> in einem mediaWiki bieten eine einfache Möglichkeit der Einzelnachweis- bzw. Quellenlistenerzeugung.</syntaxhighlight>
 +
 +
 +
 +
Die entsprechende Referenz taucht nun auch in der ''Referenzenliste'' dieses Artikels auf und kann über den automatisch platzierten Link angesprungen werden.
 +
 +
'''Hinweis:''' Die Verwendung von <syntaxhighlight enclose="none" lang="html5"><ref> </ref></syntaxhighlight> ohne <syntaxhighlight enclose="none" lang="html5"><references /></syntaxhighlight> in einem Artikel erzeugt eine Fehlermeldung, da der Parser nicht weiß an welcher Stelle die Referenzen dargestellt werden sollen.
 +
 +
'''Anmerkung:''' Diese Möglichkeit erleichtert nur das Erzeugen und Verwalten von ''Referenz-'' bzw. ''Einzelnachweis-'' bzw. ''Quellenlisten''. Für die Einhaltung der wissenschaftlichen Geflogenheiten ist die/der NutzerIn selbst verantwortlich. Hinweise zu diesen Geflogenheiten werden im Artikel [[Hilfe:Allgemeine Hinweise zum wissenschaftlichen Arbeiten | Allgemeine Hinweise zum wissenschaftlichen Arbeiten]] und dessen Unterartikel beschrieben.
 +
 +
 +
= Einzelnachweise =
 +
<references />
  
 
__NOEDITSECTION__
 
__NOEDITSECTION__

Aktuelle Version vom 28. September 2014, 20:51 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 [1] 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. Ist das Ziel des Links der Artikel selbst wird dieser automatisch fett hervorgehoben und nicht als Verlink dargestellt. Dies ist besonders für Vorlagen interessant, welche eine Navigation durch Artikelreihen realisiert.

Beispiel: Die Verlinkung der Hauptseite. Und eine Verlinkung auf den Artikel selbst.

Code: Die Verlinkung der [[Hauptseite]]. Und eine Verlinkung auf den [[Hilfe:Links_und_Referenzen | Artikel selbst]].


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 [2] 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 [3] werden jene Links bezeichnet, welche auf Seiten außerhalb des mediaWikis verweisen also sogenannte Weblinks. 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 www.tu-berlin.de. Wird dieser mediaWiki 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 [//www.tu-berlin.de www.tu-berlin.de]. Wird dieser [[Help:Links_und_Referenzen| mediaWiki Artikel]] über http aufgerufen ist der Link dementsprechend mit der unverschlüsselten Variante ausgestattet. Analog dazu die verschlüsselte Variante mit https.


Hinweis: Leider bieten noch nicht alle Webspace-/Webserver-Anbieter eine SSL Verschlüsselung in der Grundausstattung an, wodurch der Aufruf über https mit einem 404-Fehler Error: Page not found beantwortet wird. Es muss daher sichergestellt sein, dass die anzusteuernde Website auch über https angesteuert werden kann!


automatisch generierte Links

Die Funktionalität der automatisch generierten Links greift bei bestimmten Schlüsselwörtern welche den mediaWiki Parser dazu veranlassen die entsprechende Verlinkung zu erzeugen. Momentan reagiert der Parser bei den Schlüsselwörtern ISBN (kurz für Internationale Standardbuchnummer [4]), RFC (kurz für Request for Comments [5]) und PMID (kurz für PubMed identifier [6]). Damit aus diesen Schlüsselwörtern ein entsprechender Link erzeugt wird erwartet der Parser die Angaben in Form des Musters Schlüsselwort Wert, wobei bei Wert ein dem Schlüsselwort entsprechende Form haben muss. Wird dieses Muster unterbrochen erfolgt keine automatische Generierung eines Links und die Ausgabe erfolgt als normaler Text.

Bei einer ISBN wird auf die ISBN-Suche mediaWiki Extension (=Erweiterung) verlinkt. Diese generiert eine Liste zu den entsprechenden Buchbeschreibungen diverser Buchhändlerseiten und dem Karlsruher Virtueller Katalog (KVK).

Beispiele

ISBN: ISBN 978-0-12-345678-9, auch möglich ist ISBN 978-0123456789 oder ISBN 9780123456789.

Code: ISBN 978-0-12-345678-9, auch möglich ist ISBN 978-0123456789 oder ISBN 9780123456789.


RFC: RFC 4321

Code: RFC 4321


PMID: PMID 12345678

Code: PMID 12345678


Hinweis: In manchen Situation ist es wünschenswert, dass kein Link automatisch generiert wird. Dies kann über drei Wege unterbunden werden.

  1. Zwischen dem Schlüsselwort und dem Wert wird ein geschütztes Leerzeichen &nbsp; eingefügt, also Schlüsselwort&nbsp;Wert
  2. Das Parsing (=Interpretation durch den Parser) wird unterbunden. Dies kann damit erreicht werden, dass der entsprechende Abschnitt über den mediaWiki-Tag <nowiki> </nowiki> vom Parsing ausgenommen wird, also <nowiki>Schlüsselwort Wert</nowiki>. Alle zwischen diesem Tag befindlichen Zeichen werden der Webbrowser Software als Rohdaten übermittelt und dieser übernimmt die entsprechende Interpretation.
  3. Es wird der mediaWiki-Tag <nowiki /> zwischen Schlüsselwort und Wert platziert, also Schlüsselwort<nowiki />Wert.


Sonderzeichen in Links

Ein wesentliches Problem bei Weblinks stellen Sonderzeichen [7] dar. Ursprung dieser Probleme sind unter anderem das nicht vorhanden sein des Sonderzeichens in den gängigen Zeichenkodierungen mancher Sprachen (größtenteils durch die Einführung des Unicode [8] Standards gelöst, betraff hauptsächlich Umlaute wie Ä, Ö, Ü oder ß im Deutschen) oder die Verwendung des Sonderzeichen als Steuerzeichen (beispielsweise in Programmier- und Scriptsprachen oder auch Protokollen). Letzteres trifft beispielsweise auf die eckigen Klammern [ und ] zu, mit welchen Links beispielsweise erzeugt werden und weshalb die Verwendung dieser in einem Link zu fehlerhaften Interpretationen des Parsers führt.

Beispiel: In diesem Beispiel soll ein Link eckige Klammern enthalten, also Dies [-;- ist eine tolle Seite.].

Code: In diesem Beispiel soll ein Link eckige Klammern enthalten, also [http://blue-engineering.org Dies [-;-] ist eine tolle Seite.].

Durch das verwenden der beiden eckigen Klammern innerhalb des Alternativtextes interpretiert der mediaWiki Parser diese als Steuerzeichen für den externen-Link-Befehl. Um diese Fehlinterpretation zu vermeiden müssen die eckigen Klammern durch deren Unicode-Kodierung ersetzt werden.

Beispiel mit URL-Encoder: Das gleiche Beispiel nun mit dem Unicode Zeichencode womit eckige Klammern, also Dies [-;-] ist eine tolle Seite., nun genau das Erzeugen was wir haben wollen.

Code: Das gleiche Beispiel nun mit dem Unicode Zeichencode womit eckige Klammern, also [http://blue-engineering.org Dies &#x5B;-;-&#x5D; ist eine tolle Seite.], nun genau das Erzeugen was wir haben wollen.


Werden Sonderzeichen in Artikelnamen verwendet (was wiederum Auswirkungen auf die URL hat) kann alternativ auch in Links der URL-Encoder Kodierung genutzt werden. Dies hängt mit dem [zumindest theoretisch vorhandene] Probleme zusammen, dass einige Webserver diese Sonderzeichen nicht interpretieren können. Die entsprechende Umformung nimmt der Webbrowser meist automatisch vor und wird man beispielsweise beim Kopieren und Einfügen von wikipedia Links des Öfteren schon gesehen haben.

Beispiel: http://de.wikipedia.org/wiki/Graph_%28Graphentheorie%29

Hier wurden die runden Klammern ( ) durch Firefox automatisch in die URL-Encoder Kodierung überführt.

Eine kleine Auflistung der Sonderzeichen und deren Kodierungsmöglichkeiten bietet die folgende Tabelle.


Tabelle mit den Kodierungen für Sonderzeichen
Zeichen Bezeichnung HTML-Kodierung Unicode-Kodierung URL-Encoder-Kodierung mediaWiki-Kodierung
[ öffnende eckige Klammer &#91; &#x5B; %5B
] schließende Eckige Klammer &#93; &#x5D; %5D
( öffnende [runde] Klammer &#40; &#x28; %28
) schließende [runde] Klammer &#41; &#x29; %29
< öffnende spitze Klammer &lt; &#60; &#x3C;
> schließende spitze Klammer &gt; &#62; &#x3E;
{ öffnende geschweifte Klammer &#123; &#x7B;
} schließende geschweifte Klammer &#125; &#x7D;
" Anführungszeichen &quot; &#34; &#x22; %22
 ! Ausrufezeichen &#33; &#x21; %21
| vertikaler Strich / Pipe-Symbol &#124; &#x7C; {{!}} *
& kaufmännisches Und / Et-Zeichen &amp; &#38; &#x26; %26
 ? Fragezeichen &#63; &#x3F; %3F
= Gleichheitszeichen &#61; &#x3D; %3D
# Raute / Doppelkreuz &#35; &#x23; %23
Leerzeichen &#32; &#x20; %20

* Kann innerhalb von normalen Texten (hier kann auch das | selbst genutzt werden) oder innerhalb von internen Links. Keine Wirkung innerhalb von Tabellen, hier muss stattdessen mit den Unicode-Kodierungen gearbeitet werden.

Hinweis: Es gibt wesentlich mehr Sonderzeichen mit entsprechenden Kodierungen. [9]


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.

Mit <references /> wird an der entsprechenden Stelle eine Referenzenliste erzeugt, in welcher in Reihenfolge der Setzung die Referenzen ausgegeben werden. Der Befehl für die Referenzenliste kann alleine stehen ohne das im Artikel eine Referenz über <ref> </ref> gesetzt wurde bleibt dann aber ohne Effekt und erzeugt keine Ausgabe. In der Regel wird dies am Artikelende platziert. Ein Beispiel hierfür kannst du am Ende dieses Artikels sehen.

Der entsprechende Code sieht dann so aussehen:

  1. = Einzelnachweis =
  2. <references />


Eine Referenzenliste ist allerdings ohne Referenzen, also Einzelnachweise bzw. Quellenangaben, ziemlich sinnfrei. Um eine Referenz zu erzeugen wird der Tag <ref> </ref> genutzt, welcher automatisch einen Eintrag in der Referenzenliste erzeugt. Dabei wird der Text zwischen dem Tag in der Referenzenliste ausgegeben.

Codebeispiel:

  1. <ref>
  2. [http://de.wikipedia.org/wiki/Hilfe:Einzelnachweise Artikel über Einzelnachweise im Hilfebereich von de.wikipedia.org]
  3. </ref>


Üblicherweise schreibt man den Befehl hintereinander weg und ist hier nur der Übersichtlichkeit wegen zeilenweise aufgeschlüsselt. Dementsprechend würde im Text dann eine Referenz wie folgt gesetzt werden:

Beispiel: Die Einzelnachweise [10] in einem mediaWiki bieten eine einfache Möglichkeit der Einzelnachweis- bzw. Quellenlistenerzeugung.

Code: Die Einzelnachweise <ref>[http://de.wikipedia.org/wiki/Hilfe:Einzelnachweise Artikel über Einzelnachweise im Hilfebereich von de.wikipedia.org]</ref> in einem mediaWiki bieten eine einfache Möglichkeit der Einzelnachweis- bzw. Quellenlistenerzeugung.


Die entsprechende Referenz taucht nun auch in der Referenzenliste dieses Artikels auf und kann über den automatisch platzierten Link angesprungen werden.

Hinweis: Die Verwendung von <ref> </ref> ohne <references /> in einem Artikel erzeugt eine Fehlermeldung, da der Parser nicht weiß an welcher Stelle die Referenzen dargestellt werden sollen.

Anmerkung: Diese Möglichkeit erleichtert nur das Erzeugen und Verwalten von Referenz- bzw. Einzelnachweis- bzw. Quellenlisten. Für die Einhaltung der wissenschaftlichen Geflogenheiten ist die/der NutzerIn selbst verantwortlich. Hinweise zu diesen Geflogenheiten werden im Artikel Allgemeine Hinweise zum wissenschaftlichen Arbeiten und dessen Unterartikel beschrieben.


Einzelnachweise

  1. Beschreibung zu Links innerhalb der Wikipedia (de.wikipedia.org im Hilfe Bereich)
  2. Beschreibung zu den Sonderfällen und der Bedeutung des Doppelpunkts (de.wikipedia.org im Hilfe Bereich)
  3. Links zu externen Websiten im mediaWiki (de.wikipedia.org im Hilfe Bereich)
  4. Artikel zur ISBN auf de.wikipedia.org
  5. Request for Comments Artikel auf de.wikipedia.org
  6. Eintrag zu PubMed auf de.wikipedia.org
  7. Verwendung von Sonderzeichen in URL und Linktitel (de.wikipedia.org im Hilfe Bereich)
  8. Beschreibung des Unicode Standards auf de.wikipedia.org
  9. Sonderzeichenreferenz im Hilfe Bereich von de.wikipedia.org
  10. Artikel über Einzelnachweise im Hilfebereich von de.wikipedia.org