cocoon-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Crossley <cross...@indexgeo.com.au>
Subject AW: ensure uniform xdocs/*.xml
Date Thu, 20 Sep 2001 05:27:24 GMT
Giacomo Pati wrote:
> Stefano Mazzocchi wrote:
> > Carsten Ziegeler wrote:
> > > > David Crossley wrote:
> > > >
> > > > There are some aspects of the document set that need attention
> > > > - uniform XML declarations and Document Type Declarations.
> > > > When these two issues are resolved, then i will create the
> > > > CVS diffs for all relevant xdocs.
> > > >
> > > > Here are the 4 unique values for XML declaration from all 85 xdocs.
> > > > ----
> > > > <?xml version="1.0"?>
> > > > <?xml version="1.0" encoding="utf-8"?>
> > > > <?xml version="1.0" encoding="iso-8859-1"?>
> > > > <?xml version="1.0" encoding="ISO-8859-1" ?>
> > > > ----
> > > > Which one do we settle on?
> > > >
> > > I would suggest the fifth solution:
> > > <?xml version="1.0" encoding="UTF-8"?>

This XML Declaration is preferred by everyone.

> > > > Here are the 4 unique values for Document Type Declaration
> > > > from all relevant docs.
> > > > ----
> > > > <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> > > > "dtd/document-v10.dtd">
> > > > <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Vx.yz//EN"
> > > > "dtd/document-v10.dtd">
> > > > <!DOCTYPE document SYSTEM "./dtd/document-v10.dtd">
> > > > <!DOCTYPE document SYSTEM "dtd/document-v10.dtd">
> > > > ----
> > > > IMHO the first is the best. What do you think?.
> > > >
> > > +1 for the first one.
> >
> > Hmmm, not so sure.
> >
> > IMHO, since C2 now has a catalog system, why don't we use it?
> >
> > Then the best identifier should be something like:
> >
> >  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> >   "http://www.apache.org/dtd/document-v10.dtd">
> >
> > but this will require the entire ASF to be aware of this and I'm not
> > sure I have the political power to push this so high.

Yes Stephano, that would be the best declaration. However,
there is a very good reason for using the default system
identifier "dtd/document-v10.dtd". The catalog manager is
only in effect for Apache Cocoon. The Ant build system
does not have a catalog manager, so it uses brute-force
retrieval to get the DTD for each parse. The use of a
default local system identifier relative to xdocs/ then
allows Ant to do off-line build.

> IIRC we agreed on a simple "http://apache.org/..." month ago for
> namespaces (isn't this like a namespace?)

No Giacomo, the system identifier is not like a namespace.
It is a physical location of the actual entity (either URL
or full pathname or pathname relative to the XML instance).
The public identifier is the symbolic name that can be mapped
by the catalog resolver to some local copy of the resource.
The Apache Cocoon doco catalog.html fully explains all this.

> > Second choice something like
> >
> >  <!DOCTYPE document PUBLIC "-//APACHE//XML//DTD Documentation V1.0//EN"
> >   "http://xml.apache.org/dtd/document-v10.dtd">
> >
> > but still we have to have the PMC approuval for this.
> >
> > Third option (but this doesn't work without an appropriate catalog) is
> >
> >  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
> >   "document-v10.dtd">
> >
> > The forth option is to use XSchema and forget about DTD altogher, given
> > also the need to include other namespaces such as SVG and OpenOffice.
> >
> > one thing is for sure: we have to uniform the declaration and make the
> > document building process fully validating.
> >
> > comments?
> >
> Well, I don't like DTDs but I don't like XML Schema either (it has grown
> into way too complex specification)
> 
> Giacomo

---------------------------------------------------------------------
To unsubscribe, e-mail: cocoon-dev-unsubscribe@xml.apache.org
For additional commands, email: cocoon-dev-help@xml.apache.org


Mime
View raw message