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

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

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


Subject: Re: [docbook] Best Practice in using sect1 - sect5


+1

2011/5/16 Fabián Mandelbaum <fmandelbaum@gmail.com>:
> (Oups, sorry Dave, you'll get this twice, I've clicked on the wrong
> 'reply' button)
>
> Our preferences balance on the <section>-everywhere side. Use
> <section> everywhere, and you won't have to think about it.
>
> I vote to ditch <sect1> to <sect5> elements from the next incarnation
> of docbook. <section> is enough.
>
> While we are here, I also vote to ditch some structures that only add
> to the confusion, for example:
>
> <section>
> <title></title>
> </section>
>
> <section>
> <info>
> <title></title>
> </info>
> </section>
>
> Why is there a need to have two ways to specify a section's (or
> article's, or book's...) title? Considering the fact that DocBook
> already has hundreds (literally) of elements, which makes it both
> flexible and powerful, but also steeps up the learning curve, I think
> the next version of DocBook deserves a thorough cleanup of everything
> that can lead to duality (like the sectN vs. section, or info+title vs
> title).
>
> section, section, section, just don't overdo it :-)
>
> Good luck.
>
> On Mon, May 16, 2011 at 6:18 AM, Dave Pawson <davep@dpawson.co.uk> wrote:
>> On Mon, 16 May 2011 07:08:32 +0000
>> "Bruce Wen" <wengm@mail.com> wrote:
>>
>>> Hi Guys,
>>>
>>>  Do you have some good experience in using tag sect1 - sect5? Are
>>> there any special techniques?
>>>
>>> Bruce Wen (GuangMing)
>>
>>
>> My preferences, YMMV!
>>
>> Use either nested sections or sect1..5
>> When nesting sect2 in sect1 etc,
>> Have
>>  sect1
>>    title
>>    sect2
>>     title
>>     sect3
>>
>> That is simply for appearance sake.
>> I think it looks better than
>> sect1
>>  title
>>   para
>>   para
>>   sect2
>>    title
>> etc.
>>
>> HTH
>>
>>
>>
>> --
>>
>> regards
>>
>> --
>> Dave Pawson
>> XSLT XSL-FO FAQ.
>> http://www.dpawson.co.uk
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>>
>>
>
>
>
> --
> Fabián Mandelbaum
> IS Engineer
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org
>
>



-- 
Principle Technical Writer
FuseSource
Phone: (781) 280-4174
E-Mail: ericjohnson@apache.org
Blog: http://documentingit.blogspot.com/
Twitter: finnmccumial


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