Re: [Refdb-devel] Docs failing to build

[Michael(tm) S. <sm...@xm...>]

David Nebauer <dav...@sw...>, 2006-08-25 00:14 +0930:

> > [ERROR] null
> > org.apache.fop.apps.FOPException
> >     at=20
> > org.apache.fop.apps.CommandLineStarter.run(CommandLineStarter.java:111)
> >     at org.apache.fop.apps.Fop.main(Fop.java:62)

I've not been able to reproduce this in my environment with FOP
0.20.5. FOP generates the PDF file successfully.

> I've found reports of a similar error here:=20
> <http://mail-archives.apache.org/mod_mbox/xmlgraphics-fop-users/200302.mb=
ox/%3c3...@ya...%3e>. =20
> In that instance the advice given was:
>=20
>     This means you have content outside a flow, which is
>     illegal. This should not happen. Upgrade your DocBook XSL,
>     be sure your DocBook docs validate, and complain on the
>     DocBook list if this persists.
>=20
> A few other references suggest this error is caused by invalid
> docbook xml.  I've attempted to validate the produced refdb-manual-xml
> file with xmllint but am unable to do so successfully.

The patch below adds an internal subset to refdb-manual.xml to
make it possible to validate it with DTD-based validation.

  --Mike

Index: refdb-manual.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- refdb-manual.xml	(revision 135)
+++ refdb-manual.xml	(working copy)
@@ -1,4 +1,20 @@
 <?xml version=3D"1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
+"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
+
+<!ELEMENT xi:include (xi:fallback?) >
+<!ATTLIST xi:include
+    xmlns:xi   CDATA       #FIXED    "http://www.w3.org/2001/XInclude"
+    href       CDATA       #REQUIRED
+    parse      (xml|text)  "xml"
+    encoding   CDATA       #IMPLIED >
+
+<!ELEMENT xi:fallback ANY>
+<!ATTLIST xi:fallback
+    xmlns:xi   CDATA   #FIXED   "http://www.w3.org/2001/XInclude" >
+
+<!ENTITY % local.part.class "| xi:include">
+]>
 <book>
   <bookinfo>
     <title><application moreinfo=3D"none">refdb</application> handbook</ti=
tle>