Handbuch:Erweiterung/BlueSpiceInsertLink

Wie erstelle ich Links?

Die Verlinkung von Seiten ist ein wichtiges Merkmal der browserbasierten Wissensdokumentation. Dabei unterscheiden sich die Links oftmals in ihrer Funktion. Links vernetzen Wikiseiten mit:

• internen Wikiseiten
• externen Websites
• Dateien, die ins Wiki hochgeladen wurden (Bilder, PDF-Dateien, Word Dokumente,...)
• anderen browserbasierten Systemen.

Links lassen sich über die Funktion Link einfügen des visuellen Editors oder mit der Tastenkombination Strg+K einfügen. In beiden Fällen öffnet sich der entsprechende Dialog.

Seitenlink einfügen

Link zu einer Wikiseite

Interne Links verlinken verwandte Seiten oder Inhalte, die weiterführende Informationen liefern.

Wenn Sie Text auf der Seite markiert haben, sind im Reiter Seiten suchen eventuell einige Seitenvorschläge aufgelistet. Hier können Sie die Suche entsprechend anpassen oder einen Link zu einer neuen Seite erstellen.

Hinweis zum Suchfeld:Seiten in Namensräumen werden hier nur gefunden, wenn das Namensraumpräfix angegeben wird. Bei Unterseiten muss zusätzlich die übergeordnete Seite mit angegeben werden.

Klicken Sie anschließend auf Fertig.

Im Quelltext werden die Links mit folgender Struktur angelegt:

• Link zu einer Wikiseite: [[Name der Zielseite|Beschriftung]]
• Link zu einer Wikiseite in einem anderen Namensraum: [[Namensraum:Name der Zielseite|Beschriftung]]
• Link zu einer Kategorieseite: [[:Kategorie:Kategoriename|Beschriftung]] Um einen Link zu einer Kategorie zu erstellen wird im Quelltext ein Doppelpunkt vor den Kategoriennamen gesetzt. Der Link [[Kategorie:BlueSpice]] hingegen würde eine Kategorie mit dem Namen BlueSpice erstellen anstelle zur Kategorieseite BlueSpice zu verlinken.
• Interwikilink: [[Imdb:tt2709692]] Wenn es in Ihrem Wiki eine Vernetzung mit anderen Wikis gibt, können Sie über den Reiter Seiten suchen auch direkt auf eine Seite in einem verwandten Wiki linken. Wenn Ihr Administrator zum Beispiel einen Interwikilink zur Filmdatenbank IMDb pflegt, kann er wie im obigen Beispiel in Kurzform eingegeben werden.

Link zu einem Seitenabschnitt

Ab BlueSpice 4.3 lassen sich Seitenabschnitte direkt über ein entsprechendes Symbol verlinken:

1. Klicken Sie im Ansichtsmodus der Seite direkt auf das Link-Symbol links von der Überschrift (es erscheint, wenn Sie über die Überschrift hovern). Dies kopiert den Sprunglink in die Zwischenablage.
   
   

   Sprunglink kopieren
2. Fügen Sie nun die gespeicherte Linkanweisung mit <key>Strg</key>+<key>V</key> in das Dialogfenster zur Erstellung eines Links ein.

Um einen beliebigen Textabschnitt zu verlinken (wenn z.B. keine Überschrift vorhanden ist), kann alternativ im Quelltext manuell ein Anker erzeugt werden: Zu diesem Text springen. Dieser Anker wird dann entsprechend über das Link-Menü mit einer Raute verlinkt:

Link auf eine Textstelle auf der gleichen Seite

Link auf eine Textstelle auf einer anderen Seite

Link zu einer externen Website

Um eine externe Website zu verlinken, markieren Sie Text auf Ihrer Seite, z.B. das Wort Wikipedia. Drücken Sie Strg+K und wechseln Sie zum Reiter Externer Link. Dort geben Sie die Webadresse an. Klicken Sie anschließend auf Einfügen.

Externe Website verlinken

Hinweis:Um externe Links auf Ihrem Wiki einfach zu pflegen, gibt es die Spezialseite Spezial:Weblinksuche. Über diese Seite können Sie im gesamten Wiki nach externen Links suchen. Auf der Spezialseite befindet sich ein Link zur Mediawiki-Hilfeseite(auf Englisch).

Link zu einer Dateiseite

Um eine Dateiseite (= Versionierungsseite einer Datei) zu verlinken, wechseln Sie zum Reiter Link auf Datei.

Link zu Datei einfügen

Um eine Datei direkt zu verlinken (sodass sich zum Beispiel ein PDF direkt nach dem Anklicken des Links öffnet), fügen Sie den Link über den Menüpunkt Einfügen, Unterpunkt Bilder und Medien ein.

Link zu einer Datei auf dem lokalen Netzwerk

Wenn Sie auf eine Datei auf Ihrem Firmennetzwerk verlinken wollen, können Sie den Reiter Link auf Datei benutzen. Die Möglichkeit, direkt eine Datei auf einem Netzwerklaufwerk über den Browser aufzurufen, funktioniert heutzutage eigentlich nicht mehr, ist aber hier der Vollständigkeit halber aufgeführt.

Wichtig!Links auf Netzwerklaufwerke (UNC-Links) stellen ein Sicherheitsrisiko da. Daher blockieren alle modernen Browser standardmäßig diese Links.

Zusätzlich kann es sein, dass Ihr Wiki so konfiguriert wurde, dass das Einfügen eines Netzwerkpfades nicht erlaubt ist.

Sprechen Sie mit Ihrer IT-Abteilung, wenn Sie Fragen zu Richtlinien rund um Ihren Browser haben. Sollte Ihre IT-Abteilung hier keine Lösung anbieten, können solche im Wiki verlinkten Dateien von Wiki-Benutzern kopiert werden und in die Adressleiste von Windows Explorer eingefügt werden.

Mehr Info zu UNC-Links finden Sie auf: https://www.mediawiki.org/wiki/UNC_links/de.

So fügen Sie einen Link auf eine Netzwerkdatei ein:

Link zu externer Datei

1. Klicken Sie auf Link einfügen im visuellen Editor.
2. Klicken Sie auf den Reiter Link auf Datei.
3. Aktivieren Sie den Schalter Netzwerkpfad (URI). Im Suchfeld (4) wird nun das Link-Symbol angezeigt.
4. Geben Sie Ihren Netzwerkpfad ein. Diesen erhalten Sie, indem Sie in Windows Explorer per Rechtsklick auf die Dateieigenschaften gehen. Unter Sicherheit können Sie den Objektnamen kopieren und entsprechend im Wiki einfügen.
   
   

   Dateipfad ermitteln
   
   
5. Klicken Sie Einfügen. Der Link wird nun automatisch im korrekten Format eingefügt (file://S:/7_Benutzer/....). Ob sich der Link auch direkt über den Browser im Windows Explorer öffnet, hängt von den Sicherheitseinstellungen und Add-ons in Ihrem Browser ab.Wenden Sie sich an Ihre IT-Abteilung, wenn die Links nicht im Browser anklickbar sind.

Interne Links in neuem Tab öffnen

Standardmäßig werden externe Links in einem neuen Browser-Tab geöffnet. Wenn Sie einzelne interne Links auch in einem neunen Tab öffnen wollen, können Sie auf der Seite MediaWiki:Common.js folgendes JavaScript einfügen:

/**
 * @source https://www.mediawiki.org/wiki/Snippets/Open_specific_links_in_new_window
 * @version 2018-09-15
 */
$( function () {
	$( '#mw-content-text' ).on( 'click', '.newwin > a', function () {
		var otherWindow = window.open();
		otherWindow.opener = null;
		otherWindow.location = this;
		return false;
	} );
} );

Fügen Sie den internen Link entsprechend im Quelltext-Modus so ein:

<span class="newwin">[[Meine Seite]]</span>

Permalinks (revisionsspezifisch)

Bei jedem Speichern eine Seite (Revision) wird eine Version mit einer bestimmten Versionsnummer erzeugt. Jede Version hat somit eine eigene Web-Adresse (URL). Diese wird auch als permanenter Link oder "Permalink" bezeichnet und ist so zugänglich:

1. Über den "Teilen"-Link in der Seitenwerkzeugeleiste. Hierbei wird der Permalink der gerade geladenen Seitenversion in die Zwischenablage gelegt. Klicken Sie auf das "Teilen"-Symbol und wählen Sie "URL kopieren".
   

   Permanenten Link kopieren
2. Über die Versionsgeschichte. Klicken Sie in der Seitenwerkzeugleiste auf "Versionsgeschichte" und klicken Sie dort auf den Datumsstempel einer Version. Die Webadresse der Seite zeigt nun den Permalink an.
   

   Permalink über die Versionsgeschichte kopieren

Beide Vorgehensweisen erzeugen einen Permalink, der abhängig ist vom Seitennamen der Seite:

https://de.wiki.bluespice.com/w/index.php?title=Handbuch:Erweiterung/BlueSpiceInsertLink&oldid=7974

Sollte die Seite verschoben (also umbenannt) werden, wird der Permalink weiterhin über die "oldid" funktionieren.

Tipp:In beiden Fällen werden externe Links erzeugt, etwa zum Kopieren in eine E-mail oder eine andere Webseite. Um einen internen Permalink zu erzeugen, müssen Sie über die Spezialseite "Permanenter Link" verlinken (siehe nächster Abschnitt).

Interner Permalink

Im Quelltext der Seite kann ein verkürzter Permalink auf folgende Weise eingefügt werden:

[[Spezial:Permanenter Link/7972]]

Über den visuellen Editor geben Sie den Link entsprechend über die Link-Schaltfläche () ein:

interne Verlinkung eines Permalinks

Weiterführende Links

• https://www.mediawiki.org/wiki/Help:Links
• VisualEditor
• InterwikiLinks

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Kategorien helfen, Seiten im Wiki zur organisieren. Jede Kategorie ist im gesamten Wiki verfügbar.

Protokoll zur Verschlüsselung und Authentifizierung der Kommunikation zwischen Webserver und Browser im World Wide Web.

Ein Uniform Resource Locator (Abk. URL; englisch für „einheitlicher Ressourcenverorter“) identifiziert und lokalisiert eine Ressource, beispielsweise eine Webseite, über die zu verwendende Zugriffsmethode (zum Beispiel das verwendete Netzwerkprotokoll wie HTTP oder FTP) und den Ort (englisch location) der Ressource in Computernetzwerken.

Ein Permalink (von permanent und hyperlink, auch Permanentlink) ist ein dauerhafter Identifikator in Form einer URL. Bei der Einrichtung eines Permalinks wird angestrebt, die einmal über ihn referenzierten Inhalte dauerhaft und primär über diese URL verfügbar zu machen. Beim Einsatz in Bibliothekskatalogen wird der Permalink meistens Zitierlink genannt.

Technische Referenz: BlueSpiceInsertLink

---

Feedback zur Dokumentation ist im Community-Forum möglich.