OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

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

Subject: Re: [docbook-apps] can anyone recommend a more/better "marked up"form of...

the problem is that <citation> allows PCDATA.  <biblioref> has to be a link.

if JSCET is a link to a <bibliography> item try:
<citation><biblioref linkend="JSCET"/> (p.805)</citation>
or, even better, just:
<biblioref linkend="JSCET"/> (p.805)

<biblioref> is unambiguous to any machine processing.  <citation> has 
multiple meanings - including PCDATA and many others.  With 
<bilioref> you can construct your <bibliography> section of 
<bibliomixed> automatically if this links to a master file of biblio 
You could of course use <xref> - but that will point to just about anything.


see recent emails about this from Bob and Jirka, especially

Hi Jirka,
Yes, I think his point was that this is a bug in the stylesheet. 
Specifically this template in html/inline.xsl:

<xsl:template match="citation">
  <!-- todo: integrate with bibliography collection -->
  <xsl:variable name="targets" select="(//biblioentry | 
//bibliomixed)[abbrev = string(current())]"/>
    <xsl:when test="$targets">
      <xsl:call-template name="xref">
        <xsl:with-param name="targets" select="$targets"/>
        <xsl:text>Citation to nonexistent publication abbrev: </xsl:text>
        <xsl:value-of select="."/>
      <xsl:call-template name="inline.charseq"/>

The case when there is no matching target should not generate an 
error message because such a match is not required.  The problem, of 
course, is trying to guess when a target was intended but none was 
found because of a typo.  Since this is PCDATA, I don't think there 
is any way to tell. I usually recommend people use xref directly if 
they want a link that can be verified.
Bob Stayton

Yes, indeed. But in scientific publishing it is usually more 
convenient to use abbrev/citation then @id/xref. Anyway I removed 
warning and put FO code into shape with HTML code.

><citation>JSCET</citation>, p 805
>To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org

Ron Catterall, Phd, DSc				email: ron@catterall.net
Prolongacion de Hidalgo 140				http://catterall.net/
San Felipe del Agua					tel: +52 951 520 1821
Oaxaca      68020	Mexico				fax: +1 530 348 8309

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