[xml/sgml-pkgs] Bug#483503: xmlto is confused by cross-references into an external entity.
dburrows at debian.org
Thu May 29 04:50:28 UTC 2008
I was just experimenting with using xmlto on the aptitude documentation.
I didn't get very far.
aptitude's documentation is split into a manpage and the main body of
the docs. (this is for the convenience of translators -- they can just
translate the manpage if they want) The manpage is incorporated into
the main document via what I believe is an external entity, unless I'm
getting my XML terminology wrong:
<!ENTITY manpage SYSTEM "manpage.xml">
When I run xmlto on the aptitude docs, it fails and prints a bunch of
"validity errors" like this:
/home/daniel/programming/aptitude/head/doc/en/aptitude.xml:9570: element link: validity error : IDREF attribute linkend references an unknown ID "cmdlineOptionSafeUpgradeNoNewInstalls"
The problem is, an element with that ID *does* exist, in manpage.xml.
It looks like xmlto is just ignoring everything in that file when
checking cross-references. In contrast, xsltproc is quite happy to
handle these cross-references and generates links for them in the HTML
-- System Information:
Debian Release: lenny/sid
APT prefers unstable
APT policy: (500, 'unstable'), (500, 'stable')
Architecture: i386 (i686)
Kernel: Linux 2.6.25-2-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages xmlto depends on:
ii debianutils 2.28.6 Miscellaneous utilities specific t
ii docbook-xml 4.5-5 standard XML documentation system,
ii docbook-xsl 1.73.2.dfsg.1-4 stylesheets for processing DocBook
ii libc6 2.7-11 GNU C Library: Shared libraries
ii libxml2-utils 2.6.32.dfsg-2 XML utilities
ii sgml-base 1.26 SGML infrastructure and SGML catal
ii xsltproc 1.1.24-1 XSLT command line processor
Versions of packages xmlto recommends:
ii libpaper-utils 1.1.23 library for handling paper charact
-- no debconf information
More information about the debian-xml-sgml-pkgs