Browse Source

Initial attempt at an Anakia based webpage

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@268584 13f79535-47bb-0310-9956-ffa450edef68
master
Conor MacNeill 24 years ago
parent
commit
9b888af8aa
5 changed files with 483 additions and 0 deletions
  1. +46
    -0
      webpage/build.xml
  2. +267
    -0
      webpage/docs/index.html
  3. +112
    -0
      webpage/xdocs/index.xml
  4. +56
    -0
      webpage/xdocs/stylesheets/project.xml
  5. +2
    -0
      webpage/xdocs/velocity.properties

+ 46
- 0
webpage/build.xml View File

@@ -0,0 +1,46 @@
<project name="build-site" default="docs" basedir=".">

<!-- Initialization properties -->
<property name="project.name" value="ant"/>
<property name="docs.src" value="./xdocs"/>
<property name="docs.dest" value="./docs"/>

<target name="prepare">
<available classname="org.apache.velocity.anakia.AnakiaTask"
property="AnakiaTask.present"/>
</target>

<target depends="prepare" name="prepare-error" unless="AnakiaTask.present">
<echo>
AnakiaTask is not present! Please check to make sure that
velocity.jar is in your classpath.
</echo>
</target>

<target name="docs" depends="prepare-error" if="AnakiaTask.present">
<taskdef name="anakia" classname="org.apache.velocity.anakia.AnakiaTask"/>
<anakia basedir="${docs.src}" destdir="${docs.dest}/"
extension=".html" style="./site.vsl"
projectFile="stylesheets/project.xml"
excludes="**/stylesheets/** empty.xml"
includes="**/*.xml"
lastModifiedCheck="true"
velocityPropertiesFile="${docs.src}/velocity.properties">
</anakia>

<copy todir="${docs.dest}/images" filtering="no">
<fileset dir="${docs.src}/images">
<include name="**/*.gif"/>
<include name="**/*.jpeg"/>
<include name="**/*.jpg"/>
</fileset>
</copy>
<!-- In case we have CSS someday
<copy todir="${docs.dest}" filtering="no">
<fileset dir="${docs.src}">
<include name="**/*.css"/>
</fileset>
</copy>
-->
</target>
</project>

+ 267
- 0
webpage/docs/index.html View File

@@ -0,0 +1,267 @@
<!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 -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<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">
<strong>Essentials</strong>
<ul>
<li> <a href="./index.html">Front Page</a>
</li>
<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>
<strong>Download</strong>
<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>
<strong>Get Involved</strong>
<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>
<strong>SubProjects</strong>
<ul>
<li> <a href="./ant/index.html">Ant</a>
</li>
<li> <a href="./ecs/index.html">ECS</a>
</li>
<li> <a href="./log4j/index.html">Log4J</a>
</li>
<li> <a href="./oro/index.html">ORO</a>
</li>
<li> <a href="./regexp/index.html">Regexp</a>
</li>
<li> <a href="./slide/index.html">Slide</a>
</li>
<li> <a href="./struts/index.html">Struts</a>
</li>
<li> <a href="./taglibs/index.html">Taglibs</a>
</li>
<li> <a href="./tomcat/index.html">Tomcat</a>
</li>
<li> <a href="./velocity/index.html">Velocity</a>
</li>
<li> <a href="./watchdog/index.html">Watchdog</a>
</li>
</ul>
<strong>Misc</strong>
<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
make's wrinkles.
</p>
<p>
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
couldn't live with when developing software across multiple platforms. Make-like
tools are inherently shell based. They evaluate a set of dependencies and then
execute commands not unlike what you would issue on a shell. This means that you
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,
or at least the OS type such as Unix, that you are working on.
</p>
<p>
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
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
still use yet another format to use and remember.
</p>
<p>
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,
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
Task interface.
</p>
<p>
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
gives you the ability to be cross platform. To work anywhere and everywhere. And
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
on.
</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
<a href="jakarta-ant/docs/">online</a>
</p>
<p>
Comprehensive documentation is included in the source and binary distribtions.
</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:
</p>
<ul>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/bin/">
Download the binary release</a></li>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/src/">
Download the source release</a></li>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/rpms/">
Download source and binary RPMs</a></li>
</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>
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>
</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>
<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://marc.theaimsgroup.com/?l=ant-dev&amp;r=1&amp;w=2">
Search the Dev Mailing List</a>
</li>
<li><a href="http://marc.theaimsgroup.com/?l=ant-user&amp;r=1&amp;w=2">
Search the User Mailing List</a>
</li>
<li><a href="/jyve-faq/Turbine/screen/DisplayTopics/action/SetAll/project_id/2/faq_id/16">
FAQ</a>
</li>
</ul>
</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 -->















+ 112
- 0
webpage/xdocs/index.xml View File

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

<properties>
<author email="conor@cortexebusiness.com.au">Conor MacNeill</author>
<title>Ant</title>
</properties>

<body>

<section name="Ant">

<p>
Ant is a Java based build tool. In theory it is kind of like make without
make's wrinkles.
</p>

<p>
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
couldn't live with when developing software across multiple platforms. Make-like
tools are inherently shell based. They evaluate a set of dependencies and then
execute commands not unlike what you would issue on a shell. This means that you
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,
or at least the OS type such as Unix, that you are working on.
</p>

<p>
Makefiles are inherently evil as well. Anybody who has worked on them for any
time has run into the dreaded tab problem. &quot;Is my command not executing
because I have a space in front of my tab!!!&quot; said the original author of
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.
</p>

<p>
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,
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
Task interface.
</p>

<p>
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
gives you the ability to be cross platform. To work anywhere and everywhere. And
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
on.
</p>

</section>
<section name="Documentation">
<p>
You can view the documentation for the most recent release
<a href="jakarta-ant/docs/">online</a>
</p>

<p>
Comprehensive documentation is included in the source and binary distribtions.
</p>

</section>

<section name="Latest Release">
<p>
You can download the latest release:
</p>
<ul>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/bin/">
Download the binary release</a></li>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/src/">
Download the source release</a></li>
<li><a href="http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/rpms/">
Download source and binary RPMs</a></li>
</ul>
</section>
<section name="Nightly Builds">
<p>
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>
</p>
</section>
<section name="Get Involved">
<ul>
<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://marc.theaimsgroup.com/?l=ant-dev&amp;r=1&amp;w=2">
Search the Dev Mailing List</a>
</li>
<li><a href="http://marc.theaimsgroup.com/?l=ant-user&amp;r=1&amp;w=2">
Search the User Mailing List</a>
</li>
<li><a href="/jyve-faq/Turbine/screen/DisplayTopics/action/SetAll/project_id/2/faq_id/16">
FAQ</a>
</li>
</ul>



</section>

</body>
</document>


+ 56
- 0
webpage/xdocs/stylesheets/project.xml View File

@@ -0,0 +1,56 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Jakarta Site"
href="http://jakarta.apache.org/">

<title>The Jakarta Site</title>
<!-- uncomment and put your project logo here!
<logo href="http://jakarta.apache.org/images/jakarta-logo.gif">The Jakarta Project</logo>
-->
<body>
<menu name="Essentials">
<item name="Front Page" href="/index.html"/>
<item name="News &amp; Status" href="/site/news.html"/>
<item name="Mission" href="/site/mission.html"/>
<item name="Guidelines Notes" href="/site/guidelines.html"/>
<item name="FAQs" href="/site/faqs.html"/>
</menu>

<menu name="Download">
<item name="Binaries" href="/site/binindex.html"/>
<item name="Source Code" href="/site/sourceindex.html"/>
</menu>

<menu name="Get Involved">
<item name="Overview" href="/site/getinvolved.html"/>
<item name="CVS Repositories" href="/site/cvsindex.html"/>
<item name="Mailing Lists" href="/site/mail.html"/>
<item name="Reference Library" href="/site/library.html"/>
<item name="Bug Database" href="/site/bugs.html"/>
</menu>

<menu name="SubProjects">
<item name="Ant" href="/ant/index.html"/>
<!-- <item name="Avalon" href="/avalon/index.html"/> -->
<item name="ECS" href="/ecs/index.html"/>
<item name="Log4J" href="/log4j/index.html"/>
<item name="ORO" href="/oro/index.html"/>
<item name="Regexp" href="/regexp/index.html"/>
<item name="Slide" href="/slide/index.html"/>
<item name="Struts" href="/struts/index.html"/>
<item name="Taglibs" href="/taglibs/index.html"/>
<item name="Tomcat" href="/tomcat/index.html"/>
<item name="Velocity" href="/velocity/index.html"/>
<item name="Watchdog" href="/watchdog/index.html"/>
</menu>

<menu name="Misc">
<item name="Who We Are" href="/site/whoweare.html"/>
<item name="Acknowledgements" href="/site/acknowledgements.html"/>
<item name="Management" href="/site/roles.html"/>
<item name="About This Site" href="/site/jakarta-site2.html"/>
<item name="Contact" href="/site/contact.html"/>
<item name="Legal" href="/site/legal.html"/>
</menu>
</body>
</project>

+ 2
- 0
webpage/xdocs/velocity.properties View File

@@ -0,0 +1,2 @@
resource.loader.1.resource.path = ../../jakarta-site2/xdocs/stylesheets
template.loader.1.template.path = ../../jakarta-site2/xdocs/stylesheets

Loading…
Cancel
Save