cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Koberg" <>
Subject RE: newbies documentation - requirements?
Date Mon, 27 Jan 2003 14:36:10 GMT

> -----Original Message-----
> From: Steven Noels []
> Sent: Monday, January 27, 2003 5:33 AM

> Bertrand Delacretaz wrote:

> > 3) MUST clearly identify these docs as being "for beginners" and
> > "reviewed by an editor of the Cocoon team" to prevent beginners from
> > getting lost in obsolete/unreliable docs
> That might warrant a different Wiki instance for these docs since this
> breaks the fundamental 'uncategorization-ness' of Wikis... or we would
> have to hack JSPWiki. A Wiki doesn't know 'sections', or it ain't a true
> Wiki...

perhaps dreaming, but... :)
How about adding a tab structure/frameset that toggles between Wiki editing of
the page and a metadata view. Using Dublin Core's core elements, it makes it
easy to create a flexible form. The form consist of a toolbar containing a save
button and three dropdowns for the 3 DC categories (Content, Intellectual
Property, Instantiation). The *.dcxml file is used to populate the form if it
exists. If new or adding an element, the user selects from the dropdown and
JavaScript writes a new row containing that metadata item. Save puts it in the
central location.

<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF xmlns:rdf=""
  <rdf:Description about="">
    <dc:Title lang='en'>Cool Cocoon block Blah</dc:Title>
    <dc:Description lang='en'>This block handles blah blah...</dc:Description>
    <dc:Creator>Joe Developer</dc:Creator>
    <dc:Publisher>Joe Developer's Company</dc:Publisher>
    <dc:Contributor>Jimmy User</dc:Contributor>
    <dc:Contributor>Johnny Editor</dc:Contributor>
    <dc:Rights>Open Source</dc:Rights>
    <dc:Date>2003-01-22 19:05</dc:Date>

    <link rel="meta" href="{$focus_id}.dcxml"/>

All metadata is stored in one location. Pages can live anywhere. Metadata is
transformed into a documentation site 'index' or perhaps it creates a site based
on the dc:Subject. The rdfDescription/@about links/is-fed the described
resource. If someone would like to add documentation they add the metadata to
the central location.


Please check that your question  has not already been answered in the
FAQ before posting.     <>

To unsubscribe, e-mail:     <>
For additional commands, e-mail:   <>

View raw message