Re: Editing the docu with Firedocs

[Thorsten Scherler <th...@juntadeandalucia.es>]

On Fri, 2009-04-17 at 16:13 +0200, Andreas Hartmann wrote:
> Andreas Hartmann schrieb:
> > Andreas Hartmann schrieb:
> >> Hi Lenya devs,
> >>
> >> I have started to extend the docu publication and the 
> >> forrestDocument20 resource type with the goal of making the 
> >> documentation editable with Firedocs. IMO this will further lower the 
> >> barrier to improve our documentation. And if it proves useful, maybe 
> >> we can invite other ASF projects to take a look at the system, present 
> >> it at ApacheCon etc.?
> >>
> >> Unfortunately editing is limited to simple text changes at the moment. 
> >> The editor seems to recognize the document structure (the XPath at the 
> >> bottom of the page is displayed correctly), but it doesn't allow to 
> >> apply any structural changes.
> > 
> > Apparently this is due to the lack of a namespace. When I add a 
> > namespace to the document and schema, structural editing is possible.
> > 
> > I'd suggest that we add the namespace to the schema and to all 
> > documentation documents. IMO this can be done incrementally, we just 
> > have to add an intermediate transformation to the presentation pipeline 
> > which adds the namespace where it is missing.
> 
> There doesn't seem to be any inclination in the Forrest project to 
> introduce a namespace (Thorsten, please correct me if I'm wrong). So I'd 
> suggest that we just choose (a Lenya-specific) one, e.g.
> 
>    http://apache.org/lenya/forrest

Hmm, we do not use them ATM for the doc, however we are using them in
some parts of of code. 

The dispatcher e.g. uses 
<forrest:views xmlns:forrest="http://apache.org/forrest/templates/1.0"
  xmlns:jx="http://apache.org/cocoon/templates/jx/1.0">

Maybe http://apache.org/forrest/document/v20 makes sense for our use
case (reflects best the DOCTYPE declaration).

> 
> Should we discuss this with the Forrest project? Introducing an 
> "official" Forrest namespace would make sense as soon as we promote our 
> documentation solution to other projects. But we can still convert our 
> documents should the occasion arise.

I cc forrest-dev. 

salu2
-- 
Thorsten Scherler <thorsten.at.apache.org>
Open Source Java <consulting, training and solutions>

Sociedad Andaluza para el Desarrollo de la Sociedad 
de la Información, S.A.U. (SADESI)