Docbook discussion

Jason Zech | 10 Jul 2012 18:47

tagging a list of organizations

Hi all,

My book ends with a list of Resources, mostly organizations and their contact information. Here is how I
structured the tags:

<itemizedlist mark="none">
	<listitem>
		<para>
			<org>
				<orgname>Great Organization Company</orgname>
				<address>12354 Address Ave.
Sunset City, IL 343434</address>
			</org>
		</para>
	</listitem>

Etc.

This is valid markup in DB 5.0. However, the stylesheets output invalid XHTML/HTML because the listitem
has a <p> tag in it and the address tag outputs a <div class="address"> within that <p> tag. 

I tried to eliminate the <para> from my markup (doesn't seem appropriate anyway) and put all the info into
the address tag. Like this:

<listitem>
	<address><orgname>Great Organization Company</orgname>
12354 Address Ave.
City, State 343434</address>
</listitem>

(Continue reading)

headers

Bob Stayton | 19 Jul 2012 18:56

Re: tagging a list of organizations

Hi Jason,
Regarding your first question:

1) Why isn't <orgname> allowed in <address> while <personname> is?

This oversight has been corrected in DocBook 5.1, but that has not yet been officially 
released, so it doesn't really help you now.

Regarding alternatives, the best I could come up with was:

<listitem><address role="org"><phrase role="orgname">Great Organization 
Company</phrase>
12354 Address Ave.
Sunset City, IL 343434</address></listitem>

Then when 5.1 becomes available you could run a stylesheet on this to convert it to 
the proper markup.

Bob Stayton
Sagehill Enterprises
bobs <at> sagehill.net

----- Original Message ----- 
From: "Jason Zech" <zech <at> loyolapress.com>
To: <docbook <at> lists.oasis-open.org>
Sent: Tuesday, July 10, 2012 9:47 AM
Subject: [docbook] tagging a list of organizations

Hi all,

(Continue reading)