====== 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.

===== Bilder und Dokumente hochladen =====

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.

{{:lernstatt:dokumentation:dokuwiki:img:button_medienmanager.png}}

Der nun geöffnete Medien-Manager ist folgendermaßen aufgebaut: Der Bereich auf der linken Seite <font inherit/inherit;;#FF0000;;inherit>(a)</font>    zeigt sämtliche vorhandenen [[dokumentation:dokuwiki:dokuwiki_namespaces|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 [[dokumentation:dokuwiki:dokuwiki_artikel_bearbeiten#alte_lernstatt-artikel_ueberarbeiten|Ü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 [[dokumentation:dokuwiki:dokuwiki_artikel_freigeben#dokuwikiartikel_freigeben|Veröffentlichungsrechte]] für die Datei vorhanden sind). Ist dies geschehen muss auf der rechten Seite <font inherit/inherit;;#FF0000;;inherit>(b)</font>    auf die Schaltfläche "Hochladen" <font inherit/inherit;;#FF0000;;inherit>(d)</font>    geklickt werden. Unter Dateiauswahl <font inherit/inherit;;#FF0000;;inherit>[c]</font>    werden außerdem die bereits im ausgewählten Namensraum befindlichen Dateien angezeigt und nach einem Klick auf die Schaltfläche "Suchen" <font inherit/inherit;;#FF0000;;inherit>(e)</font>    können zudem spezifische Dateien nach Namen gesucht und weitere Informationen zu diesen angezeigt werden.

{{:lernstatt:dokumentation:dokuwiki:img:medienmanager_allgemein.png}}

Nach dem Klick auf die Schaltfläche "Hochladen" muss nun die gewünschte Datei ausgewählt werden. Durch einen Klick auf "Dateien auswählen" <font inherit/inherit;;#FF0000;;inherit>(a)</font>    ö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 <font inherit/inherit;;#FF0000;;inherit>(b)</font>    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" <font inherit/inherit;;#FF0000;;inherit>[c]</font>    <font inherit/inherit;;inherit;;inherit>.</font>

Die [[dokumentation:dokuwiki:dokuwiki_namespaces#aufbau_von_namensraeumen_und_adressen|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 <font inherit/inherit;;#FF0000;;inherit>(d)</font>    <font inherit/inherit;;inherit;;inherit>.</font>

{{:lernstatt:dokumentation:dokuwiki:img:medienmanager_hochladen.png}}

===== Bilder und Dokumente einbinden =====

Ist das Bild oder das Dokument erfolgreich hochgeladen kann es nun im konkreten Artikel verwendet werden. Dazu muss der Artikel zunächst zum [[dokumentation:dokuwiki:dokuwiki_artikel_bearbeiten#seite_bearbeiten|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 {{:lernstatt:dokumentation:dokuwiki:img:datei_verlinken.png?linkonly|Schaltfläche "Link einfügen/editieren" }} geklickt werden. Als nächstes muss aus der Liste unter "Link-Typ" <font inherit/inherit;;#FF0000;;inherit>(a)</font>    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" <font inherit/inherit;;#FF0000;;inherit>(b)</font>    der Server nach der gewünschten Datei durchsucht und diese ausgewählt werden oder die aus [[dokumentation:dokuwiki:dokuwiki_namespaces|Namensraum]] und Dateiname gebildete [[dokumentation:dokuwiki:dokuwiki_namespaces#aufbau_von_namensraeumen_und_adressen|Adresse]] der auf dem DokuWiki-Server [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_hochladen|hochgeladenen Datei]] direkt in das Textfeld unter "link to media file" <font inherit/inherit;;#FF0000;;inherit>[c]</font>    eingetragen werden. Abschließend muss alles mit einem Klick auf die Schaltfläche "OK" <font inherit/inherit;;#FF0000;;inherit>(d)</font>    bestätigt werden.

{{:lernstatt:dokumentation:dokuwiki:img:datei_verlinken_menue.png?1145x562}}

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" <font inherit/inherit;;#FF0000;;inherit>(a)</font>    angeklickt und dann //"/lib/exe/fetch.php?media="// in das Textfeld unter "URL" <font inherit/inherit;;#FF0000;;inherit>(b)</font>    eingetragen werden. Nun muss dahinter die [[dokumentation:dokuwiki:dokuwiki_namespaces#aufbau_von_namensraeumen_und_adressen|Adresse]] der Bilddatei eingefügt werden. Diese kann im Medien-Manager nach einem Klick auf das hochgeladene Bild {{:lernstatt:dokumentation:dokuwiki:img:bildadresse_ablesen.png?linkonly|abgelesen}}  werden. Es kann dann noch das Bildformat wie etwa die Breite und die Höhe oder die Ausrichtung des Bildes geändert werden <font inherit/inherit;;#FF0000;;inherit>[c]</font>    . Es wird außerdem - wenn die eingegebene Bildadresse korrekt war - eine Vorschau des Bildes angezeigt <font inherit/inherit;;#FF0000;;inherit>(d)</font>    . Abschließend muss wieder mit einem Klick auf die Schaltfläche "OK" <font inherit/inherit;;#FF0000;;inherit>(e)</font>    bestätigt werden.

{{:lernstatt:dokumentation:dokuwiki:img:bild_einbinden.png?1143x654}}

Alternativ kann auch der original [[dokumentation:dokuwiki:dokuwiki_artikel_erstellen#inhalte_erstellen_und_bearbeiten_im_editor|DokuWiki-Editor]] verwendet und das Bild in der [[https://www.dokuwiki.org/wiki:syntax|offiziellen DokuWiki-Syntax]] eingebunden werden.

===== Bilder und Dokumente umbenennen und verschieben =====

Das Umbenennen von Bildern und Dokumenten sowie das Verschieben derselben in einen anderen [[dokumentation:dokuwiki:dokuwiki_namespaces|Namensraum]] ist ebenfalls möglich. Das Vorgehen ähnelt dabei stark dem Verfahren beim [[dokumentation:dokuwiki:dokuwiki_artikel_verschieben#seite_verschieben|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 <font inherit/inherit;;#FF0000;;inherit>(a)</font>    unter Mediendateien die entsprechenden Namensräume oder Bilder und Dokumente verschoben werden müssen <font inherit/inherit;;#FF0000;;inherit>(b)</font>    . Diese können außerdem durch einen Klick auf das kleine Symbol "Dieses Element umbenennen" <font inherit/inherit;;#FF0000;;inherit>[c]</font>    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 <font inherit/inherit;;#FF0000;;inherit>(d)</font>    wieder automatisch.

{{:lernstatt:dokumentation:dokuwiki:img:bild_verschieben.png?1147x794}}

===== Bilder und Dokumente löschen =====

Bilder und Dokumente können auch wieder entfernt werden. Dazu muss zuerst der [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_hochladen|Medienmanager geöffnet]] und dann in der Dateiauswahl <font inherit/inherit;;#FF0000;;inherit>[c]</font>    oder der Suche <font inherit/inherit;;#FF0000;;inherit>(e)</font>    die entsprechende Datei gefunden und angeklickt werden.

{{:lernstatt:dokumentation:dokuwiki:img:medienmanager_allgemein.png?1147x817}}

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

{{:lernstatt:dokumentation:dokuwiki:img:bild_loeschen.png}}

Durch einen Klick auf die Schaltfläche "Löschen" erfolgt die Löschung. Falls das Bild vorher [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_einbinden|verlinkt]] war muss nun noch der Link aus dem Artikel entfernt werden.