[pmwiki-users] Newbie Alert!!! - Simple Database?

Hans design5 at softflow.co.uk
Mon Oct 29 08:41:49 CDT 2007


Re: info on concepts like directives, pagelists, templates.

* Directives: usually refers to a pmwiki markup of syntax (:......:),
but could also mean any other kind of markup pmwiki uses.
scripts/stdmarkup.php gives lots of examples what pmwiki uses.
These are basically substitution rules for pmwiki's replacement
'engine'.

* Pagelists: refers to lists of pages, usually in form of links, but
could be in other forms, generated by pmwiki's (:pagelist ..... :)
markup (directive). How to use the (:pagelist ...:) please read the
page in the PmWiki documentation.  PmWiki's search results are a
special kind of pagelist as well, using different markup
(:searchresults ..:) but same functions, parameters etc.

* Templates: There are at least 3 different meanings in pmwiki:
 1.) Skin template files, with extension .tmpl, in a skin subdirectory.
 These are templates for HTML pages the skin function uses to
 construct the page with layout and content.
 
 2.) Pagelist templates: formats for the pagelist output, called with
 the pagelist fmt= parameter. Ususally stored on wiki pages
 Site.PagelistTemplates and Site.LocalTemplates (the first is pmwiki's
 distributed default, the second should be used for local custom
 templates or modified default templates).
 
 3.) Templates used for form processing: Fox and PmForms are using
 templates for their form output. A  template gets filled with values
 from input fields or processed input fields, then posted to some page
 location on the current page or a different page.
 
 4.) Templates used by the (:include ... :) markup: This markup is for
 including another page, or parts of another page. But it can also be
 used to include a template page, which it then fills with replacement
 variables passed inside the markup. FoxForum uses this to
 generate the forum pages. A display template gets included again and
 again for each forum post, but filled with different values from each
 message. By changing the template, the output layout and look can be
 changed for all messages on all pages instantly, i.e. content (data)
 is separated from display.

 
hope this helps a little.

Hans




More information about the pmwiki-users mailing list