Browse Source

modularize site.vsl, add a first cut at a FAQ with a stylesheet of its

own.


git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268969 13f79535-47bb-0310-9956-ffa450edef68
master
Stefan Bodewig 24 years ago
parent
commit
bc4d066c11
10 changed files with 1874 additions and 1326 deletions
  1. +9
    -1
      webpage/build.xml
  2. +163
    -176
      webpage/docs/antnews.html
  3. +739
    -688
      webpage/docs/external.html
  4. +313
    -0
      webpage/docs/faq.html
  5. +210
    -223
      webpage/docs/index.html
  6. +2
    -0
      webpage/velocity.properties
  7. +74
    -0
      webpage/xdocs/faq.xml
  8. +117
    -0
      webpage/xdocs/stylesheets/faq.vsl
  9. +51
    -238
      webpage/xdocs/stylesheets/site.vsl
  10. +196
    -0
      webpage/xdocs/stylesheets/templates.vm

+ 9
- 1
webpage/build.xml View File

@@ -33,12 +33,20 @@
<anakia basedir="${docs.src}" destdir="${docs.dest}/" <anakia basedir="${docs.src}" destdir="${docs.dest}/"
extension=".html" style="./site.vsl" extension=".html" style="./site.vsl"
projectFile="stylesheets/project.xml" projectFile="stylesheets/project.xml"
excludes="**/stylesheets/** empty.xml"
excludes="**/stylesheets/** faq.xml"
includes="**/*.xml" includes="**/*.xml"
lastModifiedCheck="true" lastModifiedCheck="true"
templatePath="./xdocs/stylesheets"> templatePath="./xdocs/stylesheets">
</anakia> </anakia>


<anakia basedir="${docs.src}" destdir="${docs.dest}/"
extension=".html" style="./faq.vsl"
projectFile="stylesheets/project.xml"
includes="faq.xml"
lastModifiedCheck="true"
templatePath="./xdocs/stylesheets">
</anakia>

<!-- In case we have images some day <!-- In case we have images some day
<copy todir="${docs.dest}/images" filtering="no"> <copy todir="${docs.dest}/images" filtering="no">
<fileset dir="${docs.src}/images"> <fileset dir="${docs.src}/images">


+ 163
- 176
webpage/docs/antnews.html View File

@@ -4,142 +4,139 @@


<!-- start the processing --> <!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html> <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Conor MacNeill">
<meta name="email" value="conor@cortexebusiness.com.au">
<title>The Jakarta Site - Ant News</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>Ant</strong></p>
<ul>
<li> <a href="./index.html">Front Page</a>
</li>
<li> <a href="./antnews.html">News</a>
</li>
<li> <a href="./external.html">External Resources</a>
</li>
</ul>
<p><strong>Jakarta</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Get Involved</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Other Projects</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
<li> <a href="http://jakarta.apache.org/commons/index.html">Commons</a>
</li>
<li> <a href="http://jakarta.apache.org/ecs/index.html">ECS</a>
</li>
<li> <a href="http://jakarta.apache.org/james/index.html">James</a>
</li>
<li> <a href="http://jakarta.apache.org/jetspeed/index.html">Jetspeed</a>
</li>
<li> <a href="http://jakarta.apache.org/jmeter/index.html">JMeter</a>
</li>
<li> <a href="http://jakarta.apache.org/log4j/index.html">Log4J</a>
</li>
<li> <a href="http://jakarta.apache.org/oro/index.html">ORO</a>
</li>
<li> <a href="http://jakarta.apache.org/regexp/index.html">Regexp</a>
</li>
<li> <a href="http://jakarta.apache.org/slide/index.html">Slide</a>
</li>
<li> <a href="http://jakarta.apache.org/struts/index.html">Struts</a>
</li>
<li> <a href="http://jakarta.apache.org/taglibs/index.html">Taglibs</a>
</li>
<li> <a href="http://jakarta.apache.org/tomcat/index.html">Tomcat</a>
</li>
<li> <a href="http://jakarta.apache.org/turbine/index.html">Turbine</a>
</li>
<li> <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a>
</li>
<li> <a href="http://jakarta.apache.org/watchdog/index.html">Watchdog</a>
</li>
</ul>
<p><strong>Misc</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/whoweare.html">Who We Are</a>
</li>
<li> <a href="http://jakarta.apache.org/site/acknowledgements.html">Acknowledgements</a>
</li>
<li> <a href="http://jakarta.apache.org/site/roles.html">Management</a>
</li>
<li> <a href="http://jakarta.apache.org/site/jakarta-site2.html">About This Site</a>
</li>
<li> <a href="http://jakarta.apache.org/site/contact.html">Contact</a>
</li>
<li> <a href="http://jakarta.apache.org/site/legal.html">Legal</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Ant 2.0 Requirements</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>Ant has been in use for quite some time and has been used in ways never conceived when it
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Conor MacNeill">
<meta name="email" value="conor@cortexebusiness.com.au">
<title>The Jakarta Site - Ant News</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>Ant</strong></p>
<ul>
<li> <a href="./index.html">Front Page</a>
</li>
<li> <a href="./antnews.html">News</a>
</li>
<li> <a href="./external.html">External Resources</a>
</li>
</ul>
<p><strong>Jakarta</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Get Involved</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Other Projects</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
<li> <a href="http://jakarta.apache.org/commons/index.html">Commons</a>
</li>
<li> <a href="http://jakarta.apache.org/ecs/index.html">ECS</a>
</li>
<li> <a href="http://jakarta.apache.org/james/index.html">James</a>
</li>
<li> <a href="http://jakarta.apache.org/jetspeed/index.html">Jetspeed</a>
</li>
<li> <a href="http://jakarta.apache.org/jmeter/index.html">JMeter</a>
</li>
<li> <a href="http://jakarta.apache.org/log4j/index.html">Log4J</a>
</li>
<li> <a href="http://jakarta.apache.org/oro/index.html">ORO</a>
</li>
<li> <a href="http://jakarta.apache.org/regexp/index.html">Regexp</a>
</li>
<li> <a href="http://jakarta.apache.org/slide/index.html">Slide</a>
</li>
<li> <a href="http://jakarta.apache.org/struts/index.html">Struts</a>
</li>
<li> <a href="http://jakarta.apache.org/taglibs/index.html">Taglibs</a>
</li>
<li> <a href="http://jakarta.apache.org/tomcat/index.html">Tomcat</a>
</li>
<li> <a href="http://jakarta.apache.org/turbine/index.html">Turbine</a>
</li>
<li> <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a>
</li>
<li> <a href="http://jakarta.apache.org/watchdog/index.html">Watchdog</a>
</li>
</ul>
<p><strong>Misc</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/whoweare.html">Who We Are</a>
</li>
<li> <a href="http://jakarta.apache.org/site/acknowledgements.html">Acknowledgements</a>
</li>
<li> <a href="http://jakarta.apache.org/site/roles.html">Management</a>
</li>
<li> <a href="http://jakarta.apache.org/site/jakarta-site2.html">About This Site</a>
</li>
<li> <a href="http://jakarta.apache.org/site/contact.html">Contact</a>
</li>
<li> <a href="http://jakarta.apache.org/site/legal.html">Legal</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Ant 2.0 Requirements</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>Ant has been in use for quite some time and has been used in ways never conceived when it
was originally written. While Ant 1.x has continued to sucessfully evolve and grow, there was originally written. While Ant 1.x has continued to sucessfully evolve and grow, there
are a number of limitations and inconsistencies that are now apparent and which need to are a number of limitations and inconsistencies that are now apparent and which need to
be addressed. be addressed.
</p> </p>
<p>
<p>
As we continue to evolve and enhance Ant 1.x, it is now time to define what Ant 2.0 will As we continue to evolve and enhance Ant 1.x, it is now time to define what Ant 2.0 will
encompass. Ant 2.0 will be a major rearchitecting of Ant. It has a number of goals including: encompass. Ant 2.0 will be a major rearchitecting of Ant. It has a number of goals including:
<ul> <ul>
@@ -153,7 +150,7 @@
It is expected that Ant 2.0 will break Ant 1.x based build files. The intention is to It is expected that Ant 2.0 will break Ant 1.x based build files. The intention is to
make this the last time that will happen. make this the last time that will happen.
</p> </p>
<p>
<p>
To advance the definition of Ant, user requirements are now being accepted on the To advance the definition of Ant, user requirements are now being accepted on the
Ant-Dev mailing list. Any requirement will be accepted for consideration. The Ant-Dev mailing list. Any requirement will be accepted for consideration. The
requirements are being collected into a document which is available requirements are being collected into a document which is available
@@ -161,68 +158,58 @@
until March 21st, 2001. At that time, each requirement will be discussed until March 21st, 2001. At that time, each requirement will be discussed
for inclusion in an Ant 2.0 requirement document. for inclusion in an Ant 2.0 requirement document.
</p> </p>
<p>
<p>
For your reference some of the goals which have shaped the development of Ant 1.x are For your reference some of the goals which have shaped the development of Ant 1.x are
available <a href="/ant/ant2/original-specification.html">here</a>. These continue to be available <a href="/ant/ant2/original-specification.html">here</a>. These continue to be
relevant to Ant 2.0. relevant to Ant 2.0.
</p> </p>
<p>
<p>
If you want to shape the future of Ant, join the If you want to shape the future of Ant, join the
<a href="/site/mail.html">Ant-Dev mailing list</a> and contribute <a href="/site/mail.html">Ant-Dev mailing list</a> and contribute
your ideas. your ideas.
</p> </p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Ant 1.3 Released</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Ant 1.3 Released</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
Ant 1.3 has been released after going through three betas. Thanks to everyone who Ant 1.3 has been released after going through three betas. Thanks to everyone who
took the time to test the beta and report bugs and enhancements. took the time to test the beta and report bugs and enhancements.
</p> </p>
<p>You can download the release from
<p>You can download the release from
<a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/">here</a>. <a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/">here</a>.
Both source and binary releases are available in zip, tarball and RPM formats. Both source and binary releases are available in zip, tarball and RPM formats.
</p> </p>
<p>Please report all bugs using the
<p>Please report all bugs using the
<a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Ant">Apache Bugzilla</a> <a href="http://nagoya.apache.org/bugzilla/enter_bug.cgi?product=Ant">Apache Bugzilla</a>
</p> </p>
</blockquote>
</td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
</blockquote>
</td></tr>
</table>
</td>
</tr>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing --> <!-- end the processing -->



















+ 739
- 688
webpage/docs/external.html
File diff suppressed because it is too large
View File


+ 313
- 0
webpage/docs/faq.html View File

@@ -0,0 +1,313 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<!-- Content Stylesheet for Site -->

<!-- start the processing -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Stefan Bodewig">
<meta name="email" value="bodewig@apache.org">
<title>The Jakarta Site - Frequently Asked Questions</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>Ant</strong></p>
<ul>
<li> <a href="./index.html">Front Page</a>
</li>
<li> <a href="./antnews.html">News</a>
</li>
<li> <a href="./external.html">External Resources</a>
</li>
</ul>
<p><strong>Jakarta</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Get Involved</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Other Projects</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
<li> <a href="http://jakarta.apache.org/commons/index.html">Commons</a>
</li>
<li> <a href="http://jakarta.apache.org/ecs/index.html">ECS</a>
</li>
<li> <a href="http://jakarta.apache.org/james/index.html">James</a>
</li>
<li> <a href="http://jakarta.apache.org/jetspeed/index.html">Jetspeed</a>
</li>
<li> <a href="http://jakarta.apache.org/jmeter/index.html">JMeter</a>
</li>
<li> <a href="http://jakarta.apache.org/log4j/index.html">Log4J</a>
</li>
<li> <a href="http://jakarta.apache.org/oro/index.html">ORO</a>
</li>
<li> <a href="http://jakarta.apache.org/regexp/index.html">Regexp</a>
</li>
<li> <a href="http://jakarta.apache.org/slide/index.html">Slide</a>
</li>
<li> <a href="http://jakarta.apache.org/struts/index.html">Struts</a>
</li>
<li> <a href="http://jakarta.apache.org/taglibs/index.html">Taglibs</a>
</li>
<li> <a href="http://jakarta.apache.org/tomcat/index.html">Tomcat</a>
</li>
<li> <a href="http://jakarta.apache.org/turbine/index.html">Turbine</a>
</li>
<li> <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a>
</li>
<li> <a href="http://jakarta.apache.org/watchdog/index.html">Watchdog</a>
</li>
</ul>
<p><strong>Misc</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/whoweare.html">Who We Are</a>
</li>
<li> <a href="http://jakarta.apache.org/site/acknowledgements.html">Acknowledgements</a>
</li>
<li> <a href="http://jakarta.apache.org/site/roles.html">Management</a>
</li>
<li> <a href="http://jakarta.apache.org/site/jakarta-site2.html">About This Site</a>
</li>
<li> <a href="http://jakarta.apache.org/site/contact.html">Contact</a>
</li>
<li> <a href="http://jakarta.apache.org/site/legal.html">Legal</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Questions</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Installation</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<ul>
<li><a href="no-gnu-tar">
<question>I get checksum errors when I try to extract the
<code>tar.gz</code> distribution file. Why?</question>
</a></li>
</ul>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Advanced issues</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<ul>
<li><a href="xml-entity-include">
<question>How do I include an XML snippet in my build file?</question>
</a></li>
</ul>
</blockquote>
</td></tr>
</table>
</blockquote>
</td></tr>
</table>

<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Answers</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<a name="no-gnu-tar">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>
<question>I get checksum errors when I try to extract the
<code>tar.gz</code> distribution file. Why?</question>
</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>Ant'distibution contains file names which are longer
than 100 characters, which is not supported by the standard
tar file format. Several different implementations of tar use
different and incompatible ways to work around this
restriction.</p>
<p>Ant' &lt;tar&gt; task can create tar archives that use
the GNU tar extension, and this has been used when putting
together the distribution. If you are using a different
version of tar (for example the one shipping with Solaris),
you cannot use it to extract the archive.</p>
<p>The solution is to either install GNU tar, which can be
found <a href="http://www.gnu.org/software/tar/tar.html">here</a>
or use the zip archive instead (you can extract it using
<code>jar cf</code>).</p>
</blockquote>
</td></tr>
</table>
</a>
<a name="xml-entity-include">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#828DA6">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>
<question>How do I include an XML snippet in my build file?</question>
</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>You can use XML's way of including external files and let
the parser do the job for Ant:</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>
&lt;?xml version=&quot;1.0&quot;?&gt;

&lt;!DOCTYPE project [
&lt;!ENTITY common SYSTEM &quot;file:./common.xml&quot;&gt;
]&gt;

&lt;project name=&quot;test&quot; default=&quot;test&quot; basedir=&quot;.&quot;&gt;

&lt;target name=&quot;setup&quot;&gt;
...
&lt;/target&gt;

&amp;common;

...

&lt;/project&gt;
</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
</table>
</div>
<p>will literally include the contents of common.xml where
you've placed the &amp;common; entity.</p>
<p>In combination with a DTD this would look like this:</p>
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>
&lt;!DOCTYPE project PUBLIC &quot;-//ANT//DTD project//EN&quot; &quot;file:./ant.dtd&quot; [
&lt;!ENTITY include SYSTEM &quot;file:./header.xml&quot;&gt;
]&gt;
</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
</table>
</div>
</blockquote>
</td></tr>
</table>
</a>
</blockquote>
</td></tr>
</table>
</td>
</tr>

<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->







+ 210
- 223
webpage/docs/index.html View File

@@ -4,141 +4,138 @@


<!-- start the processing --> <!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html> <html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Conor MacNeill">
<meta name="email" value="conor@cortexebusiness.com.au">
<title>The Jakarta Site - Ant</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>Ant</strong></p>
<ul>
<li> <a href="./index.html">Front Page</a>
</li>
<li> <a href="./antnews.html">News</a>
</li>
<li> <a href="./external.html">External Resources</a>
</li>
</ul>
<p><strong>Jakarta</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Get Involved</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Other Projects</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
<li> <a href="http://jakarta.apache.org/commons/index.html">Commons</a>
</li>
<li> <a href="http://jakarta.apache.org/ecs/index.html">ECS</a>
</li>
<li> <a href="http://jakarta.apache.org/james/index.html">James</a>
</li>
<li> <a href="http://jakarta.apache.org/jetspeed/index.html">Jetspeed</a>
</li>
<li> <a href="http://jakarta.apache.org/jmeter/index.html">JMeter</a>
</li>
<li> <a href="http://jakarta.apache.org/log4j/index.html">Log4J</a>
</li>
<li> <a href="http://jakarta.apache.org/oro/index.html">ORO</a>
</li>
<li> <a href="http://jakarta.apache.org/regexp/index.html">Regexp</a>
</li>
<li> <a href="http://jakarta.apache.org/slide/index.html">Slide</a>
</li>
<li> <a href="http://jakarta.apache.org/struts/index.html">Struts</a>
</li>
<li> <a href="http://jakarta.apache.org/taglibs/index.html">Taglibs</a>
</li>
<li> <a href="http://jakarta.apache.org/tomcat/index.html">Tomcat</a>
</li>
<li> <a href="http://jakarta.apache.org/turbine/index.html">Turbine</a>
</li>
<li> <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a>
</li>
<li> <a href="http://jakarta.apache.org/watchdog/index.html">Watchdog</a>
</li>
</ul>
<p><strong>Misc</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/whoweare.html">Who We Are</a>
</li>
<li> <a href="http://jakarta.apache.org/site/acknowledgements.html">Acknowledgements</a>
</li>
<li> <a href="http://jakarta.apache.org/site/roles.html">Management</a>
</li>
<li> <a href="http://jakarta.apache.org/site/jakarta-site2.html">About This Site</a>
</li>
<li> <a href="http://jakarta.apache.org/site/contact.html">Contact</a>
</li>
<li> <a href="http://jakarta.apache.org/site/legal.html">Legal</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Ant</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author" value="Conor MacNeill">
<meta name="email" value="conor@cortexebusiness.com.au">
<title>The Jakarta Site - Ant</title>
</head>
<body bgcolor="#ffffff" text="#000000" link="#525D76">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
<p><strong>Ant</strong></p>
<ul>
<li> <a href="./index.html">Front Page</a>
</li>
<li> <a href="./antnews.html">News</a>
</li>
<li> <a href="./external.html">External Resources</a>
</li>
</ul>
<p><strong>Jakarta</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/news.html">News & Status</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mission.html">Mission</a>
</li>
<li> <a href="http://jakarta.apache.org/site/guidelines.html">Guidelines Notes</a>
</li>
<li> <a href="http://jakarta.apache.org/site/faqs.html">FAQs</a>
</li>
</ul>
<p><strong>Download</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/binindex.html">Binaries</a>
</li>
<li> <a href="http://jakarta.apache.org/site/sourceindex.html">Source Code</a>
</li>
</ul>
<p><strong>Get Involved</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/getinvolved.html">Overview</a>
</li>
<li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a>
</li>
<li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a>
</li>
<li> <a href="http://jakarta.apache.org/site/library.html">Reference Library</a>
</li>
<li> <a href="http://jakarta.apache.org/site/bugs.html">Bug Database</a>
</li>
</ul>
<p><strong>Other Projects</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/avalon/index.html">Avalon</a>
</li>
<li> <a href="http://jakarta.apache.org/commons/index.html">Commons</a>
</li>
<li> <a href="http://jakarta.apache.org/ecs/index.html">ECS</a>
</li>
<li> <a href="http://jakarta.apache.org/james/index.html">James</a>
</li>
<li> <a href="http://jakarta.apache.org/jetspeed/index.html">Jetspeed</a>
</li>
<li> <a href="http://jakarta.apache.org/jmeter/index.html">JMeter</a>
</li>
<li> <a href="http://jakarta.apache.org/log4j/index.html">Log4J</a>
</li>
<li> <a href="http://jakarta.apache.org/oro/index.html">ORO</a>
</li>
<li> <a href="http://jakarta.apache.org/regexp/index.html">Regexp</a>
</li>
<li> <a href="http://jakarta.apache.org/slide/index.html">Slide</a>
</li>
<li> <a href="http://jakarta.apache.org/struts/index.html">Struts</a>
</li>
<li> <a href="http://jakarta.apache.org/taglibs/index.html">Taglibs</a>
</li>
<li> <a href="http://jakarta.apache.org/tomcat/index.html">Tomcat</a>
</li>
<li> <a href="http://jakarta.apache.org/turbine/index.html">Turbine</a>
</li>
<li> <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a>
</li>
<li> <a href="http://jakarta.apache.org/watchdog/index.html">Watchdog</a>
</li>
</ul>
<p><strong>Misc</strong></p>
<ul>
<li> <a href="http://jakarta.apache.org/site/whoweare.html">Who We Are</a>
</li>
<li> <a href="http://jakarta.apache.org/site/acknowledgements.html">Acknowledgements</a>
</li>
<li> <a href="http://jakarta.apache.org/site/roles.html">Management</a>
</li>
<li> <a href="http://jakarta.apache.org/site/jakarta-site2.html">About This Site</a>
</li>
<li> <a href="http://jakarta.apache.org/site/contact.html">Contact</a>
</li>
<li> <a href="http://jakarta.apache.org/site/legal.html">Legal</a>
</li>
</ul>
</td>
<td align="left" valign="top">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Ant</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
Ant is a Java based build tool. In theory it is kind of like make without Ant is a Java based build tool. In theory it is kind of like make without
make's wrinkles. make's wrinkles.
</p> </p>
<p>
<p>
Why another build tool when there is already make, gnumake, nmake, jam, and Why another build tool when there is already make, gnumake, nmake, jam, and
others? Because all of those tools have limitations that Ant's original author others? Because all of those tools have limitations that Ant's original author
couldn't live with when developing software across multiple platforms. Make-like couldn't live with when developing software across multiple platforms. Make-like
@@ -148,21 +145,21 @@ can easily extend these tools by using or writing any program for the OS that
you are working on. However, this also means that you limit yourself to the OS, you are working on. However, this also means that you limit yourself to the OS,
or at least the OS type such as Unix, that you are working on. or at least the OS type such as Unix, that you are working on.
</p> </p>
<p>
<p>
Makefiles are inherently evil as well. Anybody who has worked on them for any Makefiles are inherently evil as well. Anybody who has worked on them for any
time has run into the dreaded tab problem. "Is my command not executing time has run into the dreaded tab problem. "Is my command not executing
because I have a space in front of my tab!!!" said the original author of because I have a space in front of my tab!!!" said the original author of
Ant way too many times. Tools like Jam took care of this to a great degree, but Ant way too many times. Tools like Jam took care of this to a great degree, but
still use yet another format to use and remember. still use yet another format to use and remember.
</p> </p>
<p>
<p>
Ant is different. Instead of a model where it is extended with shell based Ant is different. Instead of a model where it is extended with shell based
commands, it is extended using Java classes. Instead of writing shell commands, commands, it is extended using Java classes. Instead of writing shell commands,
the configuration files are XML based calling out a target tree where various the configuration files are XML based calling out a target tree where various
tasks get executed. Each task is run by an object which implements a particular tasks get executed. Each task is run by an object which implements a particular
Task interface. Task interface.
</p> </p>
<p>
<p>
Granted, this removes some of the expressive power that is inherent by being Granted, this removes some of the expressive power that is inherent by being
able to construct a shell command such as `find . -name foo -exec rm {}` but it able to construct a shell command such as `find . -name foo -exec rm {}` but it
gives you the ability to be cross platform. To work anywhere and everywhere. And gives you the ability to be cross platform. To work anywhere and everywhere. And
@@ -170,39 +167,39 @@ hey, if you really need to execute a shell command, Ant has an exec rule that
allows different commands to be executed based on the OS that it is executing allows different commands to be executed based on the OS that it is executing
on. on.
</p> </p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Documentation</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Documentation</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
You can view the documentation for the most recent release You can view the documentation for the most recent release
<a href="manual/index.html">online</a> <a href="manual/index.html">online</a>
</p> </p>
<p>
<p>
Comprehensive documentation is included in the source and binary distribtions. Comprehensive documentation is included in the source and binary distribtions.
</p> </p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Latest Release</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Latest Release</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
You can download the latest release: You can download the latest release:
</p> </p>
<ul>
<ul>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/bin/"> <li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/bin/">
Download the binary release</a></li> Download the binary release</a></li>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/src/"> <li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/src/">
@@ -210,48 +207,48 @@ Comprehensive documentation is included in the source and binary distribtions.
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/rpms/"> <li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.3/rpms/">
Download source and binary RPMs</a></li> Download source and binary RPMs</a></li>
</ul> </ul>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Nightly Builds</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Nightly Builds</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
If you wish to use the latest Ant features, you can try downloading a nightly If you wish to use the latest Ant features, you can try downloading a nightly
build from <a href="http://jakarta.apache.org/builds/jakarta-ant/nightly/">here</a> build from <a href="http://jakarta.apache.org/builds/jakarta-ant/nightly/">here</a>
</p> </p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Towards Ant2</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Towards Ant2</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
We are currently collecting feature requests for Ant2. Please We are currently collecting feature requests for Ant2. Please
read the latest <a href="/ant/antnews.html">Ant news</a> for more details. read the latest <a href="/ant/antnews.html">Ant news</a> for more details.
</p> </p>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Get Involved</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<ul>
</blockquote>
</td></tr>
</table>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="#525D76">
<font color="#ffffff" face="arial,helvetica,sanserif">
<strong>Get Involved</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<ul>
<li><a href="http://jakarta.apache.org/getinvolved/getinvolvedindex.html">Get Involved</a></li> <li><a href="http://jakarta.apache.org/getinvolved/getinvolvedindex.html">Get Involved</a></li>
<li><a href="http://jakarta.apache.org/getinvolved/mail.html">Join Mailing Lists</a></li> <li><a href="http://jakarta.apache.org/getinvolved/mail.html">Join Mailing Lists</a></li>
<li><a href="http://marc.theaimsgroup.com/?l=ant-dev&amp;r=1&amp;w=2">Search the Dev Mailing List</a> <li><a href="http://marc.theaimsgroup.com/?l=ant-dev&amp;r=1&amp;w=2">Search the Dev Mailing List</a>
@@ -261,36 +258,26 @@ Comprehensive documentation is included in the source and binary distribtions.
<li><a href="/jyve-faq/Turbine/screen/DisplayTopics/action/SetAll/project_id/2/faq_id/16">FAQ</a> <li><a href="/jyve-faq/Turbine/screen/DisplayTopics/action/SetAll/project_id/2/faq_id/16">FAQ</a>
</li> </li>
</ul> </ul>
</blockquote>
</td></tr>
</table>
</td>
</tr>
</blockquote>
</td></tr>
</table>
</td>
</tr>


<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="#525D76" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing --> <!-- end the processing -->



















+ 2
- 0
webpage/velocity.properties View File

@@ -0,0 +1,2 @@
file.resource.loader.path=xdocs/stylesheets
velocimacro.library=templates.vm

+ 74
- 0
webpage/xdocs/faq.xml View File

@@ -0,0 +1,74 @@
<?xml version="1.0"?>
<document>

<properties>
<author email="bodewig@apache.org">Stefan Bodewig</author>
<title>Frequently Asked Questions</title>
</properties>

<faqsection title="Installation">
<faq id="no-gnu-tar">
<question>I get checksum errors when I try to extract the
<code>tar.gz</code> distribution file. Why?</question>
<answer>
<p>Ant&apos;distibution contains file names which are longer
than 100 characters, which is not supported by the standard
tar file format. Several different implementations of tar use
different and incompatible ways to work around this
restriction.</p>

<p>Ant&apos; &lt;tar&gt; task can create tar archives that use
the GNU tar extension, and this has been used when putting
together the distribution. If you are using a different
version of tar (for example the one shipping with Solaris),
you cannot use it to extract the archive.</p>

<p>The solution is to either install GNU tar, which can be
found <a href="http://www.gnu.org/software/tar/tar.html">here</a>
or use the zip archive instead (you can extract it using
<code>jar cf</code>).</p>
</answer>
</faq>
</faqsection>

<faqsection title="Advanced issues">
<faq id="xml-entity-include">
<question>How do I include an XML snippet in my build file?</question>
<answer>
<p>You can use XML's way of including external files and let
the parser do the job for Ant:</p>

<source><![CDATA[
<?xml version="1.0"?>

<!DOCTYPE project [
<!ENTITY common SYSTEM "file:./common.xml">
]>

<project name="test" default="test" basedir=".">

<target name="setup">
...
</target>

&common;

...

</project>
]]></source>

<p>will literally include the contents of common.xml where
you've placed the &amp;common; entity.</p>

<p>In combination with a DTD this would look like this:</p>

<source><![CDATA[
<!DOCTYPE project PUBLIC "-//ANT//DTD project//EN" "file:./ant.dtd" [
<!ENTITY include SYSTEM "file:./header.xml">
]>
]]></source>
</answer>
</faq>
</faqsection>
</document>

+ 117
- 0
webpage/xdocs/stylesheets/faq.vsl View File

@@ -0,0 +1,117 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<!-- Content Stylesheet for Site -->

## Defined variables
#set ($bodybg = "#ffffff")
#set ($bodyfg = "#000000")
#set ($bodylink = "#525D76")
#set ($bannerbg = "#525D76")
#set ($bannerfg = "#ffffff")
#set ($subbannerbg = "#828DA6")
#set ($subbannerfg = "#ffffff")
#set ($tablethbg = "#039acc")
#set ($tabletdbg = "#a0ddf0")
<!-- start the processing -->
#faqs()
<!-- end the processing -->

## This is where the FAQ specific macro's live

#macro (toc $section)
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$subbannerbg">
<font color="$subbannerfg" face="arial,helvetica,sanserif">
<strong>$section.getAttributeValue("title")</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<ul>
#foreach ($faq in $section.getChildren("faq") )
#subtoc ($faq)
#end
</ul>
</blockquote>
</td></tr>
</table>
#end

#macro (subtoc $faq)
#set ($id = $faq.getAttributeValue("id"))
<li><a href="$id">
$xmlout.outputString($faq.getChild("question"))
</a></li>
#end

#macro (answers $section)
#foreach ($faq in $section.getChildren("faq") )
#faq ($faq)
#end
#end

#macro (faq $faq)
#set ($id = $faq.getAttributeValue("id"))
<a name="$id">
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$subbannerbg">
<font color="$subbannerfg" face="arial,helvetica,sanserif">
<strong>
$xmlout.outputString($faq.getChild("question"))
</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#foreach ($item in $faq.getChild("answer").getChildren())
#if ($item.getName().equals("img"))
#image ($item)
#elseif ($item.getName().equals("source"))
#source ($item)
#elseif ($item.getName().equals("table"))
#table ($item)
#else
$xmlout.outputString($item)
#end
#end
</blockquote>
</td></tr>
</table>
</a>
#end

#macro (faqs)
#header()
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$bannerbg">
<font color="$bannerfg" face="arial,helvetica,sanserif">
<strong>Questions</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#set ($allFaqSections = $root.getChildren("faqsection"))
#foreach ( $faqSection in $allFaqSections )
#toc ($faqSection)
#end
</blockquote>
</td></tr>
</table>

<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$bannerbg">
<font color="$bannerfg" face="arial,helvetica,sanserif">
<strong>Answers</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#foreach ( $faqSection in $allFaqSections )
#answers ($faqSection)
#end
</blockquote>
</td></tr>
</table>
#footer()
#end

+ 51
- 238
webpage/xdocs/stylesheets/site.vsl View File

@@ -17,252 +17,65 @@
#document() #document()
<!-- end the processing --> <!-- end the processing -->


## This is where the macro's live

#macro ( table $table)
<table>
#foreach ( $items in $table.getChildren() )
#if ($items.getName().equals("tr"))
#tr ($items)
#end
#end
</table>
#end

#macro ( tr $tr)
<tr>
#foreach ( $items in $tr.getChildren() )
#if ($items.getName().equals("td"))
#td ($items)
#elseif ($items.getName().equals("th"))
#th ($items)
#end
#end
</tr>
#end

#macro ( td $value)
#if ($value.getAttributeValue("colspan"))
#set ($colspan = $value.getAttributeValue("colspan"))
#end
#if ($value.getAttributeValue("rowspan"))
#set ($rowspan = $value.getAttributeValue("rowspan"))
#end
<td bgcolor="$tabletdbg" colspan="$!colspan" rowspan="$!rowspan" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
#if ($value.getText().length() != 0 || $value.hasChildren())
$xmlout.outputString($value, true)
#else
&nbsp;
#end
</font>
</td>
#end

#macro ( th $value)
#if ($value.getAttributeValue("colspan"))
#set ($colspan = $value.getAttributeValue("colspan"))
#end
#if ($value.getAttributeValue("rowspan"))
#set ($rowspan = $value.getAttributeValue("rowspan"))
#end
<td bgcolor="$tablethbg" colspan="$!colspan" rowspan="$!rowspan" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
#if ($value.getText().length() != 0 || $value.hasChildren())
$xmlout.outputString($value, true)
#else
&nbsp;
#end
</font>
</td>
#end

#macro ( projectanchor $name $value )
#if ($value.startsWith("http://"))
<a href="$value">$name</a>
#elseif ($value.startsWith("/site"))
<a href="http://jakarta.apache.org$value">$name</a>
#else
<a href="$relativePath$value">$name</a>
#end
#end

#macro ( metaauthor $author $email )
<meta name="author" value="$author">
<meta name="email" value="$email">
#end

#macro ( image $value )
#if ($value.getAttributeValue("width"))
#set ($width=$value.getAttributeValue("width"))
#end
#if ($value.getAttributeValue("height"))
#set ($height=$value.getAttributeValue("height"))
#end
#if ($value.getAttributeValue("align"))
#set ($align=$value.getAttributeValue("align"))
#end
<img src="$relativePath$value.getAttributeValue("src")" width="$!width" height="$!height" align="$!align">
#end

#macro ( source $value)
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>$escape.getText($value.getText())</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
</table>
</div>
#end
## This is where the common page macro's live


#macro ( subsection $subsection) #macro ( subsection $subsection)
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$subbannerbg">
<font color="$subbannerfg" face="arial,helvetica,sanserif">
<strong>$subsection.getAttributeValue("name")</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#foreach ( $items in $subsection.getChildren() )
#if ($items.getName().equals("img"))
#image ($items)
#elseif ($items.getName().equals("source"))
#source ($items)
#elseif ($items.getName().equals("table"))
#table ($items)
#else
$xmlout.outputString($items)
#end
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$subbannerbg">
<font color="$subbannerfg" face="arial,helvetica,sanserif">
<strong>$subsection.getAttributeValue("name")</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#foreach ( $items in $subsection.getChildren() )
#if ($items.getName().equals("img"))
#image ($items)
#elseif ($items.getName().equals("source"))
#source ($items)
#elseif ($items.getName().equals("table"))
#table ($items)
#else
$xmlout.outputString($items)
#end #end
</blockquote>
</td></tr>
</table>
#end
</blockquote>
</td></tr>
</table>
#end #end


#macro ( section $section) #macro ( section $section)
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$bannerbg">
<font color="$bannerfg" face="arial,helvetica,sanserif">
<strong>$section.getAttributeValue("name")</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#foreach ( $items in $section.getChildren() )
#if ($items.getName().equals("img"))
#image ($items)
#elseif ($items.getName().equals("source"))
#source ($items)
#elseif ($items.getName().equals("table"))
#table ($items)
#elseif ($items.getName().equals("subsection"))
#subsection ($items)
#else
$xmlout.outputString($items)
#end
#end
</blockquote>
</td></tr>
</table>
#end

#macro ( makeProject )
#set ($menus = $project.getChild("body").getChildren("menu"))
#foreach ( $menu in $menus )
<p><strong>$menu.getAttributeValue("name")</strong></p>
<ul>
#foreach ( $item in $menu.getChildren() )
#set ($name = $item.getAttributeValue("name"))
<li>#projectanchor($name $item.getAttributeValue("href"))</li>
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td bgcolor="$bannerbg">
<font color="$bannerfg" face="arial,helvetica,sanserif">
<strong>$section.getAttributeValue("name")</strong>
</font>
</td></tr>
<tr><td>
<blockquote>
#foreach ( $items in $section.getChildren() )
#if ($items.getName().equals("img"))
#image ($items)
#elseif ($items.getName().equals("source"))
#source ($items)
#elseif ($items.getName().equals("table"))
#table ($items)
#elseif ($items.getName().equals("subsection"))
#subsection ($items)
#else
$xmlout.outputString($items)
#end #end
</ul>
#end
#end

#macro (getProjectImage)
#if ($project.getChild("logo"))
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
#set ( $logoString = $project.getChild("logo").getAttributeValue("href") )
#if ( $logoString.startsWith("/") )
<a href="$project.getAttributeValue("href")"><img src="$relativePath$logoString" alt="$project.getChild("logo").getText()" border="0"/></a>
#else
<a href="$project.getAttributeValue("href")"><img src="$relativePath/$logoString" alt="$project.getChild("logo").getText()" border="0"/></a>
#end
</td>
#else
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
#end
#end
</blockquote>
</td></tr>
</table>
#end #end


#macro (document) #macro (document)
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>

#set ($authors = $root.getChild("properties").getChildren("author"))
#foreach ( $au in $authors )
#metaauthor ( $au.getText() $au.getAttributeValue("email") )
#end

<title>$project.getChild("title").getText() - $root.getChild("properties").getChild("title").getText()</title>
</head>

<body bgcolor="$bodybg" text="$bodyfg" link="$bodylink">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
#getProjectImage()
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
#makeProject()
</td>
<td align="left" valign="top">
#set ($allSections = $root.getChild("body").getChildren("section"))
#foreach ( $section in $allSections )
#section ($section)
#end
</td>
</tr>

<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="$bodylink" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
#header()
#set ($allSections = $root.getChild("body").getChildren("section"))
#foreach ( $section in $allSections )
#section ($section)
#end
#footer()
#end #end

+ 196
- 0
webpage/xdocs/stylesheets/templates.vm View File

@@ -0,0 +1,196 @@
## This is where the common macro's live

#macro ( table $table)
<table>
#foreach ( $items in $table.getChildren() )
#if ($items.getName().equals("tr"))
#tr ($items)
#end
#end
</table>
#end

#macro ( tr $tr)
<tr>
#foreach ( $items in $tr.getChildren() )
#if ($items.getName().equals("td"))
#td ($items)
#elseif ($items.getName().equals("th"))
#th ($items)
#end
#end
</tr>
#end

#macro ( td $value)
#if ($value.getAttributeValue("colspan"))
#set ($colspan = $value.getAttributeValue("colspan"))
#end
#if ($value.getAttributeValue("rowspan"))
#set ($rowspan = $value.getAttributeValue("rowspan"))
#end
<td bgcolor="$tabletdbg" colspan="$!colspan" rowspan="$!rowspan"
valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
#if ($value.getText().length() != 0 || $value.hasChildren())
$xmlout.outputString($value, true)
#else
&nbsp;
#end
</font>
</td>
#end

#macro ( th $value)
#if ($value.getAttributeValue("colspan"))
#set ($colspan = $value.getAttributeValue("colspan"))
#end
#if ($value.getAttributeValue("rowspan"))
#set ($rowspan = $value.getAttributeValue("rowspan"))
#end
<td bgcolor="$tablethbg" colspan="$!colspan" rowspan="$!rowspan"
valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
#if ($value.getText().length() != 0 || $value.hasChildren())
$xmlout.outputString($value, true)
#else
&nbsp;
#end
</font>
</td>
#end

#macro ( projectanchor $name $value )
#if ($value.startsWith("http://"))
<a href="$value">$name</a>
#elseif ($value.startsWith("/site"))
<a href="http://jakarta.apache.org$value">$name</a>
#else
<a href="$relativePath$value">$name</a>
#end
#end

#macro ( metaauthor $author $email )
<meta name="author" value="$author">
<meta name="email" value="$email">
#end

#macro ( image $value )
#if ($value.getAttributeValue("width"))
#set ($width=$value.getAttributeValue("width"))
#end
#if ($value.getAttributeValue("height"))
#set ($height=$value.getAttributeValue("height"))
#end
#if ($value.getAttributeValue("align"))
#set ($align=$value.getAttributeValue("align"))
#end
<img src="$relativePath$value.getAttributeValue("src")"
width="$!width" height="$!height" align="$!align">
#end

#macro ( source $value)
<div align="left">
<table cellspacing="4" cellpadding="0" border="0">
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#ffffff"><pre>$escape.getText($value.getText())</pre></td>
<td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
<tr>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
<td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"/></td>
</tr>
</table>
</div>
#end

#macro ( makeProject )
#set ($menus = $project.getChild("body").getChildren("menu"))
#foreach ( $menu in $menus )
<p><strong>$menu.getAttributeValue("name")</strong></p>
<ul>
#foreach ( $item in $menu.getChildren() )
#set ($name = $item.getAttributeValue("name"))
<li>#projectanchor($name $item.getAttributeValue("href"))</li>
#end
</ul>
#end
#end

#macro (getProjectImage)
#if ($project.getChild("logo"))
<td align="left">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" border="0"/></a>
</td>
<td align="right">
#set ( $logoString = $project.getChild("logo").getAttributeValue("href") )
#if ( $logoString.startsWith("/") )
<a href="$project.getAttributeValue("href")"><img src="$relativePath$logoString" alt="$project.getChild("logo").getText()" border="0"/></a>
#else
<a href="$project.getAttributeValue("href")"><img src="$relativePath/$logoString" alt="$project.getChild("logo").getText()" border="0"/></a>
#end
</td>
#else
<td colspan="2">
<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a>
</td>
#end
#end

#macro (header)
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
#set ($authors = $root.getChild("properties").getChildren("author"))
#foreach ( $au in $authors )
#metaauthor ( $au.getText() $au.getAttributeValue("email") )
#end
<title>$project.getChild("title").getText() - $root.getChild("properties").getChild("title").getText()</title>
</head>
<body bgcolor="$bodybg" text="$bodyfg" link="$bodylink">
<table border="0" width="100%" cellspacing="0">
<!-- TOP IMAGE -->
<tr>
#getProjectImage()
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td valign="top" nowrap="true">
#makeProject()
</td>
<td align="left" valign="top">
#end

#macro (footer)
</td>
</tr>

<!-- FOOTER -->
<tr><td colspan="2">
<hr noshade="" size="1"/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="$bodylink" size="-1"><em>
Copyright &#169; 1999-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
#end

Loading…
Cancel
Save