PmWiki | PmWiki / SitePages

This page will likely be combined with special pages

this is a first suggestion; maybe the previous page, about headers and footers can be included in here, or maybe we can make pages to describe in detail every one of the special site pages -Radu

Starting sometime close to the end of PmWiki v2 beta, a new mechanism was added under the push of skin designers, that allows for easier maintenance of common site content: Site pages.

At the same time, lots of administrative pages from the Main group were moved to the group Site. Now, in order to change how these various page elements look, an admin can simply use the wiki editor rather than going down into a config file with a text editor.

Note: The Site group is password protected by default. In order to change pages in the Site group you will need to set the password. Refer to Initial Setup Tasks for more details.

Currently, the following pages are part of Site, and various skins can (and already do) define more:

Side Bar: the main navigation mechanism of pmwiki
Edit Form: the form used to edit, uses specific markup developed specifically for this page
Inter Map: list external Internet sites shortcuts. See InterMap documentation.
Page Actions: contains the 'action' links (like Browse, Edit, History, Uploads, etc.), to be placed at the top of the page. See Site Page Actions for more information.
Page Not Found: the text shown when a page is not found (usually when a new page is to be created)
Search: the text shown when someone makes a search using the built-in PmWiki search facilities, i.e. (:searchbox:)
Edit Quick Reference: contains the 'help' text that appears at the bottom of the edit window (before the preview area)
Upload Quick Reference: contains the 'help' text that appears when uploading a file with Attach:file.ext at the bottom of the upload window

Note: some older skins will not support these, and still use the older Main.<SitePageName>, from either wikilib.d or wiki.d.

Questions and Answers

How do I customize the edit form?

PmWiki allows a WikiAdministrator to customize PmWiki's edit window by modifying the Site.EditForm template page. Some skins customize the $PageEditFmt variable which overrides the edit form, either making it inoperative or changing the default template page. It's even possible to allow an individual user to have their own custom edit page. See Cookbook:UserConfigurations and Cookbook:EditFormSamples.

How do I set one header or footer for all pages/groups?

The answer, which is related to this page in many ways, is found in a Q&A on PmWiki.GroupHeaders.