This is an old revision of the document!
This document covers how the wiki is organized. This is of course a standard constantly in-flux. Any changes to the proposed layout should go through the wiki mailing list.
Generally speaking, the wiki is organized into a taxonomy that matches the main ADI site taxonomy. Products have catagories, and are seperated into various namespaces (see below). There are various things that don't have specific product catagories, which are a little looser in organization. Since it's easy to move things around after - don't worry too much about exactly where things go - try to think of where it makes the most sense, and put it there.
Some suggestions:
Here are the current namespaces.
These special pages exist in every namespace, and should not be used for other content.
review
- will list the pages needed for review in the current namespacesidebar
- will be the content for the current namespace's sidebarFor names of namespaces the same restrictions hold as for pagenames.
:
) are used to identify or, if necessary, create namespaces.A namespace is similar to a directory or folder, while pagenames are similar to files.
In the Wiki, we use namespaces to categorize the pages.
A default DokuWiki installation comes with built-in namespace:
You don't need to create namespaces separately; 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 by DokuWiki automatically.
Examples: | |
---|---|
example | refers to the page “example ” in the current namespace. |
:example | refers to the page “example ” in the root namespace. |
..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 | 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 | 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 | 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). |