====== DokuWiki: Namespaces ======
Ein wichtiges Konzept des DokuWiki-System ist das Konzept der Namespaces, im Folgenden auch Namensräume genannt. In diesem Artikel wird das Konzept der Namensräume zuerst allgemein erklärt und dann die wichtigsten pratktischen Operationen mit Namensräumen für das Arbeiten im Lernstatt-DokuWiki vorgestellt. Weitere Informationen zu Namensräumen gibt es in der [[https://www.dokuwiki.org/namespaces|offiziellen Dokumentation]].
===== Allgemeines zu Namensräumen =====
Namensräume sind vergleichbar mit Ordnern im Dateisystem eines PCs. In einem Namensraum können einzelne Seiten gespeichert oder weitere Namensräume geschachtelt werden. Namensräume können erstellt, verschoben und wieder gelöscht werden. Es gibt zudem mehrere Wege sich Namensräume und deren Inhalte anzeigen zu lassen.
Namensräume dienen zum Ordnen von Artikeln und Seiten im DokuWiki und ermöglichen außerdem das einfache Setzen von Berechtigungen für eine Gruppe von Seiten in der [[dokumentation:dokuwiki:dokuwiki_rechteverwaltung|Rechteverwaltung]].
===== Aufbau von Namensräumen und Adressen =====
Ein Namensraum besteht aus einem Namen gefolgt von einem Doppelpunkt: z.B __//lernstatt:// __
Namensräume können ineinander geschachtelt werden, hinter einem Namensraum können also beliebige weitere durch Doppelpunkte abgetrennte Namensräume stehen: z.B //lernstatt:dokumentation:__dokuwiki:__ //
Dahinter steht bei einer Seitenadresse der Seitenname oder beim Pfad einer [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_hochladen|hochgeladenen Mediendatei]] der Dateiname gefolgt von einem Punkt und der Dateiendung: z.B //lernstatt:dokumentation:dokuwiki:__dokuwiki_namespaces__// für einen Artikel oder //lernstatt:dokumentation:dokuwiki:img:__seite_speichern.png__// für eine Bilddatei//.//
===== Betrachten von Seiten und Namensräumen =====
Die allgemeine Struktur des DokuWikis und der Aufbau der Namensräume lässt sich am einfachsten im Übersichtsmenü ansehen. Dazu muss zunächst im Drop-down-Menü die Schaltfläche "Übersicht" ausgewählt werden.
{{:lernstatt:dokumentation:dokuwiki:img:button_uebersicht.png?1145x562}}
Im nun geöffneten Übersichtmenü können alle vorhandenen Namensräume (a) und alle in ihnen befindlichen Seiten (b) angesehen werden. Alle Namensräume liegen dabei im Wurzel-Namensraum "root".
{{:lernstatt:dokumentation:dokuwiki:img:uebersicht.png}}
Die Namensräume der Mediendateien können über den [[dokumentation:dokuwiki:dokuwiki_mediendateien|Medienmanager]] eingesehen werden.
Alternativ können Namensräume auch über den [[dokumentation:dokuwiki:dokuwiki_artikel_verschieben#seite_verschieben|baumbasierten Move-Manager]] eingesehen und wie später erklärt auch verschoben werden.
Es wird zudem auf jeder Seite die Adresse inklusive der darin enthaltenen Namensräume des jeweiligen Artikels angezeigt.
{{:lernstatt:dokumentation:dokuwiki:img:namensraum_seite.png}}
===== Namensräume erstellen =====
Ein neuer Namensraum im DokuWiki lässt sich am Einfachsten während des [[dokumentation:dokuwiki:dokuwiki_artikel_erstellen#seite_anlegen|Anlegens einer neuen Seite]] erstellen.
Dazu müssen in der Adresse der neu anzulegenden Seite ein oder mehrere neue Namensräume eingefügt werden. Dies geschieht, indem in der Adresse an beliebiger Stelle der Name des neuen Namensraums - hier //test// - gefolgt von einem Doppelpunkt eingefügt wird.
{{:lernstatt:dokumentation:dokuwiki:img:namespace_neu.png}}
Nach dem erfolgreichen [[dokumentation:dokuwiki:dokuwiki_artikel_erstellen#seite_speichern|Anlegen der Seite]] befindet sich diese nun im neu erstellten Namensraum - hier //test //- welcher seinerseits eventuell wieder in einen anderen Namensraum - hier //lernstatt-todo// - geschachtelt ist. Dieser neue Namensraum kann nun wie oben beschrieben angesehen werden.
Eine weitere Möglichkeit zum Erstellen eines neuen Namensraums besteht während des [[dokumentation:dokuwiki:dokuwiki_artikel_verschieben#seite_umbenennen|Umbenennens]] einer Seite. Auch hier lässt sich durch Einfügen eines neuen Namensraumes - Name gefolgt von einem Doppelpunkt - während des Umbenennens einer Seite diese in den entsprechenden Namensraum verschieben welcher dadurch gleichzeitig erzeugt wird.
Auch für [[dokumentation:dokuwiki:dokuwiki_mediendateien|Mediendateien]] können neue Namensräume erzeugt werden, indem während des [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_hochladen|Hochladens einer Datei]] im Dateinamen der hochzuladenden Datei der neue Namensraum wie in den beiden vorigen Beispielen eingefügt wird.
===== Namensräume umbenennen und verschieben =====
Namensräume können - genau wie ganze [[dokumentation:dokuwiki:dokuwiki_artikel_verschieben#seite_verschieben|Artikel]] oder [[dokumentation:dokuwiki:dokuwiki_mediendateien#bilder_und_dokumente_umbenennen_und_verschieben|Mediendateien]] - einfach mit dem Move-Plug-in verschoben oder umbenannt werden. Dadurch ändert sich der Namensraum in der Adresse aller im veränderten Namensraum befindlichen Seiten und Dateien.
===== Namensräume löschen =====
Namensräume werden automatisch gelöscht, sobald die letzte in ihnen befindliche Seite oder Mediendatei gelöscht wurde.