forrest-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Vincent Bray <v.b...@cobwebinfo.com>
Subject Re: [RT] Display document history inline w/ subversion
Date Tue, 19 Oct 2004 14:28:29 GMT
On Tue, 2004-10-19 at 15:00, peter.dykstra@donovandata.com wrote:
> I've also thought about this and possible ways to do it.
> 
> [snip] Asking multiple authors to do this manually? Perhaps it could
> be saved by the editing tool.
Indeed. Tools like this should not involve any manual processes if
possible.
> 
> It sounds like what you're talking about is to have a Cocoon Generator
> that would read files dynamically from CVS or Subversion, including
> options to list the saved versions with change comments and browse
> through the versions.  This would allow you to post content to the
> site by checking it in to CVS (for example) and also keep an audit
> trail of changes.  That would be pretty powerful.
Yeah, what he said :-) With Subversion in mind, it is not even necessary
for Forrest to checkout the files from the repository. For example:

$ cd src/documentation/content/xdocs/
$ l
total 24
-rw-rw-r--    1 noodl    dev          2615 Oct 19 14:52 howto-docs.xml
drwxrwxr-t    3 noodl    dev          4096 Oct 19 11:34 images
-rw-rw-r--    1 noodl    dev          1190 Oct 19 13:36 index.xml
drwxrwxr-t    3 noodl    dev          4096 Oct 19 11:34 infrastructure
-rw-rw-r--    1 noodl    dev          2670 Oct 19 13:34 site.xml
-rw-rw-r--    1 noodl    dev          1533 Oct 19 11:34 tabs.xml
$ svn log howto-docs.xml
------------------------------------------------------------------------
r130 | noodl | 2004-10-19 15:21:14 +0100 (Tue, 19 Oct 2004) | 1 line
 
Fixed my initial typos.
------------------------------------------------------------------------
r129 | noodl | 2004-10-19 13:39:10 +0100 (Tue, 19 Oct 2004) | 1 line
 
Added a document detailing how to contribute to the docs on this site.
------------------------------------------------------------------------

Ok, so there's only two log messages here, but you get the idea. Being
able to choose, perhaps by an edit to forrest.properties, to display
version control log messages along with the rendered document would be
funky.
Where this extra info might go would be a choice maybe best left to the
skin writing guys. Although there is often space below the menu, it's
perhaps now wide enough. Easiest would be to place the log messages at
the end of the page..

noodl

Mime
View raw message