Re: [docbook] tagging a list of organizations

["Bob Stayton" <bobs@sagehill.net>]

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@sagehill.net


----- Original Message ----- 
From: "Jason Zech" <zech@loyolapress.com>
To: <docbook@lists.oasis-open.org>
Sent: Tuesday, July 10, 2012 9:47 AM
Subject: [docbook] 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>

But <orgname> is not allowed within <address> (which is odd to me because <personname> 
is allowed).

Two questions, then:

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

2) Any suggestions on how to mark this up? I'd rather not customize the XSLT for this 
minor issue. (I can put the organization name into the address tag without any markup 
on the name and it will output fine, but I'm losing semantic info here.)

Thanks,

jz


Jason Zech | Project Manager, Digital Workflow
[p] 773-281-1818 x212 | zech@loyolapress.com

LoyolaPress. | A Jesuit Ministry | 100 Years of Service
3441 N. Ashland Ave. | Chicago, IL 60657 | www.loyolapress.com


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org