Next in thread → Next in month →

Re: [docbook-apps] section element only allows one subtitle, why?

From
Aaron DaMommio <>
Date
2012-03-01T20:55:00+00:00
ID
CAOm3+YwNJz5+-zXPY6t1Cg6K=
Thread
Re: [docbook-apps] section element only allows one subtitle, why?
Frank,
A subtitle in DocBook is for additional information to follow the
title. It isn't for breaking up a block into subsections or demarking
areas of the text. You can't put it just anywhere in the block.

It sounds like what you are looking for is a <bridgehead>  -- a
heading that can be placed between paragraphs. But that's one of the
elements eliminated from Simplified DocBook.

I don't see an option in Simplified Docbook that is simpler than just
nesting sections.
--Aaron

On Thu, Mar 1, 2012 at 12:13 PM, Frank Arensmeier <> wrote:
> Hi.
>
> Just a quick question. I am working with simplified docbook where the element "article" is the top level element. Mostly because the "normal" set of docbook elements includes a large number of elements that are totally unnecessary for kinds of documentation other than e.g. software documentation. So, I feel that simplified docbook is more than enough.
>
> My question is why does the "section" element only allows one single subtitle element? Are there any particular reasons for this? Documents with a rather simple structure (title, subtitle, section , title, subtitle, para, subtitle, para) are easily being cluttered with nested sections (on places where a simple subtitle would be so much more handy). Or am I missing something?
>
> Cheers
> /frank
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: 
> For additional commands, e-mail: 
>



-- 
--------------------------------------
Aaron DaMommio: Husband, father, writer, juggler, and expert washer of dishes.
- My blog: http://aarondamommio.blogspot.com
- Need a juggler?  http://amazingaaronjuggler.blogspot.com/
=======================================
Next in thread → Next in month →