A namespace is similar to a directory or folder, while pages are similar to files. In DokuWiki you can use namespaces to categorize your pages.
Simply create pages with colons in the pagename. The token after the last colon will be the name of the page itself, while all other tokens are namespaces. All namespaces used in your pagename that don't exist already will be created automatically.
| Examples: | |
|---|---|
| example .example .:example | refers to the page “example” in the current namespace. |
| :example | refers to the page “example” in the root namespace. |
| ..example ..:example .:..:example | refers to the page “example” in the parent namespace |
| wiki:example | refers to the page “example” in the namespace “wiki”. The namespace “wiki” is located beneath the root namespace. |
| ns1:ns2:example :ns1:ns2:example | refers to the page “example” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the root namespace. |
| .ns1:ns2:example .:ns1:ns2:example | refers to the page “example” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the current namespace. |
| ..ns1:ns2:example ..:ns1:ns2:example | refers to the page “example” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beside the current namespace (i.e. both ns1 and the current namespace are beneath the same parent namespace, wherever according to the root namespace this parent may be located itself). |
| .ns1:ns2: .:ns1:ns2: | refers to the page “start” in the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the current namespace. (The default page can be named something other than “start” by adjusting the startpage configuration setting.) |
When all pages inside a namespace are removed (see delete a page) the namespace logically doesn’t exist anymore. DokuWiki usually deletes the now empty directory as well.
In order to rename a namespace manually you will have to:
data/pagesdata/media (if this exists)data/metadata/attic (or move that over as well, if you want to preserve old versions)For example, on a Unix host, you could:
mv /dokuwiki_base/data/pages/old_namespace /dokuwiki_base/data/pages/new_namespacemv /dokuwiki_base/data/media/old_namespace /dokuwiki_base/data/media/new_namespacerm -Rf /dokuwiki_base/data/meta/old_namespacemv /dokuwiki_base/data/attic/old_namespace /dokuwiki_base/data/attic/new_namespace rm -Rf /dokuwiki_base/data/attic/old_namespace
Note that the old_namespace and/or new_namespace words may need to be encoded if they are on a non-Latin character set (i.e. Greek, Russian, etc).
However, you will still have lots of junk left around. For example in data/changes.log, various files under cache (including the .idx files etc). If possible you could just start from a blank state as follows (again under Unix) but be warned that this will mean losing all your historical information (i.e. recent changes):
cat /dev/null > /dokuwiki_base/data/changes.logrm -Rf /dokuwiki_base/data/attic/*rm -Rf /dokuwiki_base/data/cache/?rm -Rf /dokuwiki_base/data/cache/*.idxrm -Rf /dokuwiki_base/data/cache/purgefile