[pmwiki-users] Feature request: Action lists in skins

[Patrick R. Michaud]

On Tue, Apr 05, 2005 at 03:43:24PM -0400, David Spitzley wrote:
> >>> "Patrick R. Michaud" <pmichaud at pobox.com> 04/05/05 3:06 PM >>>
> Except how does this resolve the original purpose of this thread, 
> which was to have skin-invariant places for *actions*?  Just saying
> we'll allow top/bottom/left/right bars seems to have totally
> sidetracked
> this issue, which just shows that admin preferences aren't all that
> uniform, no?  When there's little uniformity, simplicity (with
> guidelines
> to the available "complex" choices) is probably best.
> ----------------------------------
> 
> Ok, then maybe the "problem" is that we need a page (or perhaps a
> better/different page if one is extant) on using wiki pages as
> structural elements in .tmpl files or (:directives:), perhaps with a
> worked example of each.

The description is currently in 
http://www.pmwiki.org/wiki/PmWiki/LayoutAdvanced, and perhaps it's in
a Cookbook recipe as well, but here's a slightly better description.

To have a template (.tmpl file) include/display the contents of another
wiki page, simply use

    <!--wiki:SomeGroup.SomePage-->

where SomeGroup.SomePage is the name of the page to be displayed.
$-substitutions work here, so the template file can specify

    <!--wiki:$Group.SomePage-->

which says to use "SomePage" within the group of the current page.
The directive can specify multiple pages to be examined, and only
the first of these is displayed, thus

    <!--wiki:$Group.SomePage Main.SomePage-->

displays "SomePage" in the current group if it exists, and Main.SomePage
if it doesn't.  To always display Main.SomePage, even if $Group.SomePage
exists, use something like

    <!--wiki:$Group.SomePage-->
    <!--wiki:Main.SomePage-->

which displays "SomePage" in the current group if it exists, and follows
that with Main.SomePage.


Within page markup, the (:include ...:) directive is used to include/
display the contents of another wiki page.

Pm