[pmwiki-users] RFC: refactored introduction to wiki markup

John Rankin john.rankin at affinity.co.nz
Thu May 11 17:32:00 CDT 2006


On Thursday, 11 May 2006 11:50 PM, christian.ridderstrom at gmail.com wrote:
>On 11 May 2006, John Rankin wrote:
>
>> On Thursday, 11 May 2006 10:54 AM, Patrick R. Michaud <pmichaud at pobox.com> wrote:
>> >One of the issues with putting categories in the distributed docs
>> >is that it "eats" category names that the site might want to use
>> >for other purposes.  It also presumes the existence of something
>> >to display the category listing (which isn't currently the case
>> >in the distribution).
>> 
>> OK, scratch that idea. However, the proposal to categorize
>> documentation pages is still valid. A few options:
>><snip>
>
>I've been using an approach where I "tag" a page with a keyword that isn't 
>visible and then use (:pagelist:) to generate the listing. Today I'm 
>simply doing something like this:
>
>	(:comment pmwiki-markup-documentation:)
>
>But it'd look better if we'd write something like:
>
>	(:tag pmwiki-markup-documentation:)
>
>Then maybe we could expand (:pagelist:) to work as follows
>
>	(:pagelist tag=pmwiki-markup-documentation:)
>
>There may be much better alternatives to the word "tag" of
>course.
>
Nice; and "tag" is good!

I would add this to an enhanced "page attributes" function
suggested a while ago, whereby all page metadata is separated 
from page content into an attributes form.

-- 
JR
--
John Rankin






More information about the pmwiki-users mailing list