Re: JDBC website help ! - Mailing list pgsql-jdbc

From Mikko Tiihonen
Subject Re: JDBC website help !
Date
Msg-id 4FC7E90A.9000508@nitorcreations.com
Whole thread Raw
In response to JDBC website help !  (Dave Cramer <pg@fastcrypt.com>)
Responses Re: JDBC website help !
List pgsql-jdbc
On 05/31/2012 04:11 PM, Dave Cramer wrote:
> I've spent a few days trying to build the website. Currently it is
> using apache forrest to create the website. I have been unable to
> build it and I don't really have any more  time to work on it. I'm
> also not inclined to spend a whole lot of time to learn Forrest.
>
> Do we have anyone with Forrest expertise ?

I had never before heard of it. But I think I might have managed to build the site now.

I used the latest 0.9 release of Forrest. And after googling a bit it seems that
generating the changes and todo that you were missing out of the status.xml at the root
has been moved to a plugin. After you enable it by adding:

project.required.plugins=org.apache.forrest.plugin.input.projectInfo

to the forrest.properties the changes & todo are properly generated.


In addition to actually run the ant target doc on the git checkout succesfully
I had to add to build.local.properties:
docbook.dtd=/usr/share/sgml/docbook/xml-dtd-4.2
docbook.stylesheet=/usr/share/sgml/docbook/xsl-stylesheets-1.76.1/xhtml-1_1/docbook.xsl

+ add latest xalan-2 jar to classpath.

> Alternatively should we look at another way to build the website ?
> Possibly use the same infrastructure as the main www.postgresql site ?
> Or another simple way ?
>
> Suggestions (and volunteers) welcome.

I think the jdbc project does not have extra resources to maintain its own web site presence.

Either:
1) ask if www.postgresql could embed jdbc content somewhere in their site - after a volunteer migrates the current site
contentto their infrastructure 
2) keep using forrest, but move the building of the site to git repository too - and script it so that it actually
worksproperly 
    - instead of requiring the site-developer to download and maintain all release source codes it could just fetch
thenfrom the git repository 
    - add all required defines to build.properties so that it works at least on some machine and provides examples for
thenext person on what to tune 
    - automate loading and installing of forrest if required

-Mikko

pgsql-jdbc by date:

Previous
From: "Johann 'Myrkraverk' Oskarsson"
Date:
Subject: Re: Implementing setBinaryStream(int, InputStream, long)
Next
From: John R Pierce
Date:
Subject: Re: JDBC website help !