This is the mail archive of the docbook-apps@lists.oasis-open.org mailing list .


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

markup/chunking issue


  i'm hoping this is the right mailing list for this question, since
it's not exclusively a docbook issue.

  in my document, i want chapters that contain sections and, frequently,
subsections and so on.  in addition, i'd like a chapter "intro" part,
not technically a section, that doesn't show up in the TOC.

  visually, i want to do something like this, and i've also marked
where i'd *like* to have chunking occur when i generate HTML:

<chapter>
  ... untitled short blurb about what this chapter is all about
      that stays on the same page as the chapter heading (is this
      an "abstract"?  maybe, not sure) ...
             --- page break ---
 <section>
 </section>
             --- page break ---
 <section>
  <section>        # first subsection stays on same HTML page as section
  </section>
             --- page break ---
  <section>
  </section>
 </section>
             --- page break ---
 <section>
   ... etc etc ...

so i want the very first section of the chapter to start a new chunk.
i can get that with the xsl param "chunk.first.sections" but, sadly,
that will also cause each subsequent level 2 section to chunk to
a new page as well, leaving a section header all by itself on a page,
which is not what i'm after.

is there a markup/chunking combination for this?  better yet, is
this a normal thing to want to do with a document?  i'm open to 
suggestions.

rday


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]