Author: olamy
Date: Mon Dec 10 23:07:44 2012
New Revision: 1419862
URL: http://svn.apache.org/viewvc?rev=1419862&view=rev
Log:
fix documentation for publishing maven website
Modified:
maven/site/trunk/content/apt/developers/website/deploy-maven-website.apt
Modified:
maven/site/trunk/content/apt/developers/website/deploy-maven-website.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/content/apt/developers/website/deploy-maven-website.apt?rev=1419862&r1=1419861&r2=1419862&view=diff
==============================================================================
--- maven/site/trunk/content/apt/developers/website/deploy-maven-website.apt
(original)
+++ maven/site/trunk/content/apt/developers/website/deploy-maven-website.apt
Mon Dec 10 23:07:44 2012
@@ -30,6 +30,16 @@ Introduction
This document gives step-by-step instructions for deploying the Maven website
{{{http://maven.apache.org}http://maven.apache.org}}.
+ Since 10th Decemeber 2012, the main website use CMS mechanism. (see
{{{http://cms.apache.org}http://cms.apache.org}}).
+
+ You can edit pages in two ways:
+
+ * use the CMS UI.
+
+ * checkout the content locally and modify manually.
+
+ []
+
Prerequisite
Be sure that:
@@ -37,36 +47,37 @@ Prerequisite
* you have all Maven servers defined in your <<<settings.xml>>>. For more
information, please refer to
{{{../committer-settings.html}Committer settings}}.
-Deploy Maven Website
- [[1]] Do a fresh check out of the Maven site, for example:
+* Modify Maven Website with CMS UI
-+-----+
-$ svn checkout https://svn.apache.org/repos/asf/maven/site site
-+-----+
+ * Go to {{{http://cms.apache.org/maven}http://cms.apache.org/maven}}.
- [[2]] Execute the site goal
+ * Click link "Get maven Working Copy"
-+-----+
-site$ mvn site
-+-----+
+ * Now navigate to the content you want to modify
- [[3]] Verify the documentation before deploying
+ * Once you have modify the content, you can now commit with the button
"Submit".
- You could also use the <stage> goal of the Maven Site Plugin to verify the
site output. For instance:
+ []
+
+* Modify Maven Website with a local copy
+
+ [[1]] Do a fresh check out of the Maven site, for example:
+-----+
-site$ mvn site:stage -DstagingDirectory=/tmp/maven-website
+$ svn checkout https://svn.apache.org/repos/asf/maven/site site
+-----+
- [[4]] Deploy to people.apache.org
+ [[2]] Execute the site goal
+-----+
-site$ mvn site-deploy
+site$ mvn site
+-----+
- It will copy the site to the <site.deploy.url> which is currently defined in
the <<<pom.xml>>> as <scp://people.apache.org/www/maven.apache.org/>
+ [[3]] Verify the documentation before committing
- <<Note:>> It will
{{{http://www.apache.org/dev/release-publishing.html#sync-delay}take an hour or
so to sync}}.
+Publish content
- []
+ * Verify staging content has been build with buildbot job
{{{http://ci.apache.org/builders/maven-site-staging}http://ci.apache.org/builders/maven-site-staging}}
+
+ * Build finish, publish modifications using
{{{http://cms.apache.org/maven/publish}http://cms.apache.org/maven/publish}}
