Return-Path: 
 <dev-return-8267-apmail-stdcxx-dev-archive=stdcxx.apache.org@stdcxx.apache.org>
Delivered-To: apmail-stdcxx-dev-archive@www.apache.org
Received: (qmail 32555 invoked from network); 13 Aug 2008 01:54:03 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 13 Aug 2008 01:54:03 -0000
Received: (qmail 69541 invoked by uid 500); 13 Aug 2008 01:54:03 -0000
Delivered-To: apmail-stdcxx-dev-archive@stdcxx.apache.org
Received: (qmail 69468 invoked by uid 500); 13 Aug 2008 01:54:02 -0000
Mailing-List: contact dev-help@stdcxx.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:dev-help@stdcxx.apache.org>
List-Unsubscribe: <mailto:dev-unsubscribe@stdcxx.apache.org>
List-Post: <mailto:dev@stdcxx.apache.org>
List-Id: <dev.stdcxx.apache.org>
Reply-To: dev@stdcxx.apache.org
Delivered-To: mailing list dev@stdcxx.apache.org
Received: (qmail 69457 invoked by uid 99); 13 Aug 2008 01:54:02 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 12 Aug 2008 18:54:02 -0700
X-ASF-Spam-Status: No, hits=0.7 required=10.0
	tests=SPF_SOFTFAIL
X-Spam-Check-By: apache.org
Received-SPF: softfail (athena.apache.org: transitioning domain of
 gavin@16degrees.com.au does not designate 61.9.168.149 as permitted sender)
Received: from [61.9.168.149] (HELO nskntmtas05p.mx.bigpond.com)
 (61.9.168.149)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 13 Aug 2008 01:53:05 +0000
Received: from nskntotgx03p.mx.bigpond.com ([124.185.182.143])
          by nskntmtas05p.mx.bigpond.com with ESMTP
          id
 <20080813015326.SSDV6856.nskntmtas05p.mx.bigpond.com@nskntotgx03p.mx.bigpond.com>
          for <dev@stdcxx.apache.org>; Wed, 13 Aug 2008 01:53:26 +0000
Received: from developer ([124.185.182.143]) by nskntotgx03p.mx.bigpond.com
          with ESMTP
          id <20080813015326.CCND23560.nskntotgx03p.mx.bigpond.com@developer>
          for <dev@stdcxx.apache.org>; Wed, 13 Aug 2008 01:53:26 +0000
From: "Gavin" <gavin@16degrees.com.au>
To: <dev@stdcxx.apache.org>
References: <945707.1201827547692.JavaMail.jira@brutus>
 <63203.124.169.96.181.1201840274.squirrel@www.e-wire.net.au>
 <47A2B563.2010209@roguewave.com> <001f01c864ab$f3da62e0$0200a8c0@developer>
 <CFFDD219128FD94FB4F92B99F52D0A49010A3532@exchmail01.Blue.Roguewave.Com>
 <004101c867f2$16025fa0$0200a8c0@developer> <47A8DD67.5010205@roguewave.com>
 <005b01c8837b$4c72d7f0$0200a8c0@developer>
 <003901c8fa91$70a3e410$0200a8c0@developer> <48A0FA86.2090603@gmail.com>
 <002d01c8fc5e$655a20f0$0200a8c0@developer> <48A1DB05.9000501@gmail.com>
Subject: RE: Website Layout
Date: Wed, 13 Aug 2008 11:51:22 +1000
Message-ID: <007b01c8fce7$16e217a0$0200a8c0@developer>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Mailer: Microsoft Office Outlook 11
In-Reply-To: <48A1DB05.9000501@gmail.com>
X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198
thread-index: Acj8sE03nsD1KcwfRtG2MK3Kz/EQEAALfZjw
X-Antivirus: avast! (VPS 080812-0, 12/08/2008), Outbound message
X-Antivirus-Status: Clean
X-RPD-ScanID: Class unknown;
 VirusThreatLevel unknown, RefID str=0001.0A150204.48A23E96.0055,ss=1,fgs=0
X-Virus-Checked: Checked by ClamAV on apache.org



> -----Original Message-----
> From: Martin Sebor [mailto:msebor@gmail.com]
> Sent: Wednesday, 13 August 2008 4:49 AM
> To: dev@stdcxx.apache.org
> Subject: Re: Website Layout
> 
> Gavin wrote:

<snip>

> >
> > So whilst we are at this level of even-ness (?) it is a good time to
> swap it
> > over and make it live. However, over the next day or two, I will add
> > developer docs on how to go about updating the site, altering/adding
> pages
> > etc..
> >
> > Let me know what you think.
> 
> Sounds like a plan.
> 
> I assume we'll commit just the Forrest sources into Subversion
> and generate the site out of them on people.a.o using a cron
> job, correct?

Well, I'm sure various projects do things in slightly different ways.
However I would not recommend doing any building on people.a.o , and is not
necessary anyway.

This is how Forrest, xmlgraphics and a few others do it :-

1. Alter xdocs locally to your needs.
2. svn ci to get sources upto date in svn
3. locally run 'forrest -f publish.xml build'
4. locally run 'forrest -f publish.xml deploy'
5. /x1/www/stdcxx.apache.org svn up

That's the general gist, more fully,

Forrest stores its site source files in

http://svn.apache.org/repos/asf/forrest/trunk/site-author/

and the generated site docs go to 

http://svn.apache.org/repos/asf/forrest/site/

A cronjob on p.a.o then runs svn up hourly to 
/x1/www/forrest.apache.org

The hourly sync to eos/aurora then picks that up and your updated docs are
then live.

Again, with xmlgraphics, site source files stored in

http://svn.apache.org/repos/asf/xmlgraphics/site/

and the generated site docs go to

http://svn.apache.org/repos/asf/xmlgraphics/site/deploy/

/x1/www/xmgraphics.apache.org is svn of that deploy location, no idea how
often they run svn up or if it is done manually. Also no idea if they use
forrestbot (steps 2 and 3) or whether they svn ci the generated site, you'd
have to talk to Jeremias about that.

So , possibly 2 slightly different methods.

I'm happy to help show the way to Forrests' method. And of course I will
continue to be on this list for any help required afterwards. One thing to
note for others listening, it is necessary to have Apache Forrest installed
on your local machine in order to alter the xdocs, test locally, build and
then deploy.

There is a renewed talk on infra lists about having a shared zone or
something else where projects can build sites using Forrest/Maven/Anakia
that would be installed on the zone, the idea I guess is that generated
source files would live there and be copied over to various projects
/x1/www/*.a.o/ area. I'm not sure how it would work exactly but I'm
following for now to see how it pans out, or how long it will take. Just
thought I'd mention it, in the meantime we need to do one of the above.

So, here's how I see it for stdcxx :-

Have forrest and site source files where they are currently in 

http://svn.apache.org/repos/asf/stdcxx/site/forrest/

Have the generated site files in

http://svn.apache.org/repos/asf/stdcxx/site/deploy/

and 'svn remove' the current content from /site/ 

The above structure will remove the nasty side effect you currently have of
forrest source files viewable on the web (http://stdcxx.apache.org/forrest/)
doesn't look good.

Then create a cronjob to svn up hourly (or whatever delay you prefer) to
update your /x1/www/stdcxx.apache.org with the updated site files.

That's about it for now, what do you think?

Gav...