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: DOCBOOK: Proposal: coref

The <co/> element allows one to insert callouts into a document:

  Some text<co id="foo"/> here
  And more here<co id="bar"/>

This creates numbered (or otherwise identified) marks in the listing
for later cross referencing.

The areaspec version offers a feature that cannot be achived with the
<co/> element, namely the ability to duplicate a given mark in several

<area coords="11 12" id="use"/>
<areaset coords="" id="xreq">
<area coords="9" id="require1"/>
<area coords="10" id="require2"/>

In this example, the "require1" and "require2" marks will have the
same number (or identifier).

Since processing arespec is considerably more difficult than processing
<co/> elements, I propose that DocBook add a <coref> element:

<!ENTITY % coref.module "INCLUDE">
<!ENTITY % local.coref.attrib "">
<!-- COREF is a cross reference to another CO. -->
<!ENTITY % coref.role.attrib "%role.attrib;">

<!ENTITY % coref.element "INCLUDE">
<!--end of coref.element-->]]>

<!ENTITY % coref.attlist "INCLUDE">
<!ATTLIST coref
<!--end of coref.attlist-->]]>
<!--end of coref.module-->]]>

The semantics of coref are analogous to the semantics of footnoteref.
It creates a callout with the same mark as the <co/> that it points to.
It is an error for the linkend attribute of coref to point to anything
except a co.

                                        Be seeing you,

Norman Walsh <ndw@nwalsh.com>      | Sites disappear; others are
http://www.oasis-open.org/docbook/ | created. That nasty little railway
Chair, DocBook Technical Committee | station, devoid of taste and
                                   | style, becomes an element of
                                   | beauty in the landscape which
                                   | first made it ugly.--R\'emy De
                                   | Gourmont

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

Powered by eList eXpress LLC