Return-Path: Delivered-To: apmail-cocoon-docs-archive@www.apache.org Received: (qmail 6810 invoked from network); 21 Oct 2007 16:14:14 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 21 Oct 2007 16:14:14 -0000 Received: (qmail 59979 invoked by uid 500); 21 Oct 2007 16:14:01 -0000 Delivered-To: apmail-cocoon-docs-archive@cocoon.apache.org Received: (qmail 59953 invoked by uid 500); 21 Oct 2007 16:14:01 -0000 Mailing-List: contact docs-help@cocoon.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: docs@cocoon.apache.org List-Id: Delivered-To: mailing list docs@cocoon.apache.org Received: (qmail 59633 invoked by uid 99); 21 Oct 2007 16:14:01 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 21 Oct 2007 09:14:00 -0700 X-ASF-Spam-Status: No, hits=-100.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.67] (HELO cocoon.zones.apache.org) (140.211.11.67) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 21 Oct 2007 16:14:11 +0000 Received: from cocoon.zones.apache.org (localhost [127.0.0.1]) by cocoon.zones.apache.org (8.13.7+Sun/8.13.7) with ESMTP id l9LGDpa0006539 for ; Sun, 21 Oct 2007 16:13:51 GMT Message-ID: <28442439.1192983231386.JavaMail.daisy@cocoon.zones.apache.org> Date: Sun, 21 Oct 2007 16:13:51 +0000 (GMT+00:00) From: daisy@cocoon.zones.apache.org To: docs@cocoon.apache.org Subject: [DAISY] Updated: How to publish docs to cocoon.apache.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Virus-Checked: Checked by ClamAV on apache.org A document has been updated: http://cocoon.zones.apache.org/daisy/documentation/1418.html Document ID: 1418 Branch: main Language: default Name: How to publish docs to cocoon.apache.org (unchanged) Document Type: Cocoon Document (unchanged) Updated on: 10/12/07 6:57:01 AM Updated by: Reinhard P=C3=B6tz A new version has been created, state: publish Parts =3D=3D=3D=3D=3D Content ------- This part has been updated. Mime type: text/xml (unchanged) File name: (unchanged) Size: 1423 bytes (previous version: 37 bytes) Content diff: ---

TODO

+++ +++ +++=20 +++

If you want to publish the Cocoon docs you can follow one of those t= wo paths: +++

+++=20 +++

use the nightly build on cocoon.zones.apache.org
build the docs at your local machine

+++=20 +++

Use the nightly build

+++=20 +++

There is a nightly build (runs at 2am UTC) of our docs available at +++ cocoon.zones.apache.org. Login via ssh and use the 'maven' user:

+++=20 +++

sudo su - maven

+++=20 +++

Then change to

+++=20 +++

cd ~/svn-site-generation

+++=20 +++

There you will find a directory svn-docs. It contains a rec= ent +++ checkout (=3D part of the nightly docs build) and the result of the doc= s +++ generation process copied over. Using

+++=20 +++

svn st svn-docs

+++=20 +++

will show you all the differences.

+++=20 +++

If you want to add all the newly generated docs run

+++=20 +++

svn st | grep "\?" | awk '{print $2}' | xargs svn add
+++

+++=20 +++

which will recursivly add all new documents.
+++ When you now what you want to add to the official site, run

+++=20 +++

svn ci [path]

+++=20 +++

That's it. When the docs are committed to the SVN, they will be publ= ished +++ within the next 60 minutes.

+++=20 +++

Build the docs locally

+++=20 +++

Actually it's the same as using the nightly build. The only differen= ce is +++ that you have to build the docs yourself. The Ho= w to build +++ the docs locally guide explains how you can do=C2=A0 this. Then fol= low the steps +++ from above.

+++=20 +++ +++