Re: Sectional Editing

Murray Altheim <[email protected]> Wed, 10 Oct 2007 21:14:50 +1300
Newsgroups	gmane.comp.java.jspwiki.user
Message-ID	<[email protected]>
Dirk Frederickx wrote:
> Evan,
> 
> I've added a reply on jspwiki.org. Hope this is useful to you.
> 
> So far, the feature is only available in brushed-template.
> In jspwiki v2.5.xx, the Brushed-Template was ported to jspwiki, and
> most of the stuff is now part of the default template.
> 
> However, sectional-editing was not part of the port, yet...
> We are considering to improve sectional-editing allowing multiple user
> to edit sections in parallel. And this needs some more time..

Dirk,

Waayy back when, in the mid-90s, I developed an HTML DTD that enforced
level'd sections, a feature that also showed up in the ISO version of
HTML but not in HTML 4 or XHTML 1. I think at one time I'd developed
an XHTML DTD based on the modular DTD that did something similar, all
of which is likely influenced by the section markup of DocBook. What
am I talking about? Basically, a more rigid <div> structure that would
likely be useful on JSPWiki, iff we wanted that level of structure. In
some of the designs (of my own and the ISO work) there was even the
use of <div1> through <div6> but this would have required browser
support so I opted for using 'class' attributes to contain the section
level. This is now called "microformats" by some people (not me).

The markup would be something like this:

   <body>
     <div class="sect1">
       <h1>Section 1 Title</h1>
       ...
       <div class="sect2">
         <h2>Section 2 Title</h2>
         ...
         <div class="sect3">
           <h2>Section 3 Title</h2>
           ...
         </div><!-- end sect3 -->
       </div><!-- end sect2 -->
       <div class="sect2">
         <h2>Section 2 Title</h2>
         ...
       </div><!-- end sect2 -->
     </div><!-- end sect1 -->
   </body>

I've looked at the JSPWikiMarkupParser class a few times with some
mind to generating markup like the above based on an author's use
of heading markup. This would fit right in with sectional editing,
as well as providing better boundaries for CSS, for transclusions,
etc.

If someone wants to add a feature creating this markup I'm willing
to provide the XHTML DTD that would validate it. When we get to
having more robust metadata support it'd be possible to even add
metadata at a section level, though for most people this is probably
overkill.

Murray

...........................................................................
Murray Altheim <murray07 at altheim.com>                           ===  = =
http://www.altheim.com/murray/                                     = =  ===
SGML Grease Monkey, Banjo Player, Wantanabe Zen Monk               = =  = =

       Boundless wind and moon - the eye within eyes,
       Inexhaustible heaven and earth - the light beyond light,
       The willow dark, the flower bright - ten thousand houses,
       Knock at any door - there's one who will respond.
                                       -- The Blue Cliff Record