====== Pagenames ======


Pagenames in **[[DokuWiki]]** are converted to lowercase automatically. Allowed characters are letters, digits, and in name internal position ((i.e. you cannot start or end names with them, resp. they will be eliminated at start or end of names)) the "special characters" ''.'', ''-'' and ''_''((effectively, only "." and "-" can be used since for "_" it will become unclear if the user or the system have put it, see next sentence in text)). All other special characters (i.e. other than letters and digits) are converted to underscores((or to "-" if you have changed your [[config#sepchar |sepchar setting]])) . Colons ('':'') are used to identify or, if necessary, create [[namespaces]].((you may get a "Permission Denied" error if your planned pagename contains a ":" which would - unintendedly - result in trying to create a namespace and / or a page where you have no rights to do so; this may happen if, e.g., a German user would aim for a page //title// like "[[Geheim: DokuWiki bereitet Übernahme von MediaWiki vor |Geheim: DokuWiki bereitet Übernahme von MediaWiki vor]]" (//Secret: DokuWiki prepares MediaWiki takeover//) on this server; compare this to "[[Geheim -- DokuWiki bereitet Übernahme von MediaWiki vor |Geheim -- DokuWiki bereitet Übernahme von MediaWiki vor]]"))

When the [[config#deaccent|deaccent]] config option is enabled (on by default) local and accented characters are converted to their descriptive equivalents (''ü'' becomes ''ue'') or deaccented versions (''á'' becomes ''a'').

An implicit constraint on length and beginning of pagenames is set by [[backlinks]] (first three characters must be letters).

Most templates, including the default, present the full pagename and the [[wiki:namespaces|namespaces]] in its path, at the top left corner of the page. For example this page's name is ''wiki:pagename''. ((This can be changed.  See, for example, the [[wiki:config#useheading]] setting.))

When linking to other Wikis using [[InterWiki]] links the name restrictions of these Wikis apply.

Even when [[wp>CamelCase]] or WikiWord is enabled in the [[config]] file the pagenames will remain lowercase.

===== Pagenames and Namespaces =====

You may picture namespaces as directories and pagenames as files inside them. 

Therefore the ''a:b:c'' pagename can be pictured as:

<file>

   root namespace (always present)
     |
     +-- 'a' namespace
           |
           +-- 'b' namespace
                 |
                 +-- 'c' pagename

</file>

Note that you can have a pagename and a namespace with the same name, at the same time, within any namespace. Back to the above example, the ''a:b'' pagename can be pictured as:

<file>

   root namespace (always present)
     |
     +-- 'a' namespace
           |
           +-- 'b' pagename (not to be confused with the 'b' namespace above)

</file>

This doesn't lead to conflicts, because DokuWiki treats the final token (the one after the last colon) as the name of the page itself, while all other tokens are namespaces.  

  * In ''a:b:c'', ''a'' and ''b'' are namespaces while ''c'' is a page.
  * In ''a:b'', ''a'' is interpreted as a namespace and ''b'' as a page.

See [[wiki:namespaces]] for more details.


===== Creating Pagenames =====

When your browser requests a pagename that doesn't already exist, DokuWiki may (depending on your access rights) present you with the option to create it. You can do this by directing your browser to the URL of the desired pagename or by creating a link to the new pagename on another DokuWiki page and following it with your browser.

If the pagename path contains namespaces that don't already exist, they will also be created.

See also:

  * [[wiki:faq:addpages|How to add pages?]]

===== Deleting Pages =====

If you edit a page and remove all its content then DokuWiki will delete the page, and the associated pagename.  (Note that the [[wiki:attic]] remains.)

===== Renaming Pages =====

See the full article [[wiki:tips:howto-rename-pages|here]].