[Pmwiki-users] Re: PmWiki development

Christian Ridderström chr
Wed Jun 9 17:01:46 CDT 2004


Another example when nested groups can be useful.

> Patrick R. Michaud wrote:
> > I still haven't seen an instance where it's really needed or useful
> > (although I'm looking into the stuff that Jason Perkins wrote about a
> > few days ago).

Jason's example:

> I've got this code:
> 
> namespace Outer
> {
>    namespace Inner
>    {
>      public class MyClass
>      {
>        public void MyMethod() { ... }
>        public void AnotherMethod() { ... }
>      }
>    }
> }
> 
> In the current implementation [snip...]
>
> [..snip] have to write [[Outer_Inner_MyClass_AnotherMethod]]. Also, the
> page names are not suitable for printing
> 
> With nested pages I have
> 
> /Docs/Outer/Inner/MyClass/MyMethod
> 
> Linking from MyMethod to AnotherMethod is just [[AnotherMethod]].

I came across a similar case where I wanted to document a file format
(it's a LyX layout-files that's used to determine how paragraph
environments should be rendered). Here's an example of a snippet:

	Style Standard
	  Margin            Static
	  LatexType         Paragraph
	  LatexName         dummy
	  ParIndent         M
	  ParSkip           0.4
	  Align             Block
	  AlignPossible     Block, Left, Right, Center
	  LabelType         No_Label
	End

where I'd like @@Style@@ to link to a page that describes that keyword and
so on. There's an added twist here since I want to be able to document
both the current stable version *and* the development version. Even
thought these two file formats are mostly identical, it's interesting to
be able to modify the development version separately, for instance in
order to discuss how the format should be changed.

A possible page hierarchy for the case above could look like this:

	LayoutFile/
		1.3/
			Style
			LatexType
			AlignPossible
		1.4/
			AlignPossible

where a link in 'LayoutFile/1.4/AlignPossible' that refers to 'Style' 
should end up pointing to 'LayoutFile/1.3/Style'.

Jason talks about adding a "resolver function" that would determine which 
page a link should resolve to. This makes a lot of sense to me.

/Christian

-- 
Christian Ridderstr?m                           http://www.md.kth.se/~chr





More information about the pmwiki-users mailing list