cocoon-users mailing list archives

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

> -----Original Message-----
> From: Steven Noels [mailto:stevenn@outerthought.org]
> 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.

//cool_block.dcxml
<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:dc="http://purl.org/dc/elements/1.1/">
  <rdf:Description about="http://a.org/cool_block.html">
    <dc:Title lang='en'>Cool Cocoon block Blah</dc:Title>
    <dc:Subject>Cocoon.User.Blocks.Cool</dc:Subject>
    <dc:Description lang='en'>This block handles blah blah...</dc:Description>
    <dc:Coverage>Cocoon</dc:Coverage>
    <dc:Identifier>cool_block</dc:Identifier>
    <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>
    <dc:Format>text/html</dc:Format>
  </rdf:Description>
</rdf:RDF>

<html>
  <head>
    <link rel="meta" href="http://cocoondev.org/dc/{$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.

best,
-Rob



---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <cocoon-users-unsubscribe@xml.apache.org>
For additional commands, e-mail:   <cocoon-users-help@xml.apache.org>


Mime
View raw message