You are viewing a plain text version of this content. The canonical link for it is here.
Posted to taglibs-dev@jakarta.apache.org by ho...@locus.apache.org on 2000/12/02 00:25:46 UTC
cvs commit: jakarta-taglibs/src/doc/stylesheets taglibs.xsl
horwat 00/12/01 15:25:46
Modified: . build.xml
Added: src/doc index.xml project.xml
src/doc/images jakarta-logo.gif taglibs.gif
src/doc/stylesheets taglibs.xsl
Log:
Web site redesign. Individual tag library downloads are now available.
Documentation avaiable from website. Various links and information
added.
Revision Changes Path
1.14 +25 -2 jakarta-taglibs/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-taglibs/build.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- build.xml 2000/10/22 01:33:57 1.13
+++ build.xml 2000/12/01 23:25:41 1.14
@@ -1,5 +1,5 @@
<!-- ANT Build Script for the JAKARTA-TAGLIBS Project -->
-<!-- $Id: build.xml,v 1.13 2000/10/22 01:33:57 glenn Exp $ -->
+<!-- $Id: build.xml,v 1.14 2000/12/01 23:25:41 horwat Exp $ -->
<project name="jakarta-taglibs" default="dist" basedir=".">
@@ -77,6 +77,29 @@
<copydir src="doc" dest="${dist.dir}/doc"/>
</target>
+ <!-- BUILD: Compile documentation application components -->
+ <target name="compile.documentation"
+ depends="prepare,static">
+ <!-- Create dynamically generated documentation -->
+ <style basedir="src/doc" destdir="${build.dir}/doc"
+ extension=".html" style="stylesheets/taglibs.xsl" includes="*.xml"/>
+ <copy todir="${build.dir}/doc">
+ <fileset dir="doc">
+ <include name="**/*.html"/>
+ </fileset>
+ </copy>
+ <copy todir="${build.dir}/doc">
+ <fileset dir="src/doc">
+ <include name="**/*.css"/>
+ <include name="**/*.gif"/>
+ <include name="**/*.html"/>
+ <include name="**/*.jpg"/>
+ <include name="**/*.js"/>
+ </fileset>
+ </copy>
+ </target>
+
+
<!-- ************************* Subproject Execution ********************* -->
@@ -129,7 +152,7 @@
<!-- *********************** Overall Build Command ********************** -->
- <target name="dist" depends="prepare,static,bsf,jspspec,sql,utility,xsl,request,session,response,datetime,regexp"/>
+ <target name="dist" depends="prepare,static,compile.documentation,bsf,jspspec,sql,utility,xsl,request,session,response,datetime,regexp"/>
<!-- *********************** Clean Command ****************************** -->
1.1 jakarta-taglibs/src/doc/index.xml
Index: index.xml
===================================================================
<?xml version="1.0"?>
<document url="./index.xml">
<properties>
<author>Justyna Horwat</author>
<title>The Jakarta Taglibs Project</title>
</properties>
<body>
<section name="Welcome to Jakarta Taglibs" href="Welcome">
<p>Welcome to Jakarta Taglibs! The goal of this project is to provide an open-source
taglib repository.</p>
<p>Tag Library Overview</p>
<p>Tag libraries are composed of a set of custom tags. These custom tags help separate
presentation from implementation. What this means is that web designers can change the
layout without worrying about modifying the underlying logic. Custom tags also help developers avoid
embedding scripting code within the JSP page as well as encourage reuse and ease
maintainability.</p>
<p>Custom tags are not just bean tags. Custom tags can modify the content within the tag
body and have access to the application context. Some of the ways they can be used include dynamically generating
page content and implementing flow of control. They can interact with each other including being nested.</p>
</section>
<section name="How to Download" href="Download">
<p>Binary downloads of the entire JAKARTA-TAGLIBS distribution are available from the Jakarta web site</p>
<p>For more information on how to use the distribution, look at the following documentation:</p>
<ul>
<li>Using the Jakarta-Taglibs <a href="binarydist.html">Binary Distribution</a></li>
<li>Using the Jakarta-Taglibs <a href="sourcedist.html">Source Distribution</a></li>
</ul>
<p>Download and unpack the distribution archive into a convenient subdirectory.</p>
<ul>
<li><a href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly">Download Entire Jakarta-Taglibs Distribution</a></li>
</ul>
<p>Individual project distributions are also available using the sidebar.</p>
</section>
<section name="Reporting Bugs and Feature Requests" href="Bugs">
<p>Thanks to the gracious efforts of
<a href="mailto:nick@cortexity.com">Nick Bauman</a> and his employer,
Cortexity, there is now an interim bug tracking system available for
all of the Jakarta projects. To report a bug, or
request a feature enhancement, simply point your browser at:
<a href="http://znutar.cortexity.com">
http://znutar.cortexity.com</a>. When filling out a bug report
or feature request, please follow these simple rules:</p>
<ul>
<li>From the list of projects and categories, select one of the following
entries:
<ul>
<li>Taglibs / Feature Requests / New Features</li>
<li>Taglibs / Feature Requests / Enhancement</li>
<li>Taglibs / Bug Report / New Bug Report</li>
</ul></li>
</ul>
</section>
<section name="Getting Involved" href="Involved">
<p>There are a number of ways to get more involved in the Taglibs
community, including contributing to the future development of Taglibs.
Check out the following resources:</p>
<ul>
<li><strong>Taglibs-User Mailing List</strong> - Subscribe to the
<a href="mailto:taglibs-user-subscribe@jakarta.apache.org">TAGLIBS-USER</a>
mailing list to communicate with other developers that are using
taglibs for their own applications, including questions about the
installation of Jakarta Taglibs, and the usage of particular Jakarta Taglibs features.</li>
<li><strong>Taglibs-Dev Mailing List</strong> - Subscribe to the
<a href="mailto:taglibs-dev-subscribe@jakarta.apache.org">TAGLIBS-DEV</a>
mailing list to communicate with other developers interested in expanding
and improving the functionality supported by Jakarta Taglibs itself.</li>
<li><strong>Bug Reports and Feature Requests</strong> Use the
<a href="#Bugs">Bug Reporting System</a> to submit these reports.</li>
<li><strong>Patches and Modules</strong> - You can contribute patches and
new modules to Taglibs by posting them to the TAGLIBS-DEV mailing list.
After discussion and acceptance, one of the existing Committers will
add your contribution to the Jakarta Taglibs source code base (with credit to
you, of course).</li>
<li><strong>Become A Committer</strong> - If you wish to contribute directly
to the development of Jakarta Taglibs, and have commit access to the CVS source
repository, you can be nominated (or nominate yourself) for Committer
status on this project. The rules by which committers are voted on are
listed at the
<a href="http://jakarta.apache.org/guidelines/index.html">Jakarta
web site</a>.</li>
</ul>
</section>
<section name="Tutorials" href="Tutorials">
<ul>
<li><a href="tutorial.html">Jakarta Taglibs Tutorial</a></li>
<li><a href="http://java.sun.com/products/jsp/tutorial/TagLibrariesTOC.html">Java Software Tutorial</a></li>
<li><a href="http://developer.java.sun.com/developer/Books/cservletsjsp/chapter14.pdf">Core Servlets and JavaServer Pages Tutorial (PDF)</a></li>
<li><a href="http://www.orionserver.com/tutorials/tagtut/lesson1/lesson1.html">Orion Server Tutorial</a></li>
</ul>
</section>
</body>
</document>
1.1 jakarta-taglibs/src/doc/project.xml
Index: project.xml
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<project name="Taglibs Framework"
href="http://jakarta.apache.org/taglibs"
image="images/taglibs.gif">
<title>Jakarta-Taglib Downloads</title>
<menu name="Downloads">
<item name="Entire Distribution" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly"/>
<item name="Documentation" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/doc"/>
</menu>
<menu name="Individual Downloads">
<item name="DateTime Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/datetime"/>
<item name="JSP Spec Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/jspspec"/>
<item name="Regexp Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/regexp"/>
<item name="Request Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/request"/>
<item name="Response Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/response"/>
<item name="Session Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/session"/>
<item name="SQL Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/sql"/>
<item name="Utility Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/utility"/>
<item name="XSL Taglib" href="http://jakarta.apache.org/builds/jakarta-taglibs/nightly/projects/xsl"/>
</menu>
<menu name="Documentation">
<item name="Binary Dist" href="binarydist.html"/>
<item name="Source Dist" href="binarydist.html"/>
<item name="Tutorial" href="tutorial.html"/>
</menu>
<menu name="Getting Involved">
<item name="Overview" href="http://jakarta.apache.org/site/getinvolved.html"/>
<item name="CVS Repositories" href="http://jakarta.apache.org/site/cvsindex.html"/>
<item name="Mailing Lists" href="http://jakarta.apache.org/site/mail.html"/>
<item name="Reference Library" href="http://jakarta.apache.org/site/library.html"/>
<item name="Bug Database" href="http://jakarta.apache.org/site/bugs.html"/>
</menu>
</project>
1.1 jakarta-taglibs/src/doc/images/jakarta-logo.gif
<<Binary file>>
1.1 jakarta-taglibs/src/doc/images/taglibs.gif
<<Binary file>>
1.1 jakarta-taglibs/src/doc/stylesheets/taglibs.xsl
Index: taglibs.xsl
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- Content Stylesheet for Taglibs Documentation -->
<!-- $Id: taglibs.xsl,v 1.1 2000/12/01 23:25:43 horwat Exp $ -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
<!-- Output method -->
<xsl:output method="html" indent="no"/>
<!-- Defined variables -->
<xsl:variable name="body-bg" select="'#ffffff'"/>
<xsl:variable name="body-fg" select="'#000000'"/>
<xsl:variable name="body-link" select="'#023264'"/>
<xsl:variable name="banner-bg" select="'#023264'"/>
<xsl:variable name="banner-fg" select="'#ffffff'"/>
<!-- Process an entire document into an HTML page -->
<xsl:template match="document">
<xsl:variable name="project"
select="document('../project.xml')/project"/>
<html>
<head>
<meta name="author" content="{properties/author/.}"/>
<!-- <link rel="stylesheet" type="text/css" href="default.css"/> -->
<xsl:choose>
<xsl:when test="properties/title">
<title><xsl:value-of select="properties/title"/></title>
</xsl:when>
<xsl:when test="body/title">
<title><xsl:value-of select="body/title"/></title>
</xsl:when>
<xsl:otherwise>
<title><xsl:value-of select="$project/title"/></title>
</xsl:otherwise>
</xsl:choose>
</head>
<body bgcolor="{$body-bg}" text="{$body-fg}" link="{$body-link}"
alink="{$body-link}" vlink="{$body-link}">
<table border="0" width="100%" cellspacing="5">
<tr><td colspan="2">
<a href="http://jakarta.apache.org">
<img src="images/jakarta-logo.gif" align="left" border="0"/>
</a>
<img src="images/taglibs.gif" align="right" border="0"/>
</td></tr>
<tr><td colspan="2">
<hr/>
</td></tr>
<tr>
<td width="120" valign="top">
<xsl:apply-templates select="$project"/>
</td>
<td valign="top">
<xsl:apply-templates select="body"/>
</td>
</tr>
<tr><td colspan="2">
<hr/>
</td></tr>
<tr><td colspan="2">
<div align="center"><font color="{$body-link}" size="-1"><em>
Copyright © 2000, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
</xsl:template>
<!-- Process a menu for the navigation bar -->
<xsl:template match="menu">
<table border="0" cellspacing="5">
<tr>
<th colspan="2" align="left">
<font color="{body-link}"><strong>
<xsl:value-of select="@name"/>
</strong></font>
</th>
</tr>
<xsl:apply-templates/>
</table>
</xsl:template>
<!-- Process a menu item for the navigation bar -->
<xsl:template match="item">
<tr>
<td align="center" width="15"></td>
<td>
<font size="-1">
<xsl:variable name="href">
<xsl:value-of select="@href"/>
</xsl:variable>
<a href="{$href}"><xsl:value-of select="@name"/></a>
</font>
</td>
</tr>
</xsl:template>
<!-- Process a documentation section -->
<xsl:template match="section">
<xsl:choose>
<xsl:when test="@href">
<xsl:variable name="href">
<xsl:value-of select="@href"/>
</xsl:variable>
<a name="{$href}"></a>
</xsl:when>
</xsl:choose>
<table border="0" cellspacing="5" cellpadding="5" width="100%">
<tr><td bgcolor="{$banner-bg}">
<font color="{$banner-fg}" face="arial,helvetica,sanserif" size="+1">
<strong><xsl:value-of select="@name"/></strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<xsl:apply-templates/>
</blockquote>
</td></tr>
</table>
</xsl:template>
<!-- Process a tag library section -->
<xsl:template match="taglib">
<table border="0" cellspacing="5" cellpadding="5" width="100%">
<tr><td bgcolor="{$banner-bg}">
<font color="{$banner-fg}" face="arial,helvetica,sanserif" size="+1">
<strong><xsl:value-of select="display-name"/></strong>
</font>
</td></tr>
<tr><td>
<blockquote>
<xsl:apply-templates select="info"/>
</blockquote>
</td></tr>
<tr><td>
<blockquote>
<table border="1" cellspacing="2" cellpadding="2">
<tr>
<th width="15%">Tag Name</th>
<th>Description</th>
</tr>
<xsl:for-each select="tag">
<tr>
<td align="center">
<xsl:variable name="name">
<xsl:value-of select="name"/>
</xsl:variable>
<a href="#{$name}"><xsl:value-of select="name"/></a>
</td>
<td>
<xsl:value-of select="summary"/>
</td>
</tr>
</xsl:for-each>
</table>
</blockquote>
</td></tr>
</table>
<xsl:apply-templates select="tag"/>
</xsl:template>
<!-- Process an individual tag -->
<xsl:template match="tag">
<xsl:variable name="name">
<xsl:value-of select="name"/>
</xsl:variable>
<a name="{$name}"></a>
<table border="0" cellspacing="2" cellpadding="2">
<tr><td bgcolor="{$banner-bg}">
<font color="{$banner-fg}" face="arial,helvetica,sanserif">
<strong><xsl:value-of select="name"/></strong> -
<xsl:value-of select="summary"/>
</font>
</td></tr>
<tr><td>
<blockquote>
<xsl:apply-templates select="info"/>
</blockquote>
</td></tr>
<tr><td>
<blockquote>
<table border="1" cellspacing="2" cellpadding="2">
<tr>
<th width="15%">Attribute Name</th>
<th>Description</th>
</tr>
<xsl:for-each select="attribute">
<tr>
<td align="center">
<xsl:value-of select="name"/>
</td>
<td>
<xsl:apply-templates select="info"/>
<xsl:variable name="required">
<xsl:value-of select="required"/>
</xsl:variable>
<xsl:if test="required='true'">
[Required]
</xsl:if>
<xsl:if test="rtexprvalue='true'">
[RT Expr]
</xsl:if>
</td>
</tr>
</xsl:for-each>
</table>
</blockquote>
</td></tr>
</table>
</xsl:template>
<!-- Process an individual paragraph -->
<xsl:template match="p">
<p><xsl:apply-templates/><br/></p>
</xsl:template>
<!-- Process a task list section -->
<xsl:template match="task-list">
<xsl:choose>
<xsl:when test="@href">
<xsl:variable name="href">
<xsl:value-of select="@href"/>
</xsl:variable>
<a name="{$href}"></a>
</xsl:when>
</xsl:choose>
<table border="0" cellspacing="5" cellpadding="5" width="100%">
<tr><td bgcolor="{$banner-bg}">
<font color="{$banner-fg}" face="arial,helvetica,sanserif" size="+1">
<xsl:value-of select="@name"/>
</font>
</td></tr>
<tr><td>
<xsl:apply-templates select="info"/>
</td></tr>
<tr><td>
<blockquote>
<table border="1" cellspacing="5" cellpadding="5" width="100%">
<tr>
<th width="75%">Description</th>
<th width="25%">Volunteer</th>
</tr>
<xsl:apply-templates select="task"/>
</table>
</blockquote>
</td></tr>
</table>
</xsl:template>
<!-- Process an individual task (in a TODO list) -->
<xsl:template match="task">
<tr>
<td>
<xsl:choose>
<xsl:when test="@name">
<em><xsl:value-of select="@name"/></em>.
</xsl:when>
</xsl:choose>
<xsl:value-of select="info"/>
</td>
<td><xsl:value-of select="assigned"/></td>
</tr>
</xsl:template>
<!-- Process everything else by just passing it through -->
<xsl:template match="*|@*">
<xsl:copy>
<xsl:apply-templates select="@*|*|text()"/>
</xsl:copy>
</xsl:template>
</xsl:stylesheet>