DOCBOOK: ulink, olink...

[Denis BERGER <d dot berger at cstb dot fr>]

Hello folks,

I need to use links, and I wonder how to do it with DocBook.

 

Here are my questions :

 

- What are the real differences between an ulink tag and an olink tag ?

In others word, in which case using ulink and olink ? Is ulink reserved to define an URL or can we use it for local files ?

 

- Please find below an exemple of link that I'd like to do :

 

This code is extracted from the file afm.xml and refer to the file afp.xml :

What is the best solution ?

 

Solution 1 : with ulink

<ulink url="afp.xml#cor2.1.1">Cahier des Charges</ulink>

Solution 2 : with olink

<!DOCTYPE book SYSTEM "sdocbook.dtd" [
<!ENTITY afp SYSTEM "afp.xml">
]>
...
<olink targetdocent="afp" localinfo="cor2.1.1">Cahier des Charges</olink>

- This template defined in file xsl/html/xref.xml, why are attributes not processed (LinkMode, LocalInfo, TargetDocEnt, Type) ?

<xsl:template match="olink">
  <xsl:if test="@id">
    <a name="{@id}"/>
  </xsl:if>
  <xsl:apply-templates/>
</xsl:template>

 

- Last question, just for the fun !

What is the meaning of the letter "O" in olink ?

 

Thanks in advance for your help,

and excuse me for my average English,

Denis

 

--

Denis BERGER
Centre Scientifique et Technique du Batiment (CSTB)
Sophia Antipolis - France