stevenn 2002/11/24 00:10:05
Modified: targets/forrest todo.html validation.html validation.pdf
who.html your-project.html your-project.pdf
Log:
updated website with 0.20.1 branch - new downloads / issues location
Revision Changes Path
1.5 +5 -1 xml-site/targets/forrest/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/todo.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- todo.html 12 Nov 2002 17:28:56 -0000 1.4
+++ todo.html 24 Nov 2002 08:10:04 -0000 1.5
@@ -108,7 +108,7 @@
</li>
<li>
-<a target="_blank"
href="http://cvs.apache.org/~jefft/forrest/releases/0.2/";>Download</a>
+<a target="_blank" href="http://xml.apache.org/dist/forrest/";>Download</a>
</li>
<li>
@@ -163,6 +163,10 @@
<li>
<a href="mail-archives.html">Mail Archives</a>
+</li>
+
+<li>
+<a
href="http://issues.cocoondev.org/jira/secure/BrowseProject.jspa?id=10000";>Bugs
and Issues</a>
</li>
</ul>
1.5 +58 -51 xml-site/targets/forrest/validation.html
Index: validation.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/validation.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- validation.html 20 Nov 2002 13:28:13 -0000 1.4
+++ validation.html 24 Nov 2002 08:10:04 -0000 1.5
@@ -6,26 +6,18 @@
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body marginheight="0" marginwidth="0" topmargin="0" leftmargin="0"
text="#000000" bgcolor="#FFFFFF">
-<!--================= start Navigation Path ==================-->
<table summary="navigation path" width="100%" border="0" cellpadding="0"
cellspacing="0">
<tr>
-<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" border="0" src="skin/images/spacer.gif"><!--=====
breadcrumb trail (javascript-generated) ====--><font size="2" face="Arial,
Helvetica, Sans-serif"><script src="skin/breadcrumbs.js" language="JavaScript"
type="text/javascript"></script></font></td>
+<td nowrap="nowrap" valign="middle" bgcolor="#CFDCED" height="20"><img
height="1" width="5" alt="" border="0" src="skin/images/spacer.gif"><font
size="2" face="Arial, Helvetica, Sans-serif"><script src="skin/breadcrumbs.js"
language="JavaScript" type="text/javascript"></script></font></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" height="2"><img height="2" width="2" alt="" border="0"
src="skin/images/spacer.gif"></td>
</tr>
</table>
-<!--================= end Navigation Path ==================-->
-<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0"
cellspacing="0">
<tr>
-<!--================= start Group Logo ==================-->
-<td bgcolor="#294563"><a href="http://xml.apache.org/";><img border="0"
class="logoImage" alt="Apache XML" src="images/group-logo.gif"></a></td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td
width="100%" align="center" bgcolor="#294563"><a
href="http://xml.apache.org/forrest/";><img border="0" class="logoImage"
alt="Forrest" src="images/project-logo.gif"></a></td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top"
rowspan="2" bgcolor="#294563">
-<form target="_blank" onsubmit="q.value = query.value +
'site:xml.apache.org'" action="http://www.google.com/search"; method="get">
+<td bgcolor="#294563"><a href="http://xml.apache.org/";><img border="0"
alt="Apache XML logo" src="images/group-logo.gif"></a></td><td width="100%"
align="center" bgcolor="#294563"><a href="http://xml.apache.org/forrest/";><img
alt="Forrest site" border="0" src="images/project-logo.gif"></a></td><td
valign="top" rowspan="2" bgcolor="#294563">
+<form target="_blank" onsubmit="q.value = query.value + '
site:xml.apache.org'" action="http://www.google.com/search"; method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0"
bgcolor="#4C6C8F">
<tr>
<td colspan="3"><img height="10" width="1" alt=""
src="skin/images/spacer.gif"></td>
@@ -34,62 +26,64 @@
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td
nowrap="nowrap"><input name="q" type="hidden"><input size="15" id="query"
type="text"><img height="1" width="5" alt=""
src="skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
<br>
<font face="Arial, Helvetica, Sans-serif" size="2" color="white">
- the Apache XML site
-
-
- </font></td><td><img height="1" width="1" alt=""
src="skin/images/spacer.gif"></td>
+ the Apache XML site
+
+
+ </font></td><td><img height="1" width="1" alt=""
src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img alt="" border="0" height="10" width="9"
src="skin/images/search-left.gif"></td><td><img height="1" width="1" alt=""
src="skin/images/spacer.gif"></td><td><img alt="" border="0" height="10"
width="9" src="skin/images/search-right.gif"></td>
</tr>
</table>
</form>
-</td>
-<!--================= start Search ==================--><td
bgcolor="#294563"><img height="10" width="10" alt=""
src="skin/images/spacer.gif"></td>
+</td><td bgcolor="#294563"><img height="10" width="10" alt=""
src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#294563" colspan="2">
-<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
+
+
+
+
<td width="8"><img alt="" height="8" width="8"
src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" height="30" border="0" cellpadding="0"
cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#4C6C8F"><img height="5" width="5"
alt="" src="skin/images/tabSel-left.gif"></td><td valign="middle"
bgcolor="#4C6C8F"><font color="#ffffff" size="2" face="Arial, Helvetica,
Sans-serif"><b>Home</b></font></td><td valign="top" width="5"
bgcolor="#4C6C8F"><img height="5" width="5" alt=""
src="skin/images/tabSel-right.gif"></td>
</tr>
</table>
-</td><td width="8"><img alt="" height="8" width="8"
src="skin/images/spacer.gif"></td><td valign="bottom">
+</td>
+ <td width="8"><img alt="" height="8" width="8"
src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="non selected tab" height="25" border="0" cellpadding="0"
cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5"
alt="" src="skin/images/tab-left.gif"></td><td valign="middle"
bgcolor="#B2C4E0"><a href="community/index.html"><font size="2" face="Arial,
Helvetica, Sans-serif">Community</font></a></td><td valign="top" width="5"
bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
</tr>
</table>
-</td><td width="8"><img alt="" height="8" width="8"
src="skin/images/spacer.gif"></td><td valign="bottom">
+</td>
+ <td width="8"><img alt="" height="8" width="8"
src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="non selected tab" height="25" border="0" cellpadding="0"
cellspacing="0">
<tr>
<td valign="top" width="5" bgcolor="#B2C4E0"><img height="5" width="5"
alt="" src="skin/images/tab-left.gif"></td><td valign="middle"
bgcolor="#B2C4E0"><a href="community/howto/index.html"><font size="2"
face="Arial, Helvetica, Sans-serif">How-Tos</font></a></td><td valign="top"
width="5" bgcolor="#B2C4E0"><img height="5" width="5" alt=""
src="skin/images/tab-right.gif"></td>
</tr>
</table>
</td>
+
+
</tr>
</table>
</div>
-<!--================= end Tabs ==================-->
</td><td bgcolor="#294563"><img alt="" width="1" height="1"
src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#4C6C8F" colspan="4"><img width="1" height="10" alt=""
src="skin/images/spacer.gif"></td>
</tr>
</table>
-<!--================= end Banner ==================-->
-<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0"
cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
-<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
@@ -102,9 +96,7 @@
<td bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif"></td>
</tr>
</table>
-</td>
-<!--================= end left top NavBar ==================--><td
bgcolor="#294563"><img width="1" height="1" alt=""
src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img
width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
-<!--================= start Menu items ==================-->
+</td><td bgcolor="#294563"><img width="1" height="1" alt=""
src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#4C6C8F"><img
width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td
nowrap="nowrap" valign="top" bgcolor="#4C6C8F">
<div class="menu">
<ul>
<li>
@@ -116,7 +108,7 @@
</li>
<li>
-<a target="_blank"
href="http://cvs.apache.org/~jefft/forrest/releases/0.2/";>Download</a>
+<a target="_blank" href="http://xml.apache.org/dist/forrest/";>Download</a>
</li>
<li>
@@ -172,6 +164,10 @@
<li>
<a href="mail-archives.html">Mail Archives</a>
</li>
+
+<li>
+<a
href="http://issues.cocoondev.org/jira/secure/BrowseProject.jspa?id=10000";>Bugs
and Issues</a>
+</li>
</ul>
</li>
@@ -261,7 +257,6 @@
</li>
</ul>
</div>
-<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#4C6C8F"><img width="10" height="10"
alt="" src="skin/images/spacer.gif"></td><td bgcolor="#294563"><img width="1"
height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
@@ -273,24 +268,21 @@
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0"
cellspacing="0">
-<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1"
alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
+
</font><img width="10" height="8" alt=""
src="skin/images/spacer.gif"></td><td align="right" width="50%"
bgcolor="#CFDCED"><font color="#4C6C8F" size="3" face="Arial, Helvetica,
Sans-serif">
-
+
</font><img width="10" height="8" alt=""
src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img
width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#294563"><img width="10" height="1" alt=""
src="skin/images/spacer.gif"></td>
</tr>
-<!--================= end middle NavBar ==================-->
-<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
@@ -299,8 +291,8 @@
<td valign="middle">
<h1>XML Validation</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida"
href="validation.pdf"><img src="skin/images/printer.gif" border="0"><br>
- print-friendly<br>
- version</a></td>
+ print-friendly<br>
+ version</a></td>
</tr>
</table>
<h3>DTDs, catalogs and whatnot</h3>
@@ -323,15 +315,15 @@
</ul>
</li>
<li>
-<a href="#N100FE">Validating in an editor</a>
+<a href="#N10110">Validating in an editor</a>
<ul class="minitoc">
<li>
-<a href="#N10106">Case study: setting up xmllint</a>
+<a href="#N10118">Case study: setting up xmllint</a>
</li>
</ul>
</li>
<li>
-<a href="#N1012E">Validation using RELAX NG</a>
+<a href="#N10140">Validation using RELAX NG</a>
</li>
</ul>
@@ -605,10 +597,8 @@
types that Forrest provides. Projects can augment this with their
own catalog file in <span
class="codefrag">${project.schema-dir}/catalog</span>.
Add the "local-catalog" parameter to your
- <span class="codefrag">src/documentation/conf/cocoon.xconf</span>
- as described in that file. (Copy the default one from
- <span
class="codefrag">xml-forrest/src/resources/conf/cocoon.xconf</span>)
- Remember to raise the "verbosity" level in
+ <span
class="codefrag">build/tmp/context/WEB-INF/cocoon.xconf</span> as described
+ in that file. Remember to raise the "verbosity" level in
<span class="codefrag">cocoon.xconf</span> if you suspect problems
with your catalog.
</p>
<p>
@@ -622,6 +612,27 @@
-- custom doctype --
PUBLIC "-//Acme//DTD Download Documentation V1.0//EN"
"dtd/download-v11.dtd"
</pre>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Currently (2002-11-15) Forrest does not allow you to
use a
+ <span class="codefrag">cocoon.xconf</span> configuration file with
your project.
+ However, one is copied during the build to
+ <span
class="codefrag">build/tmp/context/WEB-INF/cocoon.xconf</span> so after the
+ first run of the '<span class="codefrag">forrest</span>' you can
use that one.
+ We are working on fixing this.
+ </div>
+</div>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Currently (2002-11-15) Forrest does not utilise your
project
+ OASIS catalog when doing '<span class="codefrag">forrest
validate</span>'. This is
+ because Ant does not read this additional catalog. Until this is
+ fixed (all help appreciated!) it is currently simpler just to
+ hand-validate custom XML files, use
+ <span class="codefrag">project.validate.xdocs.excludes</span> to
prevent validation of
+ new document types.
+ </div>
+</div>
<p>
The format is described in <a
href="http://www.oasis-open.org/committees/entity/background/9401.html";>the
spec</a>, and is fairly simple. Lines beginning with
@@ -634,7 +645,7 @@
our download file would validate along with all the others.
</p>
-<a name="N100FE"></a>
+<a name="N10110"></a>
<h3>Validating in an editor</h3>
<p>
If you have an XML editor that understands SGML or XML catalogs, let
@@ -642,7 +653,7 @@
validate any Forrest XML file, regardless of location, as you edit
your files.
</p>
-<a name="N10106"></a>
+<a name="N10118"></a>
<h4>Case study: setting up xmllint</h4>
<p>
On *nix systems, one of the best XML validation tools is
@@ -672,7 +683,7 @@
<a name="relaxng"></a>
- <a name="N1012E"></a>
+ <a name="N10140"></a>
<h3>Validation using RELAX NG</h3>
<p>
Other validation is also conducted during build-time using RELAX NG.
@@ -691,13 +702,10 @@
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif"></td>
</tr>
-<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
-<!--================= end Menu, NavBar, Content ==================-->
-<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%"
height="20" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#4C6C8F"><img height="1" width="1"
alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a
href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a
href="skin/images/chapter_open.gif"></a><a
href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
@@ -709,9 +717,8 @@
// --></script></font></td>
</tr>
<tr>
-<td colspan="2" align="left" bgcolor="#CFDCED" class="logos"></td>
+<td align="left" bgcolor="#CFDCED" class="logos"></td><td align="right"
bgcolor="#CFDCED" class="logos"></td>
</tr>
</table>
-<!--================= end Footer ==================-->
</body>
</html>
1.4 +99 -86 xml-site/targets/forrest/validation.pdf
<<Binary file>>
1.7 +5 -1 xml-site/targets/forrest/who.html
Index: who.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/who.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- who.html 15 Nov 2002 08:07:32 -0000 1.6
+++ who.html 24 Nov 2002 08:10:04 -0000 1.7
@@ -108,7 +108,7 @@
</li>
<li>
-<a target="_blank"
href="http://cvs.apache.org/~jefft/forrest/releases/0.2/";>Download</a>
+<a target="_blank" href="http://xml.apache.org/dist/forrest/";>Download</a>
</li>
<li>
@@ -163,6 +163,10 @@
<li>
<a href="mail-archives.html">Mail Archives</a>
+</li>
+
+<li>
+<a
href="http://issues.cocoondev.org/jira/secure/BrowseProject.jspa?id=10000";>Bugs
and Issues</a>
</li>
</ul>
1.7 +30 -20 xml-site/targets/forrest/your-project.html
Index: your-project.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/your-project.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- your-project.html 15 Nov 2002 08:07:33 -0000 1.6
+++ your-project.html 24 Nov 2002 08:10:04 -0000 1.7
@@ -108,7 +108,7 @@
</li>
<li>
-<a target="_blank"
href="http://cvs.apache.org/~jefft/forrest/releases/0.2/";>Download</a>
+<a target="_blank" href="http://xml.apache.org/dist/forrest/";>Download</a>
</li>
<li>
@@ -164,6 +164,10 @@
<li>
<a href="mail-archives.html">Mail Archives</a>
</li>
+
+<li>
+<a
href="http://issues.cocoondev.org/jira/secure/BrowseProject.jspa?id=10000";>Bugs
and Issues</a>
+</li>
</ul>
</li>
@@ -343,37 +347,37 @@
<a href="#N10189">Example: Adding a new content type</a>
</li>
<li>
-<a href="#N101F6">Example: integrating external RSS content</a>
+<a href="#N101F9">Example: integrating external RSS content</a>
</li>
<li>
-<a href="#N10203">Example: Generating PNG from SVG</a>
+<a href="#N10206">Example: Generating PNG from SVG</a>
</li>
</ul>
</li>
<li>
-<a href="#N10252">Forrest skins</a>
+<a href="#N10255">Forrest skins</a>
<ul class="minitoc">
<li>
-<a href="#N1026A">Defining a new skin</a>
+<a href="#N1026D">Defining a new skin</a>
</li>
</ul>
</li>
<li>
-<a href="#N10298">Forrest webapps: developing docs faster</a>
+<a href="#N1029B">Forrest webapps: developing docs faster</a>
<ul class="minitoc">
<li>
-<a href="#N102A8">Installing a servlet engine</a>
+<a href="#N102AB">Installing a servlet engine</a>
</li>
<li>
-<a href="#N102B9">Generating a site webapp</a>
+<a href="#N102BC">Generating a site webapp</a>
</li>
<li>
-<a href="#N102D9">Using the webapp</a>
+<a href="#N102DC">Using the webapp</a>
</li>
</ul>
</li>
<li>
-<a href="#N102FC">Invoking Forrest from Ant</a>
+<a href="#N102FF">Invoking Forrest from Ant</a>
</li>
</ul>
@@ -976,7 +980,13 @@
By declaring a custom 'body-download.xml' rule <em>before</em>
this
rule, we intercept the request, and can apply our stylesheet.
</p>
-<a name="N101CE"></a>
+<p>
+ Note that you may want to tweak that example rule for
+ body-download.xml so that it will find download.xml files in
+ subdirectories or with different names. Follow the syntax from
+ the other sitemap rules to do so.
+ </p>
+<a name="N101D1"></a>
<h4>Registering a new DTD</h4>
<p>
By default, Forrest requires that all XML files be valid: ie
@@ -1007,7 +1017,7 @@
Please read <a href="validation.html">XML Validation</a>
for the full story.
</p>
-<a name="N101F6"></a>
+<a name="N101F9"></a>
<h4>Example: integrating external RSS content</h4>
<p>
Using the same idea described in the previous section, we can
do things
@@ -1023,7 +1033,7 @@
</map:call>
</map:match>
</pre>
-<a name="N10203"></a>
+<a name="N10206"></a>
<h4>Example: Generating PNG from SVG</h4>
<p>
@@ -1104,7 +1114,7 @@
<img class="figure" alt="Sample logo" src="images/sample-logo.png"></div>
-<a name="N10252"></a>
+<a name="N10255"></a>
<h3>Forrest skins</h3>
<p>
As Forrest separates content from presentation, we can plug in
different
@@ -1126,7 +1136,7 @@
Ant @token@ values to Cocoon input module values.
</div>
</div>
-<a name="N1026A"></a>
+<a name="N1026D"></a>
<h4>Defining a new skin</h4>
<p>
Projects can define their own skin, in the
@@ -1168,7 +1178,7 @@
</dl>
-<a name="N10298"></a>
+<a name="N1029B"></a>
<h3>Forrest webapps: developing docs faster</h3>
<p>
In comparison to simpler tools like <a
href="http://jakarta.apache.org/velocity/anakia.html";>Anakia</a>,
@@ -1179,7 +1189,7 @@
developing with a "live" Forrest webapp instance, Forrest-based doc
development can be faster and easier than comparable tools.
</p>
-<a name="N102A8"></a>
+<a name="N102AB"></a>
<h4>Installing a servlet engine</h4>
<p>
To run a "live" forrest, you'll need a servlet container, like
<a href="http://jakarta.apache.org/tomcat";>Jakarta Tomcat</a>. The
@@ -1187,7 +1197,7 @@
3.3.1</a>, which has been fairly well tested with Forrest,
restarts much faster than 4.x, and handles context reloads well.
</p>
-<a name="N102B9"></a>
+<a name="N102BC"></a>
<h4>Generating a site webapp</h4>
<p>
To generate a webapp rather than a static HTML site, run <span
class="codefrag">forrest
@@ -1224,7 +1234,7 @@
... you should see a dynamically generated
page identical to that produced by the Cocoon crawler.
</p>
-<a name="N102D9"></a>
+<a name="N102DC"></a>
<h4>Using the webapp</h4>
<p>
With the setup above, you can edit the XML files in
@@ -1248,7 +1258,7 @@
</div>
</div>
-<a name="N102FC"></a>
+<a name="N102FF"></a>
<h3>Invoking Forrest from Ant</h3>
<p>
Established Java projects which use Ant will typically wish to
subsume
1.6 +151 -125 xml-site/targets/forrest/your-project.pdf
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
