DokuWiki: Mediendateien

Häufig werden in Artikeln im DokuWiki Mediendateien wie Bilder und Dokumente eingebunden. Wie diese in einem DokuWiki-Artikel verwendet, verschoben und wieder gelöscht werden können wird im Folgenden näher erläutert.

Bevor eine Bilddatei oder ein Dokument im DokuWiki verwendet und angezeigt werden kann muss dieses erst einmal auf den DokuWiki-Server hochgeladen werden. Dazu muss zunächst der Medien-Manager im Drop-down-Menü ausgewählt und geöffnet werden.

Der nun geöffnete Medien-Manager ist folgendermaßen aufgebaut: Der Bereich auf der linken Seite (a) zeigt sämtliche vorhandenen Namensräume für Mediendateien an. Hier muss nun der gewünschte Namensraum ausgewählt werden in welchem die Datei gespeichert werden soll. Wenn die Datei in einem noch nicht existierenden Namensraum gespeichert werden soll dann muss der Namensraum ausgewählt werden in welchem sich der neue Namensraum befinden soll. Im Falle des Überarbeitens eines alten Lernstatt-Artikels könnte das zum Beispiel mit einem Klick auf den Namensraum lernstatt und dann auf den Namensraum dokumentation geschehen (wenn die Veröffentlichungsrechte für die Datei vorhanden sind). Ist dies geschehen muss auf der rechten Seite (b) auf die Schaltfläche „Hochladen“ (d) geklickt werden. Unter Dateiauswahl [c] werden außerdem die bereits im ausgewählten Namensraum befindlichen Dateien angezeigt und nach einem Klick auf die Schaltfläche „Suchen“ (e) können zudem spezifische Dateien nach Namen gesucht und weitere Informationen zu diesen angezeigt werden.

Nach dem Klick auf die Schaltfläche „Hochladen“ muss nun die gewünschte Datei ausgewählt werden. Durch einen Klick auf „Dateien auswählen“ (a) öffnet sich das lokale Datei-System auf dem eigenen Rechner und es können eine oder mehrere hochzuladende Dateien ausgewählt werden. Für Bilddateien wird dabei das Dateiformat PNG und für Dokumente das Dateiformat PDF empfohlen. Die Dateien werden nun angezeigt (b) und können vor dem Hochladen noch umbenannt werden. Dabei können, indem im Dateinamen ein Name gefolgt von einem Doppelpunkt eingefügt werden auch neue Namensräume erstellt und die Bilder direkt in diese hochgeladen werden. Es können durch das Setzen des Hakens bei der entsprechenden Schaltfläche auch bestehende Dateien überschrieben werden. Abgeschlossen wird der Vorgang des Hochladens dann durch einen Klick auf die Schaltfläche „Hochladen“ [c] .

Die Adresse, unter der die Mediendatei später verlinkt werden kann ist nach dem Schema Namesraum1:Namensraum2:Dateiname.Dateiendung aufgebaut, könnte also zum Beispiel lernstatt:dokumentation:Handbuch.pdf oder lernstatt:dokumentation:grundschulen:Medienraum.png lauten. Der Namensraum, in welchen die Datei hochgeladen wird wird hier ebenfalls angezeigt (d) .

Ist das Bild oder das Dokument erfolgreich hochgeladen kann es nun im konkreten Artikel verwendet werden. Dazu muss der Artikel zunächst zum Bearbeiten geöffnet werden.

Falls das Bild oder das Dokument - wie in diesem Satz auch - einfach im Artikel verlinkt werden soll sodass es anklickbar ist und später heruntergeladen werden kann dann muss nun im geöffneten ckgedit-Editor der Ausgangstext ausgewählt und dann auf die Schaltfläche "Link einfügen/editieren" geklickt werden. Als nächstes muss aus der Liste unter „Link-Typ“ (a) die Art der Verlinkung ausgewählt werden. Anstelle der ersten Option (eine Verlinkung auf andere Seiten im World-Wide-Web) oder der zweiten Option (eine Verlinkung auf andere Seiten im DokuWiki) muss hier der dritte Verlinkungstyp „internal media“ angeklickt werden. Nun kann entweder mit der Schaltfläche „Server durchsuchen“ (b) der Server nach der gewünschten Datei durchsucht und diese ausgewählt werden oder die aus Namensraum und Dateiname gebildete Adresse der auf dem DokuWiki-Server hochgeladenen Datei direkt in das Textfeld unter „link to media file“ [c] eingetragen werden. Abschließend muss alles mit einem Klick auf die Schaltfläche „OK“ (d) bestätigt werden.

Falls ein Bild stattdessen wie hier gezeigt direkt auf der Seite angezeigt werden soll muss etwas anders vorgegangen werden. In diesem Fall muss im geöffneten Editor zunächst die Schaltfläche „Bild“ (a) angeklickt und dann „/lib/exe/fetch.php?media=“ in das Textfeld unter „URL“ (b) eingetragen werden. Nun muss dahinter die Adresse der Bilddatei eingefügt werden. Diese kann im Medien-Manager nach einem Klick auf das hochgeladene Bild abgelesen werden. Es kann dann noch das Bildformat wie etwa die Breite und die Höhe oder die Ausrichtung des Bildes geändert werden [c] . Es wird außerdem - wenn die eingegebene Bildadresse korrekt war - eine Vorschau des Bildes angezeigt (d) . Abschließend muss wieder mit einem Klick auf die Schaltfläche „OK“ (e) bestätigt werden.

Alternativ kann auch der original DokuWiki-Editor verwendet und das Bild in der offiziellen DokuWiki-Syntax eingebunden werden.

Das Umbenennen von Bildern und Dokumenten sowie das Verschieben derselben in einen anderen Namensraum ist ebenfalls möglich. Das Vorgehen ähnelt dabei stark dem Verfahren beim Verschieben eines Artikels.

Es muss als Erstes wieder der baumbasierte Move-Manager geöffnet werden. Der einzige Unterschied zum Verschieben von Artikeln ist, dass nun auf der rechten Seite (a) unter Mediendateien die entsprechenden Namensräume oder Bilder und Dokumente verschoben werden müssen (b) . Diese können außerdem durch einen Klick auf das kleine Symbol „Dieses Element umbenennen“ [c] welches am rechten Rand neben dem entsprechenden Element auftaucht sobald man mit der Maus darüber fährt umbenannt werden.

Die Anpassung der Links auf allen Seiten des DokuWikis geschieht nach dem Klicken des Start-Buttons (d) wieder automatisch.

Bilder und Dokumente können auch wieder entfernt werden. Dazu muss zuerst der Medienmanager geöffnet und dann in der Dateiauswahl [c] oder der Suche (e) die entsprechende Datei gefunden und angeklickt werden.

Nachdem nun die entsprechende Datei ausgewählt wurde erscheint auf der rechten Seite (a) ein Menü mit detailierten Informationen zur gewählten Datei. Neben dem Betrachten der angezeigten Datei-Adresse (b) und weiterer Detail-Informationen [c] kann auch eine neue Version (e) hochgeladen, der Verlauf der Datei betrachtet (d) oder die Datei gelöscht (f) werden.

Durch einen Klick auf die Schaltfläche „Löschen“ erfolgt die Löschung. Falls das Bild vorher verlinkt war muss nun noch der Link aus dem Artikel entfernt werden.