RE: [jats-list] xml:base attributes in DTD catalog

Subject: RE: [jats-list] xml:base attributes in DTD catalog
From: "Maloney, Christopher (NIH/NLM/NCBI) [C]" <maloneyc@xxxxxxxxxxxxxxxx>
Date: Mon, 14 Jan 2013 00:37:07 +0000
I agree with Alf that the xml:base attributes in the catalog files are a
problem.  I think it would be better that they be removed, that the current
"test" catalogs be distributed as the official ones.  Without the xml:base
attributes, if someone is working with one particular flavor of JATS, all that
person has to do is point their tool to the catalog file, and everything works
out-of-the-box, which is as it should be.

Unfortunately there is another
problem with the catalog files, and that is that each one lists all of the
resources in the entire JATS suite, rather than just those resources in the
one flavor that that catalog file goes with.  In other words, there is only
one master catalog file, named catalog-jats-v1.xml, a copy of which is
distributed with each JATS flavor.  So, for example, the catalog file in the
archiving distribution includes an entry for the publishing-flavor resource
"JATS-journalpubcustom-mixes1.ent".

What this means is that if a person has
two or more flavors of JATS on her system, in different directories, then
these catalog files will not work without the xml:base attributes.  But note,
of course, that she would still need to go in and adjust the values of these
attributes to match her particular system setup.  So I don't think this is a
good reason for keeping the xml:base attributes.

The reason for doing it this
way, from what I can tell, is to support the use-case where someone unzips all
of the DTDs into one directory.  The filenames of all of the .dtd and .ent
files are unique, but the catalog filenames are not, so if you unzip two or
more DTDs into one directory, you end up with only one catalog file.  Note
that in this use case, it would also be better if the catalog files did not
have xml:base attributes.

I've recommended before that the catalog files
should be fixed by removing the xml:base attributes and removing any resources
that don't correspond to that particular flavor of JATS.  This would allow
most people to use the catalog files out-of-the-box, and would support the use
cases:
* downloading and using only one flavor of JATS
* downloading several
flavors, each into their own directory.

If the use case "download several
flavors all into one directory" is really important, I think there is a better
way to support it, too:  rename the flavor-specific catalog files to
catalog-archiving.xml, catalog-publishing.xml, etc., and then create a
catalog-master.xml (or just catalog.xml), that is the same in all of the
directories, that looks like this:

  <catalog
xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"
         
 prefer='public'>
    <nextCatalog catalog="catalog-archiving.xml"/>
 
<nextCatalog catalog="catalog-publishing.xml"/>
    <nextCatalog
catalog="catalog-articleauthoring.xml"/>
  </catalog>


Chris Maloney
NIH/NLM/NCBI (Contractor)
Building 45, 5AN.24D-22
301-594-2842
_______________________________________
From: Debbie Lapeyre
[dalapeyre@xxxxxxxxxxxxxxxx]
Sent: Friday, January 11, 2013 4:42 PM
To:
jats-list@xxxxxxxxxxxxxxxxxxxxxx
Subject: Re: [jats-list] xml:base attributes
in DTD catalog

As delivered, the catalog does indeed need to be edited
in the
way you stated. As delivered, there is also a "test" catalog
in the same
directory, which has the xml:base attribute removed.

--Debbie
--
======================================================================
Deborah
Aleyne Lapeyre               mailto:dalapeyre@xxxxxxxxxxxxxxxx
Mulberry
Technologies, Inc.                http://www.mulberrytech.com
17 West
Jefferson Street                    Direct Phone: 301/315-9633
Suite 207
Phone: 301/315-9631
Rockville, MD  20850                                 Fax:
301/315-8285
----------------------------------------------------------------------
Mulberry Technologies: A Consultancy Specializing in XML, XSLT, & SGML
======================================================================
--~------------------------------------------------------------------
JATS-List info and archive:  http://www.mulberrytech.com/JATS/JATS-List/
To
unsubscribe, go to: http://lists.mulberrytech.com/jats-list/
or e-mail:
<mailto:jats-list-unsubscribe@xxxxxxxxxxxxxxxxxxxxxx>
--~--

Current Thread