[Dev] parcel.xml changes

Morgen Sagen morgen at osafoundation.org
Tue Jun 22 10:18:20 PDT 2004


Jeffrey (and others),

I left the "describes=" attribute inside each parcel element for now, 
but you and I need to talk about what to do next in terms of 
XML-to-HTML document generation.  As you can see, our parcels now have 
real URIs for namespaces, and there were a couple tweaks to syntax, 
such as itemName becoming itsName (to match the repo API).

Also, I'm not sure if this is important to your XSLT transforms, but 
remember that a parcel's URI doesn't necessarily have match it's 
repository path (or file system path) -- however, OSAF parcels will 
most likey follow this pattern, just so there's not another hierarchy 
to keep in mind:

    filesystem:  chandler/parcels/osaf/contentmodel/parcel.xml
    repo path:  //parcels/osaf/contentmodel
    parcel's registered namespace:  
http://osafoundation.org/parcels/osaf/contentmodel

I could (and third party parcels will) make up my own namespace, such 
as http://morgen.com/foo/bar and have my parcel register it (by placing 
a <namespace value="http://morgen.com/foo/bar" /> inside my <Parcel>), 
and that URI would be how others would refer to me.

If you don't specify a <namespace> in your parcel, the parcel will be 
assigned a namespace equal to your parent's namespace plus your parcel 
name appended.  So for the OSAF parcels, we only need to assign 
<namespace> to //parcels/osaf, and all the children will automatically 
have the right namespace assigned.  I mention this, Jeffrey, so that 
you know not to assume every parcel.xml will have a <namespace> in it.  
If that's a problem, let me know.

So I would like to remove the "describes=" attribute if the doc 
generator no longer requires it.

Thanks,
~morgen



More information about the Dev mailing list