Re: [docbook-apps] using local catalog in platform independent way

[Gisbert Amm <gia at webde-ag dot de>]

Jason Novotny wrote:
> Thanks Gisbert,
>
>    That would be the answer and indeed i had been playing with xml 
> catalogs and included one in my ant task. Now however, here is my 
> docbook-- it includes some other docbook files as well as another file 
> like GridSphereLinks.xml like so:
>
> <?xml version="1.0" encoding="utf-8"?>
> <!-- $Id: ReferenceGuide.xml,v 1.9 2004/07/26 13:37:40 novotny Exp $ -->
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR1//EN"
>  "../common/docbook-xml-4.3CR1/docbookx.dtd" [
>  <!-- Useful snippets -->
>
> <!ENTITY % GridSphereLinks SYSTEM "../common/GridSphereLinks.xml">
>
>  %GridSphereLinks;
>
> <!-- Each chapter is in its own file -->
>
> <!ENTITY portlet-intro SYSTEM "portlet-intro.xml">
> <!ENTITY portlet-lifecycle SYSTEM "portlet-lifecycle.xml">
> <!ENTITY portlet-group SYSTEM "portlet-group.xml">
> <!ENTITY portlet-layout SYSTEM "portlet-layout.xml">
> <!ENTITY portlet-services SYSTEM "portlet-services.xml">
> <!ENTITY portlet-persistence SYSTEM "portlet-persistence.xml">
> <!ENTITY portlet-resources SYSTEM "portlet-resources.xml">
>
> <!-- Application, page, library, component specification entities  -->
> ]>
>
> So I have two questions:
>
> 1) How do I get rid of this line
>
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR1//EN"
>  "../common/docbook-xml-4.3CR1/docbookx.dtd" [
>
> but still include the imports?

Replace "../common/docbook-xml-4.3CR1/docbookx.dtd" with 
"http://www.oasis-open.org/docbook/xml/4.3CR1";

and then put the following lines into your catalogs:

Linux

<rewriteSystem 
systemIdStartString="http://www.oasis-open.org/docbook/xml/4.3CR1"; 
rewritePrefix="file:///path/to/your/common/docbook-xml-4.3CR1/">
  <rewriteURI 
uriStartString="http://www.oasis-open.org/docbook/xml/4.3CR1"; rewri
tePrefix="file:///path/to/your/common/docbook-xml-4.3CR1"/>

Windows:

<rewriteSystem 
systemIdStartString="http://www.oasis-open.org/docbook/xml/4.3CR1"; 
rewritePrefix="file://drive:path/to/your/common/docbook-xml-4.3CR1/">
  <rewriteURI 
uriStartString="http://www.oasis-open.org/docbook/xml/4.3CR1"; rewri
tePrefix="file://drive:path/to/your/common/docbook-xml-4.3CR1"/>

And make sure your processsor uses the catalog.

> 2) This line
>
> <!ENTITY % GridSphereLinks SYSTEM "../common/GridSphereLinks.xml">
>
> also looks problematic that it won't work with Windows, what can I do 
here?

No, this should cause no problems on windows at all.

Regards,
Gisbert Amm