At 20:10 01/12/2003, Karsten Wade wrote:
>The target file in the common directory is called via a relative path,
> >i.e. it's always in an expected location of off the Fedora docs cvsroot,
> >../fedora-common-xml/fedora-entities.xml.
>
>
> Are all authors expected to work with that relative path?
I am suggesting one idea for this, and yes under this idea, all authors
would work with that relative path. To work on a document, you would
need to check out the common directories module (of at least one top
level directory), and put it in a specific relative path.
The downside of which is that it may not suite all our
disk setup's.
This idea is not yet a procedure; we are discussing that. I actually
like the idea of using a URI, will it work within the entity?
Yes, since its the parser that expands the entity.
... Any reason to use an entity though?
That
seems to fit into the spirit of things. :) It's structurally different
from a CVS module on a relative path, but it's essentially the same
thing - a remote canonical source you generally only have read access to
and you keep a copy of locally.
Rationale (for some),
We may not always be connected to the net.
Hence, for example,
<!--This group handles all docbook items. -->
<!-- Use formal public identifiers in preference to SYSTEM identifiers -->
<group
prefer="public"
xml:base="/sgml/nw/" >
<!-- docbook 4.2 -->
<public publicId="-//OASIS//DTD DocBook XML V4.2//EN"
uri="docbook/docbookx.dtd"/>
<uri name="http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";
uri="docbook/docbookx.dtd"/>
Is a snippet of my docbook stuff.
The Edited text refers to the web,
the catalog maps it to /sgml/nw/docbook/docbookx.dtd
(Similar, using Oasis catalog, for emacs use)
2. Common Entities in DTD (please correct my inaccuracies)
Depends on the design modularity you want/need.
Some things (names etc) will be very stable.
Versions may change fairly quickly.
A. Common entities are added to Fedora specific DTD and served from
fedora.redhat.com.
B. Authors calling the DTD gain access to the entities, which are listed
XXXXX (manually on the FDP pages? extracted via xml-fu from the DTD?)
Don't care? If they nest nicely they'll all be accessible,
either from the redhat site, or locally when mapped.
Two (local) usages,
Within the editor for use (not always needed, but useful)
Externally, when validating, say with nsgmls,
there the catalog is needed, so perhaps some documentation
on using Daniel Vaillard's software as a parser?
I know he supports catalogs.
C. Local copies of the DTD are kept, as is common.
Thoughts?
I like it. Its flexible. redhat.com has the masters,
they are available over the net if needed,
I can copy them to my hard drive if needed.
I think that meets most needs.
regards DaveP
