Differences

This shows you the differences between two versions of the page.

--- namespaces [2021-07-28 17:53] – old revision restored (2020-10-04 17:28) bactram
+++ namespaces [2023-11-20 07:53] (current) – old revision restored (2023-10-27 11:45) saggi
@@ Line 1: / Line 1: @@
 ===== Creating Namespaces =====
@@ Line 11: / Line 9: @@
 In DokuWiki, pages are created as in every other wiki. Simply create a link to a non existing page, follow this link, and click on Create this page. See also [[.:page#create_a_page|Adding pages]].
-^  Examples:  ^^
+^  Examples:                                                                                                                                                                                                                                                                                                                                                                      ||
-|example\\ .example\\ .:example|refers to the page "example" in the **current** namespace.|
+| example\\ .example\\ .: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 **root** namespace.                                                                                                                                                                                                                                                                                |
-|..example\\ ..:example\\ .:..:example|refers to the page "example" in the **parent** 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.|
+| 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 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 **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: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 [[config:startpage]] configuration setting.)|
+| .ns1:ns2:\\ .:ns1:ns2:                  | refers to start page of the namespace ns2. The namespace ns2 is located beneath the namespace ns1; the namespace ns1 is located beneath the current namespace.\\ \\ Please refer to [[#Namespace Default Linking]] below how the start page is determined |
+| ~example\\ ~:example                    | refers to the page "example", using the current page as a namespace. Eg. if used on the page "foo:bar", the link will refer to "foo:bar:example". This is an effective way of creating sub-namespaces from existing pages.                                                                                                             |
 :!: Gotcha: The syntax for relative and absolute internal links is non-unique and complex relative to directory and filename conventions.
@@ Line 76: / Line 75: @@
 ===== Namespace Default Linking =====
-It is possible to link to the default file of a namespace by ending the linkid
+It is possible to link to the default page of a namespace by ending the linkid
 with a colon: ''%%[[foo:bar:]]%%''. Which page the link links to is dependent on the
 existence of certain named files. For ''%%[[foo:bar:]]%%'' the following pages are
@@ Line 89: / Line 88: @@
 The pages are checked in that order and whatever page is found first will be linked to. [[config:autoplural|Autoplural]] linking is not done for those links.
+See [[config:startpage]] to learn about configuring the startpage name (defaults to ''start'').
 ===== Interwiki Links =====
 DokuWiki supports Interwiki links. These are quick links to other Wikis.
 For example: [[wp>Wiki]] is a link to Wikipedia's page about Wikis. → Main article: [[doku>Interwiki]]