This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: [docbook] Bibliographic references and more
- From: Giannis Georgalis <jgeorgal at uoc dot gr>
- To: docbook at lists dot oasis-open dot org
- Cc: "Bob Stayton" <bobs at sagehill dot net>
- Date: Sun, 5 Dec 2004 01:48:22 +0200
- Subject: Re: [docbook] Bibliographic references and more
- Organization: University of Crete
- References: <200412031520.39011.jgeorgal@uoc.gr> <03a001c4d98a$ed116170$6400a8c0@toshiro>
- Reply-to: jgeorgal at uoc dot 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>®</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>
> >
> > §ion01;
> > §ion02;
> > §ion03;
> >
> > &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