toshi 2004/10/26 00:30:08
Modified: targets/axis beta1-beta2.html beta2-beta3.html bugs.html
contact.html cvs.html docs.html interim.html
legal.html mailguide.html overview.html ref.html
releases.html mail.html index.html news.html
site.html site.pdf who.html
Log:
Add a new content for how to build Axis site, 'howtobuild.html'.
Revision Changes Path
1.18 +4 -0 ws-site/targets/axis/beta1-beta2.html
Index: beta1-beta2.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/beta1-beta2.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- beta1-beta2.html 21 Jul 2004 03:01:35 -0000 1.17
+++ beta1-beta2.html 26 Oct 2004 07:30:01 -0000 1.18
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.18 +4 -0 ws-site/targets/axis/beta2-beta3.html
Index: beta2-beta3.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/beta2-beta3.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- beta2-beta3.html 21 Jul 2004 03:01:35 -0000 1.17
+++ beta2-beta3.html 26 Oct 2004 07:30:01 -0000 1.18
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.22 +4 -0 ws-site/targets/axis/bugs.html
Index: bugs.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/bugs.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- bugs.html 21 Jul 2004 03:01:35 -0000 1.21
+++ bugs.html 26 Oct 2004 07:30:01 -0000 1.22
@@ -120,6 +120,10 @@
<div class="menuItem">
<span class="menuSelected">Bugs</span>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.19 +4 -0 ws-site/targets/axis/contact.html
Index: contact.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/contact.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- contact.html 21 Jul 2004 03:01:35 -0000 1.18
+++ contact.html 26 Oct 2004 07:30:01 -0000 1.19
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.21 +4 -0 ws-site/targets/axis/cvs.html
Index: cvs.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cvs.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- cvs.html 21 Jul 2004 03:01:35 -0000 1.20
+++ cvs.html 26 Oct 2004 07:30:01 -0000 1.21
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.22 +4 -0 ws-site/targets/axis/docs.html
Index: docs.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/docs.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- docs.html 21 Jul 2004 03:01:35 -0000 1.21
+++ docs.html 26 Oct 2004 07:30:01 -0000 1.22
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.18 +4 -0 ws-site/targets/axis/interim.html
Index: interim.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/interim.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- interim.html 21 Jul 2004 03:01:35 -0000 1.17
+++ interim.html 26 Oct 2004 07:30:02 -0000 1.18
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.19 +4 -0 ws-site/targets/axis/legal.html
Index: legal.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/legal.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- legal.html 21 Jul 2004 03:01:35 -0000 1.18
+++ legal.html 26 Oct 2004 07:30:02 -0000 1.19
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.18 +4 -0 ws-site/targets/axis/mailguide.html
Index: mailguide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/mailguide.html,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- mailguide.html 21 Jul 2004 03:01:35 -0000 1.17
+++ mailguide.html 26 Oct 2004 07:30:02 -0000 1.18
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.19 +4 -0 ws-site/targets/axis/overview.html
Index: overview.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/overview.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- overview.html 21 Jul 2004 03:01:35 -0000 1.18
+++ overview.html 26 Oct 2004 07:30:02 -0000 1.19
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.19 +4 -0 ws-site/targets/axis/ref.html
Index: ref.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/ref.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- ref.html 21 Jul 2004 03:01:35 -0000 1.18
+++ ref.html 26 Oct 2004 07:30:02 -0000 1.19
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.27 +4 -0 ws-site/targets/axis/releases.html
Index: releases.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/releases.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- releases.html 21 Jul 2004 03:01:35 -0000 1.26
+++ releases.html 26 Oct 2004 07:30:02 -0000 1.27
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.22 +4 -0 ws-site/targets/axis/mail.html
Index: mail.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/mail.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- mail.html 23 Sep 2004 11:12:14 -0000 1.21
+++ mail.html 26 Oct 2004 07:30:02 -0000 1.22
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.28 +4 -0 ws-site/targets/axis/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/index.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- index.html 4 Oct 2004 11:33:29 -0000 1.27
+++ index.html 26 Oct 2004 07:30:02 -0000 1.28
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.34 +4 -0 ws-site/targets/axis/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/news.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- news.html 4 Oct 2004 11:33:29 -0000 1.33
+++ news.html 26 Oct 2004 07:30:02 -0000 1.34
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
1.27 +235 -0 ws-site/targets/axis/site.html
Index: site.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/site.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- site.html 26 Oct 2004 07:15:51 -0000 1.26
+++ site.html 26 Oct 2004 07:30:02 -0000 1.27
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
@@ -1066,6 +1070,237 @@
</p>
+
+<div class="h2">
+<h2>How To Build Axis Project's Website</h2>
+</div>
+
+<div class="h5">
+<h5>Installing Forrest</h5>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ The Axis website build system requires two components to perform a
build.<br>
+
+<a href="http://ant.apache.org/";>Ant</a> and
+ <a href="http://forrest.apache.org/";>Forrest</a>.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ Specifically the build has been tested to work with Ant version
+ 1.6.1 and Forrest 0.5.1. To install these products download
+ the distributions and follow the instructions in their
+ documentation. Make sure you don't forget to set the
+ environment variables FORREST_HOME and ANT_HOME. The
+ ANT_HOME/bin directory should be in the path.
+ </p>
+
+
+<div class="h5">
+<h5>Checking out ws-axis and ws-site module</h5>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ Check out <b>'ws-axis/site/src'</b> and <b>'ws-site/target/axis'</b>
+ module via your favorite CVS tools.<br>
+ Please follow the guildeline written <a href="#cvs.html">here</a>.
+ </p>
+
+
+<div class="h5">
+<h5>Running the Build</h5>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ Here's a list of targets for the ant task. But, what you need to do
is just "ant".
+ </p>
+
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tr class="b">
+
+<th xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">Target</th>
+ <th xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Description</th>
+
+</tr>
+
+<tr class="a">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">clean</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Erase all build work products (ie, everything in the
+ build directory</td>
+
+</tr>
+
+<tr class="b">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">run-forrest</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Run Forrest with Jetty server
+ to review the target</td>
+
+</tr>
+
+<tr class="a">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">run-browser</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Invoke a web browser (ie, Internet Explorer)</td>
+
+</tr>
+
+<tr class="b">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">backcopy</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Reflect the updates on the build directory to
+ the master source on 'ws-axis/site/src'</td>
+
+</tr>
+
+<tr class="a">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">forrest</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Create the updated static contents</td>
+
+</tr>
+
+
+<tr class="b">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">replace</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Copy the contents to ws-site/targets/axis directory</td>
+
+</tr>
+
+<tr class="a">
+
+<td xmlns:cinclude="http://apache.org/cocoon/include/1.0"; colspan="1"
rowspan="1">build-site (default)</td>
+ <td xmlns:cinclude="http://apache.org/cocoon/include/1.0";
colspan="1" rowspan="1">Do clean up and all tasks to the build site</td>
+
+</tr>
+
+</table>
+
+
+<div class="h5">
+<h5>For Committers (Highly recommended)</h5>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ The procedure to make changes to http://ws.apache.org/axis/ is:
+ </p>
+
+<ul xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+
+<li>*cd* into the local <b>'ws-axis/site'</b> CVS dir</li>
+
+<li>execute <b>"ant"</b>
+</li>
+
+<li>make changes to <b>'build/webapp/content/xdocs'</b>
+</li>
+
+<li>
+<b>reload and review the contents</b> with the autostarted browser</li>
+
+<li>
+<b>close the browser and the forrest window</b> when you are ready to
+ finish editing the site</li>
+
+<li>cvs commit (ie, <b>'ws-axis/site/src'</b> and
+ <b>'ws-site/target/axis'</b>)</li>
+
+</ul>
+
+
+<div class="h5">
+<h5>Manual update (If you want to realize the value of ant tasks above ...)</h5>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+ If you just want to update the site step-by-step, the followings
+ are the instructions.
+ </p>
+
+<PRE xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+1. Installing Forrest
+ [Note] At this time, the version 0.5.1 of Forrest is tested version.
+
+2. Checking out 'ws-axis/site' module
+ [ex]
+ 'ws-axis/site/src/documentation/content/xdocs/java/user-guide.ihtml'
+
+3. Make changes to the target
+
+4. Confirming the change with "forrest run"
+ 4-1) cd into the local "ws-axis/site" CVS dir
+ 4-2) execute "forrest run"
+ 4-3) have an access to http://localhost:8888/ to see the site
+
+5. Generating a static content with "forrest"
+ 5-1) execute "forrest" in the "ws-axis/site" dir
+ 5-2) check the generated contents in "ws-axis/site/build/site/"
+
+6. Make commitments
+ 6-1) commit the original source (xml/ihtml/gif/jpg) to "ws-axis"
+ 6-2) copy the generated contents into "ws-site/targets/axis"
+ 6-3) commit the generated contents to "ws-site"
+
+7. (Optional) If you are in a hurry to reflect the change to the site,
+ cd to /www/ws.apache.org, and execute "cvs update -P" on minotaur.
+
+ [Note] *** VERY IMPORTANT ***
+ YOU HAVE TO CHECK YOUR UMASK IS "002" BEFORE DOING THE COMMAND,
+ OR THE SITE WILL BECOME A NON-UPDATABLE SITE FROM THEN ON.
+
+ The site will be updated automatically twice a day 12 midnight and
+ 12 noon PST by a cron job of dims.
+</PRE>
+
+
+<div class="h5">
+<h5>F.A.Q.</h5>
+</div>
+
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<em>Q1.</em>
+<br>
+ I encountered<br>
+ The <xmlcatalog> data type doesn't support the nested
"catalogpath" element.<br>
+ error, during the build.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+
+<em>A1.</em>
+<br>
+ Please make sure that your Ant version is later than 1.6 alpha. You can
check the Ant version, by running "ant -version".
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<em>Q2.</em>
+<br>
+ I see an error like this regarding mirrors.pdf<br>
+ [java] X [0] mirrors.pdf BROKEN ....
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+<em>A2.</em>
+<br>
+ This is a known issue, but does not affect the site itself.
+ </p>
+
+<p xmlns:cinclude="http://apache.org/cocoon/include/1.0";>
+
+<strong>( more to be come )</strong>
+
+</p>
+
+
<div class="h4">
1.24 +4508 -4317ws-site/targets/axis/site.pdf
<<Binary file>>
1.29 +4 -0 ws-site/targets/axis/who.html
Index: who.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/who.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- who.html 26 Oct 2004 07:15:48 -0000 1.28
+++ who.html 26 Oct 2004 07:30:07 -0000 1.29
@@ -120,6 +120,10 @@
<div class="menuItem">
<a href="bugs.html">Bugs</a>
</div>
+
+<div class="menuItem">
+<a href="howtobuild.html">HowToBuildSite</a>
+</div>
</div>
