[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