It's not an XXE bug, it's a feature of the docbook design. I forget all
the reasons for it, but it was definitely a deliberate decision, not an
accident. I believe that the issue is discussed at length in the docbook
mail archive (http://lists.oasis-open.org/archives/docbook/ ), if you
want to check it out for yourself.

A more technical person can correct me, but I suspect that inserting
sections in any old place complicates the programming side of things
(like XSL style sheets) a lot. And programmability is the point of XML,
I think. Speaking as a tech writer who has lived with docbook for
several years), it has not proved to be a very severe restriction and
may even have improved my writing :-). 

Ciao,
Denis
 

On Thu, 2003-10-02 at 15:37, Michel Kergoat wrote:
> Hello!
> I see this issue as an "intellectual bug".
> I do not understand why one could not insert a <section> between two 
> <para> excepted maybe an overdose of "computer cartesianism".
> Are there (shouldn't it be) some authors in the docbook's commities ?
> I say this because I do sometimes take my head between my hands asking 
> why I could not do something that is natural with my mind... And I can 
> not choose between xxe or docbook's fault at first tight.
> But keep smiling, I'm still using xxe and docbook and they are better 
> and better, and I think I write well with...
> 
> Now, the "killer" question : we are several asking for a "layout mode", 
> that is, an easy and productive way to work at the layout of a (docbook) 
> document. As I did mail this list, you seems to find this interesting 
> and a good / reasonable wish. What is it on, if something is, whith this 
> issue?
> Cheers
> Michel:-)
> 
> Denis Bradford a ?crit:
> 
> >I believe that docbook does not allow subsections in the position you
> >want, and that it must be the last element in the parent section. It
> >does take some getting used to, but you have to organize your content
> >accordingly. So, you cannot have any content after the subsection
> >(except another subsection). For example:
> >
> ><section>
> >  <para></para>
> >  <section>
> >    <para></para>
> >  </section>
> >  <section>
> >    <para></para>
> >  </section>
> ></section>
> >
> >Good luck,
> >Denis
> >
> >On Mon, 2003-09-29 at 06:44, Carmona Perez, David wrote:
> >  
> >
> >>Thanks,
> >>
> >>The problem is that I had:
> >>
> >><section>
> >>    <para>
> >>    </para>
> >><!-My position is here-->
> >>    <para>
> >>    </para>
> >></section>
> >>
> >>And the DTD forbids adding a section in the middle of two para's.  The 
> >>program doesn't warn you of this.  If I remove the last para everything is 
> >>ok.
> >>
> >>--------
> >>David
> >>
> >>-----Mensaje original-----
> >>De: David Cramer (Tech Pubs) [mailto:dcramer at motive.com]
> >>Enviado el: domingo, 28 de septiembre de 2003 18:20
> >>Para: Carmona Perez, David; xmleditor-support at xmlmind.com
> >>Asunto: RE: [XXE] Sub-sections problem
> >>
> >>It takes a little getting used to, but once you do it makes sense and you 
> >>see it's a graceful solution to the "wysiwyg v. control of markup" problem. 
> >>Use the node path bar to select the last child of the section and then 
> >>"Insert after":
> >>
> >><book>
> >>  <title>Foo</title>
> >>  <chapter>
> >>    <title>Blah</title>
> >>    <section>
> >>      <title>blah</title>
> >>        <para>Use the node path bar to select this para and
> >>        do an insert after to insert a section</para>
> >>    <!-- ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -->
> >>    </section>
> >>  </chapter>
> >></book>
> >>
> >>Be sure to read the 'being productive' page in the help 
> >><http://www.xmlmind.com/xmleditor/_distrib/docs/user/userguide4.html>.
> >>
> >>David
> >>
> >>-----Original Message-----
> >>From: Carmona Perez, David [mailto:DPerezCar at fcc.es]
> >>Sent: Thursday, September 25, 2003 6:35 AM
> >>To: xmleditor-support at xmlmind.com
> >>Subject: [XXE] Sub-sections problem
> >>
> >>
> >>Hi all,
> >>
> >>I'm evaluating the XMLMind editor, for creating DocBook documentation, but 
> >>have a I can't inserting a <sect2> element inside a <sect1> element. It 
> >>simply doesn't appear in the list.
> >>The same happens with adding a <section> element inside a <chapter> element.
> >>
> >>I've used the DocBook | Book template.
> >>
> >>Does anyone know the cause?
> >>Thanks in advance for any answer.
> >>--------
> >>David
> >>
> >>--
> >>XMLmind XML Editor Support List
> >>xmleditor-support at xmlmind.com
> >>http://www.xmlmind.com/mailman/listinfo/xmleditor-support
> >>    
> >>
> >
> >
> >--
> >XMLmind XML Editor Support List
> >xmleditor-support at xmlmind.com
> >http://www.xmlmind.com/mailman/listinfo/xmleditor-support
> >
> >  
> >
> 
> 



Reply via email to