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

Subject: RE: DOCBOOK: itemized list within <para> or after </para>??

Semantically, there are several situations like this one.
For example display equations that appear in the middle of
a paragraph. Or, in legal texts, you'll sometimes see a 
citation displayed as a block, but in the middle of a sentence 
or a paragraph. If your mindset or processing can't stand it 
("now is this inline or block, oh my oh my"), it's usually 
possible to rephrase the text so that it refers to whatever
should have been displayed at that spot.

There was a discussion about this some time ago in xml-doc 
list [1].

kind regards
Peter Ring

[1] http://groups.yahoo.com/group/xml-doc/message/1724

-----Original Message-----
From: Robert P. J. Day [mailto:rpjday@mindspring.com]
Sent: 26. juli 2002 19:41
To: docbook mailing list
Subject: DOCBOOK: itemized list within <para> or after </para>??

  ok, this is *really* anal retentive, but i'll bet folks have
an opinion on it.

  if i want an opening paragraph, followed by a list, as in:

  Before you try to make your own beer, you should have the
following at hand:

  * hops
  * barley
  * water
  * hard liquor for when you get frustrated

  is it proper to make the itemized list a sub-element of the
paragraph, or to close the <para> and have the itemized list
as the next element at the same level?

  aesthetically, it doesn't appear to make any difference, but
TDG under "Para" suggests that "Some processing systems may find 
the presence of block elements in a paragraph difficult to
handle". (p. 351)

  so, any strong opinions either way?

Robert P. J. Day, RHCE, RHCI
Eno River Technologies, Chapel Hill NC
Unix, Linux and Open Source corporate training


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

Powered by eList eXpress LLC