Re: Sectional Editing

Murray Altheim <[email protected]> Thu, 11 Oct 2007 01:59:05 +1300
Newsgroups	gmane.comp.java.jspwiki.user
Message-ID	<[email protected]>
Alex Samad wrote:
> On Wed, Oct 10, 2007 at 09:14:50PM +1300, Murray Altheim wrote:
>> 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>
>>
> Just looking at this from a different angle, this is like have x many wiki 
> pages making up a wiki page. 

Well, no, not really. It mimics ISO HTML (ISO/IEC 15445), which uses
nested <div1> through <div6> elements (a division level to match each
heading level), which steals its idea from DocBook, which steals its
idea from technical documentation's use of hierarchical sections,
where you'd in outline have something like

    sect1
      sect2
        sect3
          sect4
            sect5
              sect6

This is extremely common in technical documentation, and is found all
over the Web, even though one seldom sees the "correct" formatting, of
indenting each nested level within its parent. If, for example, sect1
was considered the entire document, with sect2 a book, sect3 might
be a chapter, and sect4 a section within a chapter, sect5 a subsection,
and sect6 a sub-subsection. It's all somewhat arbitrary, but hopefully
this is clear. One can treat any section level (within a different
context) as a document in its own right, composing the parent level
from a sequence of children. etc.

See also: https://www.cs.tcd.ie/15445/15445.html

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