This is the mail archive of the docbook@lists.oasis-open.org mailing list for the DocBook project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[docbook] Bibliographic references and more


Hello,
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 don't
get the [..] however for the '[Abbrev]').


2) Skimming through the XML spec. I understood that I should write at the
beginning of each section's xml document the directive:
 <?xml version="1.0" encoding="utf-8" standalone="no"?>

...however this is reported as a parse error, with my only option being the
directive:
<?xml version="1.0" encoding="utf-8"?>
What am I doing wrong ?


3) from http://www.sagehill.net/docbookxsl/NumberedBiblio.html I read:
" If you set the stylesheet parameter bibliography.numbered to nonzero, then
the stylesheet will automatically number the entries in your bibliography."

Should I manually edit the xsl file ??? which xsl file should I edit to set
the parameter ???

Thank you very much,
Giannis


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]