Re: [docbook] Bibliographic references and more

[Giannis Georgalis <jgeorgal@uoc.gr>]

Hello Bob,

On Saturday 04 December 2004 00:53, Bob Stayton wrote:
> It looks what what you are trying to do should work.
> Perhaps you could also show us what your files named "contents.xml" and
> "common/entites.xml" contain.

Thank you very much for your help !

The file "contents.xml" contains the section entities definitions (that are 
used in the root document) as such:

<?xml version="1.0" encoding="utf-8"?>
<!ENTITY section01 SYSTEM "sections/introduction.xml">
<!ENTITY section02 SYSTEM "sections/building.xml">
<!ENTITY section03 SYSTEM "sections/bluetooth.xml">

Each section file contains a sect1 root element and it's organized as such:
(eg. introduction.xml)

<?xml version="1.0" encoding="utf-8"?>
<sect1 id="introduction.section"> <title>Introduction</title>
 <para> ... </para>
 ...
</sect1>

while the "common/entities.xml" file contains some commonly used aliases 
(entities):

<?xml version="1.0" encoding="utf-8"?>
<!ENTITY % isonum PUBLIC "ISO 8879:1986//ENTITIES Numeric and Special 
Graphic//EN//XML" "ent/iso-num.ent">
%isonum;

<!ENTITY % isotech PUBLIC "ISO 8879:1986//ENTITIES General Technical//EN//XML" 
"ent/iso-tech.ent">
%isotech;

<!ENTITY bluez "BlueZ">
<!ENTITY bluetooth "Bluetooth<superscript>&reg;</superscript>">

Thank you very much Bob,
Giannis

previous e-mail for quick reference:

> > I'm a new user of docbook (and xml in general).
> >
> > I use the "xsltproc" (from debian unstable) toolchain and specifically
> > the "xmlto" (from debian unstable xmlto package) command to compile my
>
> document
>
> > in html format.
> >
> > I have the following questions:
> >
> > 1) How can I make a validating document that references a bibliographic
> > reference that resides at the end of the document (the very last page
> > actually) ?
> >
> > My root xml document looks like this:
> >
> > ##################################################
> > <?xml version="1.0" encoding="utf-8"?>
> >
> > <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
> >    "/usr/share/xml/docbook/schema/dtd/4.2/docbookx.dtd" [
> >
> > <!-- source in the article content and other entities -->
> > <!ENTITY % entities SYSTEM "common/entities.xml">
> > %entities;
> > <!ENTITY % contents SYSTEM "contents.xml">
> > %contents;
> > ]>
> >
> > <article>
> >   <articleinfo>
> >  ...
> >  <abstract>
> >         <para>
> >    <xref linkend="foo"/> ...
> >         </para>
> >      </abstract>
> >   </articleinfo>
> >
> >   &section01;
> >   &section02;
> >   &section03;
> >
> >   &references;
> > </article>
> > ##################################################
> >
> > where id "foo" is defined in the file referenced by the "references"
>
> entity
>
> > which looks like this:
> >
> > ##################################################
> > <bibliography> <title>References</title>
> >      <biblioentry id="foo">
> >    ...
> >     </biblioentry>
> >            ....
> > </bibliography>
> > ##################################################
> >
> > The problem is that when I try to compile the xml with the command:
> > "xmlto html-nochunks report.xml", I get the error:
> >
> > element xref: validity error : IDREF attribute linkend references an
>
> unknown
>
> > ID "foo"
> >
> > If I, however, shut down the validation and thus run the command: "xmlto
> > --skip-validation html-nochunks report.xml", everything works fine. (I