Assembling composite DTDs

[Andy Dingley]

How can I best make a composite DTD by including one DTD inside another
?

There's a pre-existing DTD in an external Apache project. I'd like to
make use of this within our internal project, suitably extended and
wrapped. With the aid of an internal and external subset I can do
this, as follows:

<?xml version="1.0"?>
<!DOCTYPE Container
PUBLIC "-//Apache Software Foundation//DTD OJB Repository//EN"
"http://db.apache.org/ojb/repository.dtd"
[
<!-- Wrapper element -->
<!ELEMENT Container (jdbc-connection-descriptor) >

<!-- Remove the attribute we don't want -->
<!ATTLIST jdbc-connection-descriptor jcd-alias CDATA #IMPLIED

<!-- Add a couple of attributes we do want -->
<!ATTLIST jdbc-connection-descriptor schema CDATA #IMPLIED <!ATTLIST jdbc-connection-descriptor displayname CDATA #IMPLIED

]>
<Container>
<jdbc-connection-descriptor
platform="Oracle"
jdbc-level="3.0"
driver="@DRIVER_NAME@"
dbalias="@URL_DBALIAS@"
username="@USER_NAME@"
password="@USER_PASSWD@"
schema="@DB_SCHEMA"
displayname="@DB_NAME"
/>
</Container>

Now obviously I don't want to have to repeat this internal subset into
every one of our documents. I'd like to make a local DTD that
represents this combination of internal and external subsets, as a
single DTD that I can refer to from other documents. Is there any way
to do this?

AFAIK, it's possible to do this, but _only_ if the original DTD was
written with that in mind (DocBook is an example) and it was already
written as modularised components that defined entitites representing
the DTD content and would be expanded in a wrapper DTD. Changing the
wrapper DTD allows you to incorporate the same entities, but manipulate
them however you like. In the simple case though, the DTD is inflexible
except by the rather clumsy way I've done it above.

Is this the best I can do? Should I look at a port to XML Schema
instead?

Apologies for the x-post to c.i.w.a.h, but the traffic there catches
the eyeballs of some people whose opinion I'd respect on this.

[Joe Kesselman]

Andy Dingley <di*****@codesmiths.com> wrote:

AFAIK, it's possible to do this, but _only_ if the original DTD was
written with that in mind

I believe that's correct.
--
() ASCII Ribbon Campaign | Joe Kesselman
/\ Stamp out HTML e-mail! | System architexture and kinetic poetry

[Benjamin Niemann]

Andy Dingley wrote:

How can I best make a composite DTD by including one DTD inside another
?

There's a pre-existing DTD in an external Apache project. I'd like to
make use of this within our internal project, suitably extended and
wrapped. With the aid of an internal and external subset I can do
this, as follows:

<?xml version="1.0"?>
<!DOCTYPE Container
PUBLIC "-//Apache Software Foundation//DTD OJB Repository//EN"
"http://db.apache.org/ojb/repository.dtd"
[
<!-- Wrapper element -->
<!ELEMENT Container (jdbc-connection-descriptor) >

<!-- Remove the attribute we don't want -->
<!ATTLIST jdbc-connection-descriptor jcd-alias CDATA #IMPLIED

<!-- Add a couple of attributes we do want -->
<!ATTLIST jdbc-connection-descriptor schema CDATA #IMPLIED

<!ATTLIST jdbc-connection-descriptor displayname CDATA #IMPLIED

]>
<Container>
<jdbc-connection-descriptor
platform="Oracle"
jdbc-level="3.0"
driver="@DRIVER_NAME@"
dbalias="@URL_DBALIAS@"
username="@USER_NAME@"
password="@USER_PASSWD@"
schema="@DB_SCHEMA"
displayname="@DB_NAME"
/>
</Container>

Now obviously I don't want to have to repeat this internal subset into
every one of our documents. I'd like to make a local DTD that
represents this combination of internal and external subsets, as a
single DTD that I can refer to from other documents. Is there any way
to do this?

Create a file, e.g. my.dtd with (untested code warnings!!)

<!-- this will include the repository.dtd -->
<!ENTITY % repository.dtd
PUBLIC "-//Apache Software Foundation//DTD OJB Repository//EN"
"http://db.apache.org/ojb/repository.dtd">
repository.dtd;

<!-- add your own declarations here -->
<!-- Wrapper element -->
[...snip...]
and use it as in
<!DOCTYPE Container SYSTEM "path/to/my.dtd">

AFAIK, it's possible to do this, but _only_ if the original DTD was
written with that in mind (DocBook is an example) and it was already
written as modularised components that defined entitites representing
the DTD content and would be expanded in a wrapper DTD. Changing the
wrapper DTD allows you to incorporate the same entities, but manipulate
them however you like. In the simple case though, the DTD is inflexible
except by the rather clumsy way I've done it above.

If the DTD is designed for customizations, you could declare parameter
entities before including the DTD to adjust some things to you own needs.
If the DTD is not designed for customizations, you can still add attributes,
entities, etc. but the possibilities are rather limited.
--
Benjamin Niemann
Email: pink at odahoda dot de
WWW: http://pink.odahoda.de/

[Peter Flynn]

Andy Dingley <di*****@codesmiths.com> wrote:

How can I best make a composite DTD by including one DTD inside another
?

See the FAQ on exactly this: http://xml.silmaril.ie/developers/dtdincludes/
///Peter
--
XML FAQ: http://xml.silmaril.ie/

[Henri Sivonen]

In article <11**********************@g10g2000cwb.googlegroups .com>,
"Andy Dingley <di*****@codesmiths.com>" <di*****@codesmiths.com>
wrote:

Should I look at a port to XML Schema instead?

If you decide to abandon DTDs, RELAX NG is likely to be a better choice
than W3C XML Schema. And the Compact Syntax is even human-writable.

See:
http://www.imc.org/ietf-xml-use/mail.../msg00217.html
http://lists.xml.org/archives/xml-de.../msg00057.html

--
Henri Sivonen
hs******@iki.fi
http://hsivonen.iki.fi/
Validation Service for RELAX NG: http://hsivonen.iki.fi/validator/