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] | [Elist Home]

Subject: DOCBOOK-APPS: Re: Using block elements inside para elements

Hash: SHA1

/ ion <vnhu38f93@subdimension.com> was heard to say:
| Personally I always separate block elements and para elements
| so that I never use block elements inside para elements, I am
| interested in what other people do here, well more specifically
| what the main docbook people advocate.

There are clearly two styles. I don't think there's a right answer.
Some people don't like blocks in paragraphs, so they write:

<para>Consider the following program fragment:</para>
<para>It consists of...</para>

Others recall their gradeschool english teachers definition of a
paragraph and think those three things are all one thought so they

<para>Consider the following program fragment:
It consists of...</para>

With $html.cleanup=1 and an XSL processor that understands exsl:node-set,
the markup comes out the same either way. Without the cleanup, the latter
leads to invalid HTML.

| If this topic should be moved to the docbook list then OK but
| I am not currently subscribed to the docbook list, only the
| docbook-apps so I would have to go and subscibe.

Yes, it's probably a topic that belongs on the docbook list.

                                        Be seeing you,

- -- 
Norman Walsh <ndw@nwalsh.com>      | A man is not necessarily
http://www.oasis-open.org/docbook/ | intelligent because he has plenty
Chair, DocBook Technical Committee | of ideas, any more than he is a
                                   | good general because he has plenty
                                   | of soldiers.--Chamfort
Version: GnuPG v1.0.6 (GNU/Linux)
Comment: Processed by Mailcrypt 3.5.7 <http://mailcrypt.sourceforge.net/>


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

Powered by eList eXpress LLC