Return-Path: X-Original-To: apmail-commons-commits-archive@minotaur.apache.org Delivered-To: apmail-commons-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id C2DDCE703 for ; Wed, 16 Jan 2013 23:40:27 +0000 (UTC) Received: (qmail 85507 invoked by uid 500); 16 Jan 2013 23:40:27 -0000 Delivered-To: apmail-commons-commits-archive@commons.apache.org Received: (qmail 85443 invoked by uid 500); 16 Jan 2013 23:40:27 -0000 Mailing-List: contact commits-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@commons.apache.org Delivered-To: mailing list commits@commons.apache.org Received: (qmail 85436 invoked by uid 99); 16 Jan 2013 23:40:27 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 16 Jan 2013 23:40:27 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 16 Jan 2013 23:40:23 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 69AE423889E1 for ; Wed, 16 Jan 2013 23:40:03 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r846939 - in /websites/staging/commons/trunk/content: ./ site-publish.html Date: Wed, 16 Jan 2013 23:40:03 -0000 To: commits@commons.apache.org From: buildbot@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20130116234003.69AE423889E1@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: buildbot Date: Wed Jan 16 23:40:03 2013 New Revision: 846939 Log: Staging update by buildbot for commons Added: websites/staging/commons/trunk/content/site-publish.html Modified: websites/staging/commons/trunk/content/ (props changed) Propchange: websites/staging/commons/trunk/content/ ------------------------------------------------------------------------------ --- cms:source-revision (original) +++ cms:source-revision Wed Jan 16 23:40:03 2013 @@ -1 +1 @@ -1434479 +1434496 Added: websites/staging/commons/trunk/content/site-publish.html ============================================================================== --- websites/staging/commons/trunk/content/site-publish.html (added) +++ websites/staging/commons/trunk/content/site-publish.html Wed Jan 16 23:40:03 2013 @@ -0,0 +1,259 @@ + + + + + + + Apache Commons - + Publish Sites + + + + + + + + + + +
+ +
+
+
+ + + +

Introduction

+

+ Due to svnpubsub migration, procedure to publish sites has been changes. + Commons sites use a solution based on both Apache cms (for main site) + and svnpubsub publication based on maven-scm-publish-plugin. +

+ +
+

Main site

+

Apache CMS UI can be used to modify and publish main web site: https://cms.apache.org/commons/. + Documentation is available here + +

+
+

Components

+

+ Components use maven-scm-publish-plugin. The maven generated site is checkin to: +

    +
  • propers: https://svn.apache.org/repos/infra/websites/production/commons/content/proper/
    • +
  • sandbox: https://svn.apache.org/repos/infra/websites/production/commons/content/sandbox/
    • +
  • dormant: https://svn.apache.org/repos/infra/websites/production/commons/content/dormant/
    • +
+ +

+ Components need to use parent 28 (sandbox parent: 10). +

+

Publishing mono module projects

+

+ Simply using: + mvn clean site-deploy +

+
+

Publishing multi modules projects

+

+ Simply using: + clean site site:stage scm-publish:publish-scm +

+
+

Configuration

+

+ Default deployment targets are: +

    +
  • propers: https://svn.apache.org/repos/infra/websites/production/commons/content/proper/${project.artifactId}
    • +
  • sandbox: https://svn.apache.org/repos/infra/websites/production/commons/content/sandbox/${project.artifactId}
    • +
  • dormant: https://svn.apache.org/repos/infra/websites/production/commons/content/dormant/${project.artifactId}
    • +
+ +

+ maven-scm-publish-plugin will delete content not generated by Maven site plugin. + To avoid delete of previous apis javadocs, the pom need some configuration: + 

+          
+          <plugin>
+            <groupId>org.apache.maven.plugins</groupId>
+            <artifactId>maven-scm-publish-plugin</artifactId>
+            <configuration>
+              <ignorePathsToDelete>
+                <ignorePathToDelete>javadocs</ignorePathToDelete>
+                <!-- other paths to ignore -->
+              </ignorePathsToDelete>
+            </configuration>
+          </plugin>
+          
+
+ All paths declared won't be deleted from svn + +

+ NOTE: this old content need to be imported manually. +

+
+
+ + + +
+
+
+
+
+ + +