00728

Pico's message clarifies for me the value of having a "trail=-PageName" option to pagelist. I had wondered about the potential value of having an "exclude pages from this trail" option, but didn't recognize an application for it until just now.

Instead of having to maintain the extra pages in the DocumentationIndex in a >>comments<< section, we could have PmWiki.FAQ use two pagelist directives:

    (:pagelist trail=PmWiki.DocumentationIndex ...  :) 
    (:pagelist group=PmWiki trail=-PmWiki.DocumentationIndex ...  :) 

The first grabs pages from the trail, the second grabs any pages in the PmWiki group that weren't on the trail.

Similarly, at the bottom of the DocumentationIndex page we could do:

    !! Other PmWiki documentation pages
    (:pagelist group=PmWiki trail=-DocumentationIndex fmt=simple:)

and we'd get a nice bullet list of any pages in the PmWiki group that weren't already listed in the DocumentationIndex.

This would also be useful for categories -- a Category.* page could explicitly list some of the pages in the category (where order is important), and the Category.GroupFooter could contain:

    (:pagelist link=Category.{$Name} trail=-Category.{$Name}:)

which would display any pages in the category that aren't already listed on the category page.

Cooooool. I'll have to keep this in mind for a future upgrade. :-)