This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

RE: 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?

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

http://www.linux-migration.org


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]