@@ -2,7 +2,7 @@
* DVSL Stylesheet to format the Ant Task documentation. * DVSL Stylesheet to format the Ant Task documentation.
*# *#
#set( $relative-path = "." )
#set( $relative-path = "../../ " )
#if (false) #if (false)
#set( $body-bg = '#ffffff' ) #set( $body-bg = '#ffffff' )
#set( $body-fg = '#000000' ) #set( $body-fg = '#000000' )
@@ -44,115 +44,124 @@
#if ( $test )$output#end #if ( $test )$output#end
#end #end
#match( "task" )
#set( $task_name = $attrib.name )
## Create task title with first letter in upper case
#set( $task_title = "$task_name.substring(0,1).toUpperCase()$task_name.substring(1)" )
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>$task_title Task</title>
</head>
<body bgcolor="$body-bg" text="$body-fg" link="$body-link"
alink="$body-link" vlink="$body-link">
<table border="0" width="100%" cellspacing="4">
## PAGE HEADER
<tr>
<td>
## JAKARTA LOGO
<a href="http://jakarta.apache.org/">
<img src="http://jakarta.apache.org/images/jakarta-logo.gif"
align="left" alt="The Jakarta Project" border="0"/>
</a>
#if( $project.logo )
#set( $alt = $project.logo )
#set( $home = $project.attribute("href") )
#set( $src = $project.logo.attribute( "href" ) )
## PROJECT LOGO
<a href="$home">
<img src="$src" align="right" alt="$alt" border="0"/>
</a>
#end
## Macro to capitalize a word making the first letter upper case
#macro(capitalize $word)
$word.substring(0,1).toUpperCase()$word.substring(1)
#end
</td>
</tr>
## HEADER SEPARATOR
<tr>
##<td colspan="2">
<td>
<hr noshade="" size="1"/>
</td>
</tr>
<tr>
<!-- RIGHT SIDE MAIN BODY -->
<td valign="top" align="left">
$context.applyTemplates("long-description")
$context.applyTemplates("structure/attributes")
$context.applyTemplates("structure/elements")
</td>
</tr>
#match( "task" )
#set( $project = $node.selectSingleNode("document('xdocs/stylesheets/project.xml')/project" ) )
#if ($node.name().equals("task"))
#set( $title = "#capitalize($attrib.name) Task" )
#set( $summary = $node.short-description )
#end
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>$title</title>
</head>
<body bgcolor="$body-bg" text="$body-fg" link="$body-link"
alink="$body-link" vlink="$body-link">
<table border="0" width="100%" cellspacing="4">
<!-- PAGE HEADER -->
<tr>
<td>
<table border="0" width="100%"><tr>
<td valign="bottom">
<font size="+3" face="arial,helvetica,sanserif"><strong>$title</strong></font>
#* *##if( $summary )
<br><font face="arial,helvetica,sanserif">$summary</font>
#* *##end
</td>
<td>
#* *##if( $project.logo )
#set( $alt = $project.logo )
#set( $home = $project.attribute("href") )
#set( $src = $project.logo.attribute( "href" ) )
<!-- PROJECT LOGO -->
<a href="$home">
<img src="${relative-path}$src" align="right" alt="$alt" border="0"/>
</a>
#* *##end
</td>
</tr></table>
</td>
</tr>
<!-- START RIGHT SIDE MAIN BODY -->
<tr>
<td valign="top" align="left">
#* *##if ($node.name().equals("task"))
#* Use description from merged XML if available, else javadoc comment *#
#* *##if ($node.external.description)
<!-- Applying task/description -->
#* *#$context.applyTemplates("external/description")
#* *##else
<!-- Applying task/long-description -->
#* *#$context.applyTemplates("long-description")
#* *##end
#* *#$context.applyTemplates("structure/attributes")
#* *#$context.applyTemplates("structure/elements")
#* *#$context.applyTemplates("external/section")
#* *##end
</td>
</tr>
<!-- END RIGHT SIDE MAIN BODY -->
<!-- FOOTER SEPARATOR -->
<tr>
<td>
<hr noshade="" size="1"/>
</td>
</tr>
<!-- PAGE FOOTER -->
<tr>
<td>
<div align="center"><font color="$body-link" size="-1"><em>
Copyright © 2000-2002, Apache Software Foundation
</em></font></div>
</td>
</tr>
<!-- FOOTER SEPARATOR -->
<tr>
<td>
<hr noshade="" size="1"/>
</td>
</tr>
<!-- PAGE FOOTER -->
<tr>
<td>
<div align="center"><font color="$body-link" size="-1"><em>
Copyright © 2000-2002, Apache Software Foundation
</em></font></div>
</td>
</tr>
</table>
</table>
</body>
</html>
</body>
</html>
#end #end
#* #*
Macro to format a table heading cell Macro to format a table heading cell
*# *#
#macro( th $text ) #macro( th $text )
<td bgcolor="$table-th-bg" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
<b>$text</b></font>
</td>
<td bgcolor="$table-th-bg" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif"><b>$text</b></font>
</td>
#end #end
#* #*
Macro to format a table body cell Macro to format a table body cell
*# *#
#macro( td $text ) #macro( td $text )
<td bgcolor="$table-td-bg" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
$text
</font>
</td>
<td bgcolor="$table-td-bg" valign="top" align="left">
<font color="#000000" size="-1" face="arial,helvetica,sanserif">$text</font>
</td>
#end #end
#* #*
Macro to format a section banner Macro to format a section banner
*# *#
#macro( section $anchor $name ) #macro( section $anchor $name )
<tr><td bgcolor="$banner-bg">
<font color="$banner-fg" face="arial,helvetica.sanserif">
<a name="$anchor">
<strong>$name</strong></a></font>
</td></tr>
<tr><td bgcolor="$banner-bg">
<font color="$banner-fg" face="arial,helvetica.sanserif">
<a name="$anchor">
<strong>$name</strong></a></font>
</td></tr>
#end #end
#* #*
@@ -168,75 +177,136 @@
#* #*
Match long- description section
Process javadoc long description section
*# *#
#match( "long-description" ) #match( "long-description" )
<!-- Start Description -->
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td> </td></tr> <tr><td> </td></tr>
#section($task_name "$task_title Task Description")
#* *##section("description" " Description")
<tr><td><blockquote> <tr><td><blockquote>
$node.value()
$node.value().trim()
</blockquote></td></tr> </blockquote></td></tr>
</table> </table>
<!-- End Description -->
#end #end
#* #*
Match structure/attributes sec tion
Process external descip tion
*# *#
#match( "structure/attributes" )
#match( "external/description" )
<!-- Start Description -->
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td> </td></tr> <tr><td> </td></tr>
#section("attributes" "Parameters ")
#* *##section("description" "Description ")
<tr><td><blockquote> <tr><td><blockquote>
<table>
<tr>
#th("Attribute")
#th("Description")
#th("Type")
</tr>
$context.applyTemplates("*")
</table>
#* *#$context.applyTemplates("*")
</blockquote></td></tr> </blockquote></td></tr>
</table> </table>
<!-- End Description -->
#end #end
#* #*
Match structure/elements section
Process top level attributes
*# *#
#match( "structure/elements" )
#match( "structure/attributes" )
<!-- Start Attributes -->
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td> </td></tr> <tr><td> </td></tr>
#section("elements" "Parameters as nested element s")
#* *##section("attributes" "Parameter s")
<tr><td><blockquote> <tr><td><blockquote>
$context.applyTemplates("*")
<table>
<tr>
#* *##th("Attribute")
#* *##th("Description")
#* *##th("Type")
</tr>
#* *#$context.applyTemplates("*")
</table>
</blockquote></td></tr> </blockquote></td></tr>
</table> </table>
<!-- End Attributes -->
#end #end
#*
Process a single attribute
*#
#match( "attribute" ) #match( "attribute" )
<!-- Attribute -->
<tr> <tr>
#td($attrib.name)
#td($node.description)
#td($attrib.type)
#* *# #td($attrib.name)
#* *# #td($node.description)
#* *# #td($attrib.type)
</tr> </tr>
#end #end
#*
Process all elements
*#
#match( "elements" )
<!-- Start Elements -->
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td> </td></tr>
#* *##section("elements" "Parameters as nested elements")
<tr><td><blockquote>
#* *#$context.applyTemplates("*")
</blockquote></td></tr>
</table>
<!-- End Elements -->
#end
#*
Process a single element
*#
#match( "element" ) #match( "element" )
<!-- Start Element -->
<table border="0" cellspacing="0" cellpadding="2" width="100%"> <table border="0" cellspacing="0" cellpadding="2" width="100%">
#subsection($attrib.name $attrib.name)
<tr><td> </td></tr>
<tr><td bgcolor="$sub-banner-bg">
<font color="$sub-banner-fg" face="arial,helvetica.sanserif" size="-1">
<strong>$attrib.name</strong> ($attrib.type)</font>
</td></tr>
<tr><td><blockquote> <tr><td><blockquote>
$node.description
$node.description.toString().trim()
#* *#$context.applyTemplates("*")
</blockquote></td></tr> </blockquote></td></tr>
</table> </table>
<!-- End Element -->
#end
#*
Process attributes within elements
*#
#match( "element/attributes" )
<!-- Start Attributes -->
<table border="0" cellspacing="0" cellpadding="2" width="100%">
<tr><td> </td></tr>
<tr><td>
<table>
<tr>
#* *##th("Attribute")
#* *##th("Description")
#* *##th("Type")
</tr>
#* *#$context.applyTemplates("*")
</table>
</td></tr>
</table>
<!-- End Attributes -->
#end #end
Erik Hatcher