Sorry if this is obvious and basic, but not knowing subversion I'm not
sure what the listing below is demonstrating re/ how would Forrest point
to a document that's in Subversion.
eg can a link in site.xml link directly to a document in Subversion? Or
are the docs living in the xdocs directory?
(The solution referenced by the link below covers how to publish the
version comments assuming they exists in a Forrest document, which is
useful, but doesn't deal with reading the xml file from Subversion along
with the change comments, which is my area of ignorance.)
"Stephan E. Schlierf" <stephan.schlierf@vsa.de>
10/19/2004 10:41 AM
Please respond to
user@forrest.apache.org
To
user@forrest.apache.org
cc
Subject
Re: [RT] Display document history inline w/ subversion
Am Dienstag, 19. Oktober 2004 16:28 schrieb Vincent Bray:
FYI: For a single cvs-entry I found a solution described at
http://issues.apache.org/eyebrowse/ReadMsg?listName=dev@forrest.apache.org&msgNo=8849
Maybe it could be a point to start from ...
Stephan
> 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
|