maven-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Vincent Massol" <vmas...@pivolis.com>
Subject RE: Maven web site and Wiki
Date Fri, 06 Jun 2003 12:39:17 GMT


> -----Original Message-----
> From: Cocell | Trygve Laugstøl [mailto:trygve@cocell.com]
> Sent: 06 June 2003 14:13
> To: Maven Developers List
> Subject: Re: Maven web site and Wiki
> 
> Wasnt the point to have a wiki site and then create the xdocs based on
the
> wiki site?

Nope :-) The wiki automatically saves the topics in xdocs format and in
CVS!

> 
> If the wiki site cant commit the wiki entries as xdoc formatted docs
in
> the
> maven cvs, but can export the entries as xml I think wath I proposed
would
> be
> a rather simple solution. Its just a suggestion anyway, im not
enlightned
> with
> the inner workings of wiki sites.

Oh sure, but it would be much much easier to have the wiki directly save
as xdocs (such as what moinmoin does by default).

-Vincent

> 
> Trygve
> 
> Vincent Massol wrote:
> >
> >>-----Original Message-----
> >>From: Cocell | Trygve Laugstøl [mailto:trygve@cocell.com]
> >>Sent: 06 June 2003 13:52
> >>To: Maven Developers List
> >>Subject: Re: Maven web site and Wiki
> >>
> >>Hi
> >>
> >>Sounds like a really good plan, but perhaps there should be
installed a
> >>normal wiki installation that can deliver xml exports.
> >>
> >>Then a nighly cronjob could do this
> >>1. Export the new/updated entries to a xml file
> >>2. Use XSLT to transform the wiki xml to xdoc.
> >>3. Use XSLT to take out the commend field and commit it into cvs
> >>
> >>This way all that needs to be done is to write two rather simple xsl
> >>tranformation sheets and the existing cvs mails will tell us about
the
> >>updates.
> >
> >
> > Why would you need to do all that? That is automatically done on the
fly
> > when you edit topics in the wiki...
> >
> > Have a look at: http://www.mockobjects.com/wiki/
> > Here is an example of the generated XML :
> >
http://www.mockobjects.com/wiki/FrontPage?action=format&mimetype=text/xm
> > l
> > (you might need to do a "view source" with IE).
> >
> > -Vincent
> >
> >
> >>Trygve
> >>
> >>Vincent Massol wrote:
> >>
> >>>Hi,
> >>>
> >>>Here are some facts:
> >>>- Our Maven web site contains lots of inaccuracies and would not
suffer
> >>>from additional documentation
> >>>- Some Maven users would be happy to contribute if we gave them
easy
> >>>tools for that.
> >>>
> >>>The idea:
> >>>
> >>>- Transform our web site from a static web site into a Wiki web
site.
> >>>- But not any wiki! One that saves topics in XML format. For
example
> the
> >>>MoinMoin wiki saves topic in xdocs format (stylebook style
> unfortunately
> >>>but that's not too far from our xdocs format and could probably be
> >>>easily modified )
> >>>- Second step: hook the wiki to CVS so that modifications are saved
in
> >>>our Maven CVS, directly in xdocs format. This is possible with
MoinMoin
> >>>and probably with others too.
> >>>- Note: The MoinMoin wiki also has a "comment" field that could be
used
> >>>as the CVS commit message. We could force the need to have a
non-blank
> >>>text if we wish to make sure there are commit messages.
> >>>- We get automatically CVS email notifications whenever pages are
> >>>modified and we can thus easily control the changes made to the
wiki
> and
> >>>correct when and if needed.
> >>>
> >>>Conclusion:
> >>>- We keep the advantage of our xdocs
> >>>- We can still edit xdocs directly should we wish
> >>>- Anyone can contribute easily to the documentation and we get good
and
> >>>up to date Maven documentation.
> >>>
> >>>If we agree, there are things to do:
> >>>- We need to find a machine where the wiki could run (it could be a
> >>>machine provided by a Friend Of Maven or an Apache one if there's
one
> >>>available)
> >>>- We need someone to look at MoinMoin (or another wiki) to perform
the
> >>>following:
> >>>  - find how to hook it to CVS
> >>>  - find how to change the default style to be the Maven style
> >>>(stylesheet)
> >>>  - find how to modify the DTD so that the xdocs are in the Maven
xdocs
> >>>format
> >>>  - find how to define where xdocs are saved in CVS so that we try
to
> >>>match the existing locations of xdocs
> >>>- We need a Wiki admin
> >>>
> >>>What do you think?
> >>>
> >>>Thanks
> >>>-Vincent
> >>>
> >>>
> >>>
> >
> >
---------------------------------------------------------------------
> >
> >>>To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> >>>For additional commands, e-mail: dev-help@maven.apache.org
> >>>
> >>>
> >>>
> >>
> >>
>
>>---------------------------------------------------------------------
> >>To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> >>For additional commands, e-mail: dev-help@maven.apache.org
> >
> >
> >
> >
> >
---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
> >
> >
> >
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Mime
View raw message