XIncludes witj DocBook and Oxygen 3
Posted: Thu Jan 22, 2004 7:31 pm
I have been trying to use Docbook 4.2 with XInclude and Oxygen 3 - without much success. Can somebody please tell me where I am going wrong. The (simplified) XML files are listed below, all are well-formed and valid (according to Oxygen). I am using the suggestion of Bob Stayton, 'DocBook XSL', p.249-250 to customize docbookx.dtd to handle XIncludes. When I transform using docbook.xsl and request html output (no FO processing) and save the html output (appended below) the XInclude has not worked; all I get is the <hr> and the XInclude directives displayed (see html output file below.).
If anyone could show me how to make this example work I would be very grateful.
Ron
MAIN DRIVER FILE:
<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/docbookx.dtd"
[
<!ELEMENT xi:include (xi:fallback?) >
<!ATTLIST xi:include
xmlns:xi CDATA #FIXED "http://www.w3.org/2003/XInclude"
href CDATA #REQUIRED
parse (xml|text) "xml"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<book>
<xi:include href="/Library/WebServer/Documents/catterall/_SGGK/_XML/preface.xml"
xmlns:xi="http://www.w3.org/2003/XInclude" />
</book>
FIRST XINCLUFDE FILE: - preface.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/docbookx.dtd"
[
<!ELEMENT xi:include (xi:fallback?) >
<!ATTLIST xi:include
xmlns:xi CDATA #FIXED "http://www.w3.org/2003/XInclude"
href CDATA #REQUIRED
parse (xml|text) "xml"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<preface id="Preface" lang="EN">
<title>
Preface Title
</title>
<xi:include href="/Library/WebServer/Documents/catterall/_SGGK/_XML/acknowledgements.xml" xmlns:xi="http://www.w3.org/2003/XInclude" />
</preface>
SECOND XINCLUDE FILE: - acknowledgements.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/docbookx.dtd"
[
<!ELEMENT xi:include (xi:fallback?) >
<!ATTLIST xi:include
xmlns:xi CDATA #FIXED "http://www.w3.org/2003/XInclude"
href CDATA #REQUIRED
parse (xml|text) "xml"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<section id="Preface_Ackno" lang="EN">
<title>
Acknowledgements Title
</title>
<xi:include href="/Library/WebServer/Documents/catterall/_SGGK/_XML/default_section.xml" xmlns:xi="http://www.w3.org/2003/XInclude" />
</section>
SECOND XINCLUDE FILE: - default_section.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/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"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<section id="qwerty" lang="EN">
<title>
XInclude Problem - default section
</title>
<para>
this is the XInclude fallfack - default_section.xml
</para>para
</section>
HTML OUTPUT FILE:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO8859_1">
<title>
</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.62.4">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="book" lang="en">
<div class="titlepage">
<div>
</div>
<div>
</div>
<hr>
</div>
<font color="red">
<xi:include></xi:include>
</font>
</div>
</body>
</html>
If anyone could show me how to make this example work I would be very grateful.
Ron
MAIN DRIVER FILE:
<?xml version='1.0'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/docbookx.dtd"
[
<!ELEMENT xi:include (xi:fallback?) >
<!ATTLIST xi:include
xmlns:xi CDATA #FIXED "http://www.w3.org/2003/XInclude"
href CDATA #REQUIRED
parse (xml|text) "xml"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<book>
<xi:include href="/Library/WebServer/Documents/catterall/_SGGK/_XML/preface.xml"
xmlns:xi="http://www.w3.org/2003/XInclude" />
</book>
FIRST XINCLUFDE FILE: - preface.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/docbookx.dtd"
[
<!ELEMENT xi:include (xi:fallback?) >
<!ATTLIST xi:include
xmlns:xi CDATA #FIXED "http://www.w3.org/2003/XInclude"
href CDATA #REQUIRED
parse (xml|text) "xml"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<preface id="Preface" lang="EN">
<title>
Preface Title
</title>
<xi:include href="/Library/WebServer/Documents/catterall/_SGGK/_XML/acknowledgements.xml" xmlns:xi="http://www.w3.org/2003/XInclude" />
</preface>
SECOND XINCLUDE FILE: - acknowledgements.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/docbookx.dtd"
[
<!ELEMENT xi:include (xi:fallback?) >
<!ATTLIST xi:include
xmlns:xi CDATA #FIXED "http://www.w3.org/2003/XInclude"
href CDATA #REQUIRED
parse (xml|text) "xml"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<section id="Preface_Ackno" lang="EN">
<title>
Acknowledgements Title
</title>
<xi:include href="/Library/WebServer/Documents/catterall/_SGGK/_XML/default_section.xml" xmlns:xi="http://www.w3.org/2003/XInclude" />
</section>
SECOND XINCLUDE FILE: - default_section.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"/Applications/Utilities/oxygen/3.0/oxygen/docbook/dtd/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"
xpointer CDATA #IMPLIED
encoding CDATA #IMPLIED
accept CDATA #IMPLIED
accept-charset CDATA #IMPLIED
accept-language CDATA #IMPLIED >
<!ELEMENT xi:fallback ANY >
<!ATTLIST xi:fallback
xmlns:xi CDATA #FIXED "http://www.w3.org/2001/XInclude" >
<!ENTITY % local.preface.class "| xi:include">
<!ENTITY % local.part.class "| xi:include">
<!ENTITY % local.chapter.class "| xi:include">
<!ENTITY % local.divcomponent.mix "| xi:include">
<!ENTITY % local.para.char.mix "| xi:include">
<!ENTITY % local.info.class "| xi:include">
<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED" >
]>
<section id="qwerty" lang="EN">
<title>
XInclude Problem - default section
</title>
<para>
this is the XInclude fallfack - default_section.xml
</para>para
</section>
HTML OUTPUT FILE:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO8859_1">
<title>
</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.62.4">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="book" lang="en">
<div class="titlepage">
<div>
</div>
<div>
</div>
<hr>
</div>
<font color="red">
<xi:include></xi:include>
</font>
</div>
</body>
</html>