jefft 2003/08/04 05:51:49
Modified: targets ack.pdf communication.pdf contact.pdf cvs.pdf
decisions.pdf guidelines.html guidelines.pdf
index.pdf legal.pdf library.pdf mail.pdf
management.pdf mission.pdf news.html news.pdf
overview.pdf roles.pdf source.pdf whoweare.pdf
targets/skin breadcrumbs.js
Log:
Automatic publish at Mon Aug 4 14:51:35 CEST 2003 from
http://forrestbot.cocoondev.org.
Revision Changes Path
1.7 +30 -30 xml-site/targets/ack.pdf
<<Binary file>>
1.8 +46 -46 xml-site/targets/communication.pdf
<<Binary file>>
1.7 +29 -29 xml-site/targets/contact.pdf
<<Binary file>>
1.8 +81 -81 xml-site/targets/cvs.pdf
<<Binary file>>
1.8 +96 -96 xml-site/targets/decisions.pdf
<<Binary file>>
1.39 +113 -41 xml-site/targets/guidelines.html
Index: guidelines.html
===================================================================
RCS file: /home/cvs/xml-site/targets/guidelines.html,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -r1.38 -r1.39
--- guidelines.html 3 Aug 2003 10:37:51 -0000 1.38
+++ guidelines.html 4 Aug 2003 12:51:49 -0000 1.39
@@ -345,6 +345,17 @@
</li>
<li>
<a href="#Website+update+guidelines">Website update guidelines</a>
+<ul class="minitoc">
+<li>
+<a href="#Updating+the+top+level+site">Updating the top level site</a>
+</li>
+<li>
+<a href="#Updating+Forrest+based+sub-project+websites">Updating Forrest
based sub-project websites</a>
+</li>
+<li>
+<a href="#Updating+non-Forrest+sub-project+websites">Updating non-Forrest
sub-project websites</a>
+</li>
+</ul>
</li>
</ul>
@@ -398,62 +409,123 @@
</ul>
</div>
+
<a name="N101E9"></a><a name="Website+update+guidelines"></a>
<h3>Website update guidelines</h3>
<div style="margin-left: 0 ; border: 2px">
-<div class="frame warning">
-<div class="label">Warning</div>
-<div class="content">This is <strong>not</strong> valid for projects using
Forrest for their documentation needs!</div>
+<p>
+ As XML-oriented projects, so our website is also generated from
+ XML files. While many similar websites may use servlets or a
+ system like Cocoon to generate their websites on-the-fly
+ from XML documents, we currently checkin source .xml files
+ of the documentation and then generate a static set of .html
+ files for most of this website.
+ </p>
+<p>
+ Briefly: the entire xml.apache.org website is stored in CVS
repositories.
+ Both the source .xml documents and the generated .html docs are
checked in,
+ and the actual website itself is simply a checked-out copy of
the repository.
+ </p>
+<p>
+ While each subproject's individual areas may be managed
separately
+ (by that subproject's committers) the top-level of the website
+ should be managed through the xml-site repository. Thus to
change
+ any of the files at the root of http://xml.apache.org you
should
+ first check out the xml-site repository from cvs.apache.org
+ </p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">
+ The website is gradually being converted to
+ <a target="_top"
href="http://xml.apache.org/forrest";>Forrest</a>. Whilst
+ this conversion is occuring, there are two methods for updating
+ content, dependent on what part of the site is being updated.
+ </div>
</div>
+<a name="N101FE"></a><a name="Updating+the+top+level+site"></a>
+<h4>Updating the top level site</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The top level of the site is created using Forrest. To
update,
+ committers with access to xml-site should check out this
module,
+ and make the content changes to the files found in
+ <em>xml-site/src/documentation/content/xdocs</em>
+
+</p>
+<p>
+ There are two methods for updating the content on
xml.apache.org.
+ </p>
+<p>
+ The first method is to manually update the contents of the
+ cvs xml-site module. (After checking in the content changes
made.)
+ </p>
+<pre class="code">
+cvs checkout xml-forrest
+cd xml-forrest
+./build.sh
+export PATH=`pwd`/build/dist/shbat/bin
+cd ..
+cvs checkout xml-site
+cd xml-site
+forrest
+cp -r build/site/* targets/
+cvs add <new files>
+cvs commit targets
+ </pre>
+<p>
+ The second method is to use the <em>forrestbot</em>.
+ </p>
+<pre class="code">
+Log in to http://forrestbot.cocoondev.org
+Select 'xml-site' from the drop-down list
+Click 'refresh', wait for the site to rebuild
+Click 'publish'
+ </pre>
<div class="frame note">
<div class="label">Note</div>
-<div class="content">To use <a
href="http://xml.apache.org/forrest/";>Forrest</a>
+<div class="content">
+ To stop random people triggering resource-intensive rebuilds,
the page is
+ password-protected. Committers wishing to use this facility
should contact
+ the <a target="_top"
href="mailto:forrest-dev";>forrest-dev</a> mailing list.
+ </div>
+</div>
+</div>
+<a name="N10226"></a><a
name="Updating+Forrest+based+sub-project+websites"></a>
+<h4>Updating Forrest based sub-project websites</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>To use <a href="http://xml.apache.org/forrest/";>Forrest</a>
install it
<a href="http://xml.apache.org/forrest/your-project.html";>as
described</a>,
cd in the directory of your project and run "forrest". Publish the
HTML/PDF result of the build into the xml-site/targets module (copy
the results of ./build/site to xml-site/targets and commit
changes).
The sources of the top-level xml.apache.org website are in the
- xml-site/src/documentation directory.</div>
+ xml-site/src/documentation directory.
+ </p>
</div>
+<a name="N10238"></a><a name="Updating+non-Forrest+sub-project+websites"></a>
+<h4>Updating non-Forrest sub-project websites</h4>
+<div style="margin-left: 0 ; border: 2px">
<p>
- As XML-oriented projects, so our website is also generated from
- XML files. While many similar websites may use servlets or a
- system like Cocoon to generate their websites on-the-fly
- from XML documents, we currently checkin source .xml files
- of the documentation and then generate a static set of .html
- files for most of this website.
- </p>
-<p>
- Briefly: the entire xml.apache.org website is stored in CVS
repositories.
- Both the source .xml documents and the generated .html docs are
checked in,
- and the actual website itself is simply a checked-out copy of the
repository.
- </p>
-<p>
- While each subproject's individual areas may be managed separately
- (by that subproject's committers) the top-level of the website
- should be managed through the xml-site repository. Thus to change
- any of the files at the root of http://xml.apache.org you should
- first check out the xml-site repository from cvs.apache.org
- </p>
-<p>
- To update a part of the website (that does *not* use Forrest) do this:
- <br>Checkout the xml-site module (you only actually need a few subdirs,
- but the whole thing is quite large).
- <br>Make updates to the .xml files in the xml-site/sources/website
- directory.
- <br>Go to the xml-site/sources directory locally and run the relevant
- shell or bat script.
- <br>Check that the .html structure in your local targets directory is
- built correctly.
- <br>Checkin to CVS both your updated sources/ and targets/ trees as
- needed,
- <br>Either login to xml.apache.org and cd to /www/xml.apache.org and
- do an update of directories there as needed,
- <br>Or send an email to infrastructure<at>apache.org and ask for
- your website to be added to the cronjob for automatic update.
- </p>
+ To update a part of the website (that does *not* use Forrest)
do this:
+ <br>Checkout the xml-site module (you only actually need a
few subdirs,
+ but the whole thing is quite large).
+ <br>Make updates to the .xml files in the
xml-site/sources/website
+ directory.
+ <br>Go to the xml-site/sources directory locally and run the
relevant
+ shell or bat script.
+ <br>Check that the .html structure in your local targets
directory is
+ built correctly.
+ <br>Checkin to CVS both your updated sources/ and
targets/ trees as
+ needed,
+ <br>Either login to xml.apache.org and cd to
/www/xml.apache.org and
+ do an update of directories there as needed,
+ <br>Or send an email to infrastructure<at>apache.org
and ask for
+ your website to be added to the cronjob for automatic
update.
+ </p>
+</div>
</div>
+
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif"></td>
</tr>
1.10 +323 -152 xml-site/targets/guidelines.pdf
<<Binary file>>
1.11 +145 -145 xml-site/targets/index.pdf
<<Binary file>>
1.7 +29 -29 xml-site/targets/legal.pdf
<<Binary file>>
1.7 +60 -60 xml-site/targets/library.pdf
<<Binary file>>
1.7 +167 -167 xml-site/targets/mail.pdf
<<Binary file>>
1.8 +46 -46 xml-site/targets/management.pdf
<<Binary file>>
1.7 +113 -113 xml-site/targets/mission.pdf
<<Binary file>>
1.52 +55 -24 xml-site/targets/news.html
Index: news.html
===================================================================
RCS file: /home/cvs/xml-site/targets/news.html,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -r1.51 -r1.52
--- news.html 3 Aug 2003 10:37:51 -0000 1.51
+++ news.html 4 Aug 2003 12:51:49 -0000 1.52
@@ -344,6 +344,12 @@
<a href="#news">Current News</a>
<ul class="minitoc">
<li>
+<a href="#xerces-j-2.5.0">Xerces-J 2.5.0 released (July 31, 2003)</a>
+</li>
+<li>
+<a href="#cocoon-2.1-rc">Cocoon 2.1 Release Candidate released (July 30,
2003)</a>
+</li>
+<li>
<a href="#fop-0.20.5">FOP 0.20.5 released (July 18, 2003)</a>
</li>
<li>
@@ -429,7 +435,32 @@
updating the xml.apache.org website in the
<a href="guidelines.html">guidelines</a>.
</p>
-<a name="N101CB"></a><a name="fop-0.20.5"></a>
+<a name="N101CB"></a><a name="xerces-j-2.5.0"></a>
+<h4>Xerces-J 2.5.0 released (July 31, 2003)</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The Apache Xerces2 Java Parser team is very happy to announce that
version 2.5.0 of Xerces2 Java Parser is now available.
+ </p>
+<p>
+ This release provides a partial partial implementation of the XML
Inclusions (XInclude) W3C Candidate Recommendation and also brings Xerces-J
into compliance with the most recent work of the W3C DOM working group on DOM
level 3 Core and Load/Save.
+ </p>
+<p>
+ The release can be downloaded from <a
href="http://xml.apache.org/dist/xerces-j/";>http://xml.apache.org/dist/xerces-j/</a>
+</p>
+<p>
+ For more information, visit the <a
href="http://xml.apache.org/xerces2-j/";>Apache Xerces2 Java Parser Project
WebSite</a>.
+ </p>
+</div>
+<a name="N101E5"></a><a name="cocoon-2.1-rc"></a>
+<h4>Cocoon 2.1 Release Candidate released (July 30, 2003)</h4>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+ The Apache Cocoon Team is pleased to announce the release of Cocoon
2.1 Release Candidate.
+ </p>
+<p>Check out the Cocoon website <a
href="http://cocoon.apache.org/2.1/";>http://cocoon.apache.org/2.1/</a> for more
information.
+ </p>
+</div>
+<a name="N101F6"></a><a name="fop-0.20.5"></a>
<h4>FOP 0.20.5 released (July 18, 2003)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -439,7 +470,7 @@
for details.
</p>
</div>
-<a name="N101D9"></a><a name="cocoon-toplevel"></a>
+<a name="N10204"></a><a name="cocoon-toplevel"></a>
<h4>New top-level project: Cocoon</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -447,7 +478,7 @@
will find the new website here: <a
href="http://cocoon.apache.org/";>http://cocoon.apache.org</a>.
</p>
</div>
-<a name="N101E7"></a><a name="ws"></a>
+<a name="N10212"></a><a name="ws"></a>
<h4>Web Services project launched (February 19, 2003)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -455,7 +486,7 @@
formed Web Services project, <a
href="http://ws.apache.org/";>http://ws.apache.org</a>.
</p>
</div>
-<a name="N101F5"></a><a name="forrest-0.4"></a>
+<a name="N10220"></a><a name="forrest-0.4"></a>
<h4>Forrest 0.4 released (February 12, 2003)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -465,7 +496,7 @@
See <a
href="http://www.apache.org/dyn/closer.cgi/xml/forrest/RELEASE-NOTES-0.4.txt";>release
notes</a>.
</p>
</div>
-<a name="N10203"></a><a name="forrest-0.3"></a>
+<a name="N1022E"></a><a name="forrest-0.3"></a>
<h4>Forrest 0.3 released (January 31, 2003)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -475,7 +506,7 @@
See <a
href="http://www.apache.org/dyn/closer.cgi/xml/forrest/RELEASE-NOTES-0.3.txt";>release
notes</a>.
</p>
</div>
-<a name="N10211"></a><a name="cocoon-2.0.4"></a>
+<a name="N1023C"></a><a name="cocoon-2.0.4"></a>
<h4>Cocoon 2.0.4 released (December 06, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -484,7 +515,7 @@
<a target="_top" href="http://xml.apache.org/dist/cocoon/";>download
pages</a>.
</p>
</div>
-<a name="N1021F"></a><a name="forrest-0.2.1"></a>
+<a name="N1024A"></a><a name="forrest-0.2.1"></a>
<h4>Forrest 0.2.1 released (November 23, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -494,7 +525,7 @@
upgrade. Forrest 0.2.1 may be obtained from the <a target="_top"
href="http://www.apache.org/dyn/closer.cgi/xml/forrest/";>Apache Project
Mirrors</a>.
</p>
</div>
-<a name="N10231"></a><a name="forrest-0.2"></a>
+<a name="N1025C"></a><a name="forrest-0.2"></a>
<h4>Forrest 0.2 released (November 16, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -504,7 +535,7 @@
<a target="_top" href="http://xml.apache.org/forrest/";>Apache
Forrest</a> site.
</p>
</div>
-<a name="N1023F"></a><a name="forrest-built-website"></a>
+<a name="N1026A"></a><a name="forrest-built-website"></a>
<h4>Initial Forrest website launched (June 1, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -514,7 +545,7 @@
out</a>.
</p>
</div>
-<a name="N1024D"></a><a name="cocoon-2.0.3"></a>
+<a name="N10278"></a><a name="cocoon-2.0.3"></a>
<h4>Cocoon 2.0.3 released (July 15, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -522,7 +553,7 @@
Cocoon 2.0.3. The distribution is available from the <a
target="_top" href="http://xml.apache.org/dist/cocoon";>download pages</a>.
</p>
</div>
-<a name="N1025B"></a><a name="cocoon-2.0.2"></a>
+<a name="N10286"></a><a name="cocoon-2.0.2"></a>
<h4>Cocoon 2.0.2 released (March 26, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -530,7 +561,7 @@
Cocoon 2.0.2. The distribution is available from the <a
target="_top" href="http://xml.apache.org/dist/cocoon";>download pages</a>.
</p>
</div>
-<a name="N10269"></a><a name="cocoon-2.0.1"></a>
+<a name="N10294"></a><a name="cocoon-2.0.1"></a>
<h4>Cocoon 2.0.1 released (January 31, 2002)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -538,7 +569,7 @@
Cocoon 2.0.1. The distribution is available from the <a
target="_top" href="http://xml.apache.org/dist/cocoon";>download pages</a>.
</p>
</div>
-<a name="N10277"></a><a name="xerces-2.0.0"></a>
+<a name="N102A2"></a><a name="xerces-2.0.0"></a>
<h4>Xerces 2.0.0 (beta) is released</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -547,7 +578,7 @@
available from the <a target="_top"
href="http://xml.apache.org/dist/";>download pages</a>.
</p>
</div>
-<a name="N10285"></a><a name="xml-commons-announce"></a>
+<a name="N102B0"></a><a name="xml-commons-announce"></a>
<h4>xml-commons subproject is formed! (Summer-01)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -557,7 +588,7 @@
mailing list.
</p>
</div>
-<a name="N1028F"></a><a name="xalan-j-award"></a>
+<a name="N102BA"></a><a name="xalan-j-award"></a>
<h4>Xalan-J was nominated for an award! (Summer-01)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Dear Apache XML Project,<br>
@@ -588,7 +619,7 @@
</p>
</div>
-<a name="N102AD"></a><a name="batik-award"></a>
+<a name="N102D8"></a><a name="batik-award"></a>
<h4>Batik was nominated for an award! (Sep-01)</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Some details were posted on <a target="_top"
href="http://marc.theaimsgroup.com/?l=xml-apache-general&m=99973420212175&w=2";>the
general mailing list</a>
@@ -597,10 +628,10 @@
</div>
</div>
-<a name="N102BC"></a><a name="project-status"></a>
+<a name="N102E7"></a><a name="project-status"></a>
<h3>Project Status</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N102C2"></a><a name="batik-status"></a>
+<a name="N102ED"></a><a name="batik-status"></a>
<h4>Batik Status: Source Code and Binaries Available</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -609,7 +640,7 @@
<a target="_top" href="http://xml.apache.org/dist/";>download pages</a>!
</p>
</div>
-<a name="N102D0"></a><a name="xang-status"></a>
+<a name="N102FB"></a><a name="xang-status"></a>
<h4>Xang - Source code for XPages from Datachannel released</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -618,7 +649,7 @@
<a target="_top" href="http://xml.apache.org/dist/";>download pages</a>
for the source.
</p>
</div>
-<a name="N102DE"></a><a name="crimson-status"></a>
+<a name="N10309"></a><a name="crimson-status"></a>
<h4>Crimson - Source code for Project X from Sun released</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -630,7 +661,7 @@
<p>The current production release is Crimson 1.1.2beta2(Sep-01).
Work on Crimson is mostly limited to bugfixing; discussions take place
on [EMAIL PROTECTED]</p>
</div>
-<a name="N102EF"></a><a name="xerces-status"></a>
+<a name="N1031A"></a><a name="xerces-status"></a>
<h4>Xerces status: Source Code and Binaries Available</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -643,7 +674,7 @@
Work on 1.x is mostly limited to bugfixing; most of the Xerces community
is moving forward with Xerces 2.x codebase.</p>
</div>
-<a name="N10300"></a><a name="xalan-status"></a>
+<a name="N1032B"></a><a name="xalan-status"></a>
<h4>Xalan Status: Source Code and Binaries Available</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -653,7 +684,7 @@
source!
</p>
</div>
-<a name="N1030E"></a><a name="fop-status"></a>
+<a name="N10339"></a><a name="fop-status"></a>
<h4>FOP Status: Source Code and Binaries Available</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -665,7 +696,7 @@
</div>
</div>
-<a name="N1031D"></a><a name="past-news"></a>
+<a name="N10348"></a><a name="past-news"></a>
<h3>Past News</h3>
<div style="margin-left: 0 ; border: 2px">
<ul>
1.12 +761 -446 xml-site/targets/news.pdf
<<Binary file>>
1.8 +74 -74 xml-site/targets/overview.pdf
<<Binary file>>
1.8 +74 -74 xml-site/targets/roles.pdf
<<Binary file>>
1.7 +68 -68 xml-site/targets/source.pdf
<<Binary file>>
1.11 +71 -71 xml-site/targets/whoweare.pdf
<<Binary file>>
1.6 +1 -1 xml-site/targets/skin/breadcrumbs.js
Index: breadcrumbs.js
===================================================================
RCS file: /home/cvs/xml-site/targets/skin/breadcrumbs.js,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- breadcrumbs.js 3 Aug 2003 10:37:53 -0000 1.5
+++ breadcrumbs.js 4 Aug 2003 12:51:49 -0000 1.6
@@ -4,7 +4,7 @@
The Apache Software License, Version 1.1
============================================================================
- Copyright (C) 2002-2003 The Apache Software Foundation. All rights reserved.
+ Copyright (C) 2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
