Re: [docbook] repeating/re-occuring info

["Bob Stayton" <bobs at sagehill dot net>]

I guess you noticed that if you create an entity that includes an id attribute and use that entity more than once, then your document will no longer be valid.  Attributes of xml type ID must be unique within the document, even if they are not referenced.  Of course, the reason for this rule is so that references to such an id would not be ambigious.

 

You could create an entity that consists only of the listitems (if they don't have id attributes).  Then you could use them in several places with different id values for the list element wrapper:

 

<!ENTITY listitems "<listitem>

  <para>First one</para>

</listitem>

<listitem>

  <para>Another</para>

</listitem>">

 

And in your document use it as:

 

<itemizedlist id="firsttime">

&listitems;

</itemizedlist>

 

and

 

<itemizedlist id="secondtime">

&listitems;

</itemizedlist>

 

If your listitems must have id attributes, then it gets more complicated, as each such listitem would need to be an entity.

 

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net

 

 

----- Original Message -----

From: René Haché

To: docbook@lists.oasis-open.org

Sent: Monday, June 07, 2004 1:07 PM

Subject: [docbook] repeating/re-occuring info

To whom it may concern,

 

I have a list in my docbook that I would like to re-occur in a few spots in my document. I could do it by making that list an entity, but wouldn't that screw up linking and cross-references to point to that list? Just want to avoid copying/pasting.

 

Also, I am unclear whether or not a cross-reference needs a link wrapper to create a link to the location of that cross-reference.

 

My apologies if the terminology is not correct, since I only a beginner with docbook.

 

Many Thanks,

René