Package: dblatex
Version: 0.2.9-2
Severity: normal

dblatex does not correctly handle underscores in "linkend" attributes. It 
doesn't escape the underscore with a backslash when outputting the LaTeX file, 
and this makes pdflatex fail.

Consider the following example:


<xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" 
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>
<book>
  <para>This is a <xref linkend="testgood" />. This is a <xref 
linkend="testbad" />.</para>
  <para>Here is the <anchor id="testgood" xreflabel="goodlinkend"/>good 
linkend.</para>
  <para>Here is the <anchor id="testbad" xreflabel="bad_linkend"/>bad 
linkend.</para>
</book>


This is valid DocBook, and is correctly converted to HTML by xsltproc.

When fed to dblatex, it gives the following:


Build the listings...
XSLT stylesheets DocBook -  LaTeX 2e (0.2.9-2)
===================================================
Build dblatex-report.pdf
This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6)
 %&-line parsing enabled.
entering extended mode
pdflatex failed
dblatex-report_tmp.tex:49: Missing $ inserted.
dblatex-report_tmp.tex:49: leading text: ...This is a 
\hyperlink{testbad}{bad_linkend}
dblatex-report_tmp.tex:49: Missing $ inserted.
dblatex-report_tmp.tex:49: leading text: ...This is a 
\hyperlink{testbad}{bad_linkend}

A possible reason for transformation failure is invalid DocBook
(as reported by xmllint)


Removing the underscore in "bad_linkend" fixes the problem.

The poor man's workaround is to use <link> instead of <xref>, but this is not 
very convenient when writing a software reference manual (as I do) with a lot 
of command names containing underscores.

Best,

S. Villemot

-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)

Kernel: Linux 2.6.25-2-686 (SMP w/1 CPU core)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages dblatex depends on:
ii  docbook-xml                4.5-5         standard XML documentation system,
ii  python                     2.5.2-1       An interactive high-level object-o
ii  python-4suite-xml          1.0.2-5       An open-source platform for XML an
ii  python-apt                 0.7.6         Python interface to libapt-pkg
ii  python-support             0.8.4         automated rebuilding support for P
ii  texlive                    2007.dfsg.1-2 TeX Live: A decent selection of th
ii  texlive-extra-utils        2007.dfsg.2-3 TeX Live: TeX auxiliary programs
ii  texlive-lang-cyrillic      2007.dfsg.3-2 TeX Live: Cyrillic
ii  texlive-latex-extra        2007.dfsg.3-1 TeX Live: LaTeX supplementary pack
ii  texlive-math-extra         2007.dfsg.3-1 TeX Live: Advanced math typesettin
ii  texlive-xetex              2007.dfsg.2-3 TeX Live: XeTeX macros
ii  xsltproc                   1.1.24-1      XSLT command line processor

Versions of packages dblatex recommends:
ii  libxml2-utils              2.6.32.dfsg-2 XML utilities

Versions of packages dblatex suggests:
ii  acroread [pdf-viewe 8.1.2.su1-0.0        Adobe Acrobat Reader: Portable Doc
ii  docbook             4.5-4                standard SGML representation syste
ii  evince [pdf-viewer] 2.22.2-1             Document (postscript, pdf) viewer
ii  ghostscript         8.62.dfsg.1-2.1      The GPL Ghostscript PostScript/PDF
ii  imagemagick         7:6.3.7.9.dfsg1-2+b2 image manipulation programs
ii  lmodern             1.010x-5             scalable PostScript and OpenType f
pn  opensp              <none>               (no description available)
pn  transfig            <none>               (no description available)

-- no debconf information



-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to