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 offiziellen Dokumentation.

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

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

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.

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

Die Namensräume der Mediendateien können über den Medienmanager eingesehen werden.

Alternativ können Namensräume auch über den 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.

Ein neuer Namensraum im DokuWiki lässt sich am Einfachsten während des 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.

Nach dem erfolgreichen 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 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 Mediendateien können neue Namensräume erzeugt werden, indem während des Hochladens einer Datei im Dateinamen der hochzuladenden Datei der neue Namensraum wie in den beiden vorigen Beispielen eingefügt wird.

Namensräume können - genau wie ganze Artikel oder 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 werden automatisch gelöscht, sobald die letzte in ihnen befindliche Seite oder Mediendatei gelöscht wurde.