OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

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

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.

On Thu, Mar 1, 2012 at 12:13 PM, Frank Arensmeier <farensmeier@gmail.com> 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: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]