This page describes various terms related to PmWiki.
:Configuration file: A specially-named PHP script file where local customizations can take place for a farm, a wiki, a group, or a page.
:Default configuration: The way Pm has chosen to set all settings, or an individual setting, by default. For example, $EnablePathInfo is disabled by default. A wiki with no local/config.php file is using the default configuration. Likewise, a farm that only defines $FarmPubDirUrl in farmconfig.php is using the default configuration.
:Farm: A group of wikis that share code. Content and formats may or may not be shared. For more farm-related terms, including several which have been deprecated, see WikiFarmTerminology
:Farm-wide configuration file: A WikiFarm's local/farmconfig.php file, where any settings (besides $FarmPubDirUrl) customize the default configuration for all of the wikis in a farm.
:Full page name: The full page name consists of a group and a name, e.g. Main.WikiSandbox
. The variable for the full page name is {$FullName}
, which for this page is PmWiki/Glossary
. Similarly, the variable for the group is {$Group}
which here is PmWiki
.
:Local configuration file: A specially-named PHP script where local customizations can take place for an individual wiki. For an entire wiki it's named local/config.php. Individual groups and pages can also have their own local configuration files.
:Local customization: Any deviation from the default configuration. A related phrase is "farm-wide customization".
:Page file name: The page file name is the name of the file that normally stores the data of a page in the directory wiki.d/
. This file name is normally built directly from the page name.
:Page link: A page link is something that is used to generate a link to a page. For example, the markup [[wiki sandbox]]
, [[(wiki) sandbox]]
, WikiSandbox
, Main/WikiSandbox
, [[Main/wiki sandbox]]
, [[Main.WikiSandbox | click here]]
, etc all specify a link to the page 'Main.WikiSandbox'. In each case PmWiki uses the context of the link to generate a page name from the page link -- normally by capitalizing each word found in the link and stripping any characters that aren't considered valid in page names.
:Page name: The page name is a string that PmWiki uses to refer to a page - i.e. it names the page. This could also be considered a handle for the page. The variable for the page name is simply called {$Name}
, which for this page is Glossary
.
-> Note that there is no whitespace in page names, and by default PmWiki capitalizes each word in a page's name. There is however a variable {$Namespaced}
where spaces have been inserted, e.g. for the page WikiSandbox this variable would be Wiki Sandbox
.
-> Note that PmWiki also uses the page name to locate per-group and per-page customization files in the local/
subdirectory. For example, browsing Main.WikiSandbox would cause local/Main.WikiSandbox.php
and local/Main.php
to be loaded if these files existed.
:Page title: A page title is the title element of a page, i.e. what is usually shown above the page and in the browser window's name. This title is normally set via the directive (:title:)
, but if no such directive is given the title will be automatically generated from the page name. The title of a page is accessed via either the variable {$Title}
or the variable {$Titlespaced}
. The latter differs in that it uses the spaced version of the name.
:Page URI: Page names are used in `URIs to tell PmWiki which page is to be loaded or acted upon. The normal form of a page URI is usually one of these two
--> http://www.example.com/pmwiki/pmwiki.php?n=Main.WikiSandbox
--> http://www.example.com/pmwiki/pmwiki.php/Main.WikiSandbox
-> Note that various aliasing and rewriting tricks can be used to modify this, but PmWiki expects to obtain a page name from the parameter 'n' or from the PATH_INFO
component following the URI of the script (pmwiki.php
).
-> Note that the parameter 'n' takes precedence over PATH_INFO
if both are available.
%trail% <<|Documentation Index|>>