You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by di...@apache.org on 2003/01/23 21:39:13 UTC
cvs commit: ws-site/targets/subdir index.html index.pdf
dims 2003/01/23 12:39:13
Added: . build.xml forrest-targets.ent forrest.properties
status.xml
src/documentation README.txt skinconf.xml
src/documentation/content/xdocs index.xml sample.xml
sample2.xml site.xml tabs.xml test.ihtml
src/documentation/resources/images group-logo.gif icon.png
images.jpeg project-logo.gif
targets changes.html changes.pdf changes.rss.xml
favicon.ico hello.pdf index.html index.pdf
sample.html sample.pdf test1.html test2.html
todo.html todo.pdf
targets/images add.jpg built-with-forrest-button.png
group-logo.gif icon.png project-logo.gif rss.png
targets/skin breadcrumbs.js page.css
targets/skin/images chapter.gif chapter_open.gif current.gif
label.gif page.gif printer.png spacer.gif
targets/subdir index.html index.pdf
Log:
Initial commit of Forrest-driven ws.apache.org site.
Revision Changes Path
1.1 ws-site/build.xml
Index: build.xml
===================================================================
<!DOCTYPE project [
<!ENTITY forrest-targets SYSTEM "file:./forrest-targets.ent">
]>
<project default="run-forrest">
&forrest-targets;
<target name="run-forrest" depends="clean, site">
<copy todir="./targets">
<fileset dir="./build/site"/>
</copy>
</target>
<target name="clean"
description="clean up the build area">
<delete dir="./build"/>
</target>
</project>
1.1 ws-site/forrest-targets.ent
Index: forrest-targets.ent
===================================================================
<!--
This build.xml snippet contains Forrest targets for Ant 1.5+. It checks that
the user has set ${forrest.home}, either in one of:
build.properties
project.properties
ant.properties
.ant.properties
or with the FORREST_HOME environment variable, and prints an informative error
message if not found.
Usage:
1) Copy this file to somewhere in your project.
2) Add the following to the top of your project's Ant build.xml script
(adjusting the path):
<!DOCTYPE project [
<!ENTITY forrest-targets SYSTEM "file:./forrest-targets.ent">
]>
3) Before the closing '</project>' in your build.xml, add this:
&forrest-targets;
This is like expanding a macro: it pulls in the contents of this file.
A minimal build.xml would thus be:
<!DOCTYPE project [
<!ENTITY forrest-targets SYSTEM "file:./forrest-targets.ent">
]>
<project default="site">
&forrest-targets;
</project>
-->
<target name="site" depends="forrest.init" description="Generates static HTML documentation">
<ant antfile="${forrest.home}/forrest.antproxy.xml" target="site"/>
</target>
<target name="webapp" depends="forrest.init" description="Generates an unpackaged webapp of the website">
<ant antfile="${forrest.home}/forrest.antproxy.xml" target="webapp"/>
</target>
<target name="war" depends="forrest.init" description="Generates a .war file containing the website">
<ant antfile="${forrest.home}/forrest.antproxy.xml" target="war"/>
</target>
<target name="validate" depends="forrest.init" description="Validates XML documentation files">
<ant antfile="${forrest.home}/forrest.antproxy.xml" target="validate"/>
</target>
<target name="forrest.init" depends="forrest.sethome, forrest.home.defined"/>
<target name="forrest.sethome" depends="forrest.loadenv,
forrest.checkenv, forrest.checkhome, forrest.check-build.properties,
forrest.check-project.properties, forrest.check-ant.properties,
forrest.check-.ant.properties"/>
<target name="forrest.loadenv" unless="forrest.home.present">
<property environment="env"/>
<echo level="verbose">Forrest: Got ${env.FORREST_HOME}</echo>
</target>
<target name="forrest.checkenv" if="env.FORREST_HOME">
<echo level="verbose">Found $FORREST_HOME..</echo>
<property name="forrest.home" location="${env.FORREST_HOME}"/>
<echo level="verbose">forrest.home set to ${forrest.home}</echo>
<available file="${forrest.home}" type="dir" property="forrest.home.present"/>
</target>
<target name="forrest.checkhome">
<available file="${forrest.home}" type="dir" property="forrest.home.present"/>
<available file="build.properties" type="file" property="build.properties.present"/>
<available file="project.properties" type="file" property="project.properties.present"/>
<available file="ant.properties" type="file" property="ant.properties.present"/>
<available file=".ant.properties" type="file" property=".ant.properties.present"/>
</target>
<!-- No we can't extract the commonalities below into an antcall'ed target,
because it wouldn't be able to set forrest.home -->
<target name="forrest.check-build.properties" unless="forrest.home.present"
if="build.properties.present">
<echo level="verbose">Forrest: Checking build.properties..</echo>
<loadproperties srcfile="build.properties">
<filterchain>
<linecontains>
<contains value="forrest.home"/>
</linecontains>
</filterchain>
</loadproperties>
<available file="${forrest.home}" type="dir" property="forrest.home.present"/>
</target>
<target name="forrest.check-project.properties" unless="forrest.home.present"
if="project.properties.present">
<echo level="verbose">Forrest: Checking project.properties..</echo>
<loadproperties srcfile="project.properties">
<filterchain>
<linecontains>
<contains value="forrest.home"/>
</linecontains>
</filterchain>
</loadproperties>
<available file="${forrest.home}" type="dir" property="forrest.home.present"/>
</target>
<target name="forrest.check-ant.properties" unless="forrest.home.present"
if="ant.properties.present">
<echo level="verbose">Forrest: Checking ant.properties..</echo>
<loadproperties srcfile="ant.properties">
<filterchain>
<linecontains>
<contains value="forrest.home"/>
</linecontains>
</filterchain>
</loadproperties>
<available file="${forrest.home}" type="dir" property="forrest.home.present"/>
</target>
<target name="forrest.check-.ant.properties" unless="forrest.home.present"
if=".ant.properties.present">
<echo level="verbose">Forrest: Checking .ant.properties..</echo>
<loadproperties srcfile=".ant.properties">
<filterchain>
<linecontains>
<contains value="forrest.home"/>
</linecontains>
</filterchain>
</loadproperties>
<available file="${forrest.home}" type="dir" property="forrest.home.present"/>
</target>
<target name="forrest.home.defined" depends="forrest.sethome" unless="forrest.home.present">
<property name="path" value="${user.home}/xml-forrest/build/dist/shbat"/>
<pathconvert targetos="windows" property="winpath">
<path>
<pathelement location="${path}"/>
</path>
</pathconvert>
<pathconvert targetos="unix" property="unixpath">
<path>
<pathelement
location="${path}"/>
</path>
</pathconvert>
<echo>
----------------------------------------------
To run this target, you need Forrest installed.
Please do the following:
export CVSROOT=:pserver:anoncvs@cvs.apache.org:/home/cvspublic
cvs checkout xml-forrest
cd xml-forrest
build (Windows)
./build.sh (Unix)
Then either:
- Set FORREST_HOME as the Forrest build instructions describe
- Create a build.properties, with the forrest.home property pointing to
the forrest shbat directory, eg:
forrest.home=${winpath} (Windows)
forrest.home=${unixpath} (Unix)
(adjusting the path according to where your xml-forrest is)
----------------------------------------------
</echo>
<fail message="Need to define $${forrest.home}"/>
</target>
1.1 ws-site/forrest.properties
Index: forrest.properties
===================================================================
##############
# Properties used by forrest.build.xml for building the website
##############
# Prints out a summary of Forrest settings for this project
#forrest.echo=true
# Project name (used to name .war file)
#project.name=my-project
# Specifies name of Forrest skin to use
#project.skin=forrest-site
#project.skin=avalon-tigris
project.skin=krysalis-site
##############
# layout properties
# Properties that must be set to override the default locations
#
# Parent properties must be set. This usually means uncommenting
# project.content-dir if any other property using it is uncommented
#project.status=status.xml
#project.content-dir=src/documentation
#project.conf-dir=${project.content-dir}/conf
#project.sitemap=${project.content-dir}/sitemap.xmap
#project.xdocs-dir=${project.content-dir}/content/xdocs
#project.stylesheets-dir=${project.content-dir}/resources/stylesheets
#project.images-dir=${project.content-dir}/resources/images
#project.schema-dir=${project.content-dir}/resources/schema
#project.skins-dir=${project.content-dir}/skins
#project.skinconf=${project.content-dir}/skinconf.xml
#project.lib-dir=${project.content-dir}/lib
#project.classes-dir=${project.content-dir}/classes
##############
# Cocoon catalog entity resolver properties
# A local catalog to supplement the default Forrest catalog
#project.catalog=${project.schema-dir}/catalog
# The verbosity level for the entity resolver (1..10)
#forrest.catalog.verbosity=1
##############
# validation properties
# These props determine if validation is performed at all
# Values are inherited unless overridden.
# Eg, if forrest.validate=false, then all others are false unless set to true.
#forrest.validate=true
#forrest.validate.xdocs=${forrest.validate}
#forrest.validate.skinconf=${forrest.validate}
#forrest.validate.sitemap=${forrest.validate}
#forrest.validate.stylesheets=${forrest.validate}
#forrest.validate.skins=${forrest.validate}
#forrest.validate.skins.stylesheets=${forrest.validate.skins}
# Key:
# *.failonerror=(true|false) stop when an XML file is invalid
# *.includes=(pattern) Comma-separated list of path patterns to validate
# *.excludes=(pattern) Comma-separated list of path patterns to not validate
#forrest.validate.failonerror=true
#forrest.validate.includes=**/*
#forrest.validate.excludes=
#
#forrest.validate.xdocs.failonerror=${forrest.validate.failonerror}
#
#forrest.validate.xdocs.includes=**/*.x*
#forrest.validate.xdocs.excludes=site.xml
#
#forrest.validate.skinconf.includes=${skinconf-file}
#forrest.validate.skinconf.excludes=
#forrest.validate.skinconf.failonerror=${forrest.validate.failonerror}
#
#forrest.validate.sitemap.includes=${sitemap-file}
#forrest.validate.sitemap.excludes=
#forrest.validate.sitemap.failonerror=${forrest.validate.failonerror}
#
#forrest.validate.stylesheets.includes=**/*.xsl
#forrest.validate.stylesheets.excludes=
#forrest.validate.stylesheets.failonerror=${forrest.validate.failonerror}
#
#forrest.validate.skins.includes=**/*
#forrest.validate.skins.excludes=**/*.xsl
#forrest.validate.skins.failonerror=${forrest.validate.failonerror}
#
#forrest.validate.skins.stylesheets.includes=**/*.xsl
#forrest.validate.skins.stylesheets.excludes=
#forrest.validate.skins.stylesheets.failonerror=${forrest.validate.skins.failonerror}
1.1 ws-site/status.xml
Index: status.xml
===================================================================
<?xml version="1.0"?>
<status>
<developers>
<person name="Davanum Srinivas" email="dims@yahoo.com" id="dims"/>
<person name="Sam Ruby" email="rubys@apache.org" id="rubys"/>
<!-- Add more people here -->
</developers>
<todo>
<actions priority="high">
<action context="docs" dev="rubys">
setup pmc and general mailing lists
</action>
<!-- Add todo items. @context is an arbitrary string. Eg:
<action context="docs" dev="JB">
Add lots of content. XML content goes in
<code>src/documentation/content/xdocs</code>, or wherever the
<code>${project.xdocs-dir}</code> property (set in
<code>forrest.properties</code>) points.
</action>
<action context="feedback" dev="JB">
Mail <link
href="mailto:forrest-dev@xml.apache.org">forrest-dev@xml.apache.org</link>
with feedback.
</action>
</actions>
<actions priority="high">
<action context="code" dev="SN">
</action>
</actions>
<actions priority="medium">
<action context="docs" dev="open">
</action>
-->
</actions>
</todo>
<changes>
</changes>
</status>
1.1 ws-site/src/documentation/README.txt
Index: README.txt
===================================================================
This is the base documentation directory. It usually contains two files:
skinconf.xml # This file customizes Forrest for your project. In it, you
# tell forrest the project name, logo, copyright info, etc
sitemap.xmap # Optional. This sitemap overrides the default one bundled
# with Forrest. Typically, one would copy a sitemap from
# xml-forrest/src/resources/conf/sitemap.xmap, and customize
# it.
1.1 ws-site/src/documentation/skinconf.xml
Index: skinconf.xml
===================================================================
<?xml version="1.0"?>
<!--
Skin configuration file. This file contains details of your project, which will
be used to configure the chosen Forrest skin.
-->
<!DOCTYPE skinconfig [
<!ENTITY % links.att 'name CDATA #REQUIRED'>
<!ENTITY % link.att 'name CDATA #REQUIRED href CDATA #REQUIRED'>
<!ELEMENT skinconfig (disable-search?, searchsite-domain?, searchsite-name?,
project-name, project-url, project-logo, group-name?, group-url?, group-logo?,
host-url?, host-logo?, year?, vendor?, trail?, credits?)*>
<!ELEMENT credits (credit*)>
<!ELEMENT credit (name, url, image?, width?, height?)>
<!-- id uniquely identifies the tool, and role indicates its function -->
<!ATTLIST credit id CDATA #IMPLIED
role CDATA #IMPLIED>
<!ELEMENT disable-search (#PCDATA)>
<!ELEMENT searchsite-domain (#PCDATA)>
<!ELEMENT searchsite-name (#PCDATA)>
<!ELEMENT project-name (#PCDATA)>
<!ELEMENT project-url (#PCDATA)>
<!ELEMENT project-logo (#PCDATA)>
<!ELEMENT group-name (#PCDATA)>
<!ELEMENT group-url (#PCDATA)>
<!ELEMENT group-logo (#PCDATA)>
<!ELEMENT host-url (#PCDATA)>
<!ELEMENT host-logo (#PCDATA)>
<!ELEMENT year (#PCDATA)>
<!ELEMENT vendor (#PCDATA)>
<!ELEMENT trail (link1, link2, link3)>
<!ELEMENT link1 EMPTY>
<!-- Seems we can't use param entity refs until this is DTDified -->
<!ATTLIST link1 name CDATA #REQUIRED href CDATA #IMPLIED>
<!ELEMENT link2 EMPTY>
<!ATTLIST link2 name CDATA #REQUIRED href CDATA #IMPLIED>
<!ELEMENT link3 EMPTY>
<!ATTLIST link3 name CDATA #REQUIRED href CDATA #IMPLIED>
<!ELEMENT name (#PCDATA)>
<!ELEMENT url (#PCDATA)>
<!ELEMENT image (#PCDATA)>
<!ELEMENT width (#PCDATA)>
<!ELEMENT height (#PCDATA)>
]>
<skinconfig>
<!-- Do we want to disable the Google search box? -->
<disable-search>false</disable-search>
<searchsite-domain>ws.apache.org</searchsite-domain>
<searchsite-name>Web Services</searchsite-name>
<!-- mandatory project logo
skin: forrest-site renders it at the top -->
<project-name>Web Services</project-name>
<project-url>http://ws.apache.org/</project-url>
<project-logo>images/project-logo.gif</project-logo>
<!-- optional group logo
skin: forrest-site renders it at the top-left corner -->
<group-name>Web Services</group-name>
<group-url>http://ws.apache.org/</group-url>
<group-logo>images/group-logo.gif</group-logo>
<!-- optional host logo (e.g. sourceforge logo)
skin: forrest-site renders it at the bottom-left corner -->
<host-url></host-url>
<host-logo></host-logo>
<!-- The following are used to construct a copyright statement -->
<year>2002</year>
<vendor>The Apache Software Foundation.</vendor>
<!-- Some skins use this to form a 'breadcrumb trail' of links. If you don't
want these, set the attributes to blank. The DTD purposefully requires them.
-->
<trail>
<link1 name="apache" href="http://www.apache.org/"/>
<link2 name="ws.apache" href="http://ws.apache.org/"/>
<link3 name="" href=""/>
</trail>
<!-- Credits are typically rendered as a set of small clickable images in the
page footer -->
<credits>
<credit>
<name>Built with Apache Forrest</name>
<url>http://xml.apache.org/forrest/</url>
<image>images/built-with-forrest-button.png</image>
<width>88</width>
<height>31</height>
</credit>
<!-- A credit with @role='pdf' will have its name and url displayed in the
PDF page's footer. -->
</credits>
</skinconfig>
1.1 ws-site/src/documentation/content/xdocs/index.xml
Index: index.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
<document>
<header>
<title>Welcome to Web Services Project @ Apache </title>
</header>
<body>
<section>
<title>Project List</title>
<ul>
<li><link href="ext:axis">Axis</link></li>
<li><link href="ext:soap">SOAP</link></li>
<li><link href="ext:wsif">WSIF</link></li>
<li><link href="ext:wsil">WSIL</link></li>
<li><link href="ext:xmlrpc">XML-RPC</link></li>
<li><link href="ext:xmlsec">XML-Security</link></li>
</ul>
</section>
<section>
<title>Committee Members</title>
<ul>
<li>Owen Burroughs</li>
<li>David Chappell</li>
<li>Glen Daniels</li>
<li>Anthony Elder</li>
<li>Christian Geuer-Pollmann</li>
<li>Jeremy Hughes</li>
<li>Tom Jordahl</li>
<li>Erwin van der Koogh</li>
<li>Ted Leung</li>
<li>Steve Loughran</li>
<li>Axl Mattheus</li>
<li>Nirmal Mukhi</li>
<li>Daniel Rall</li>
<li>Scott Nichol</li>
<li>Sam Ruby</li>
<li>Aleksander Slominski</li>
<li>James Snell</li>
<li>Davanum Srinivas</li>
<li>Sanjiva Weerawarana</li>
</ul>
</section>
</body>
</document>
1.1 ws-site/src/documentation/content/xdocs/sample.xml
Index: sample.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
<document>
<header>
<title>The document-v1.1 DTD</title>
<authors><person name="Steven Noels" email="stevenn@apache.org"/>
</authors>
<notice>This document doesn't make any sense at all.</notice>
<abstract>A nonsense document using all possible elements in the current
<code>document-v11.dtd</code>.</abstract>
</header>
<body>
<p id="top">This is a simple paragraph. Most documents contain a fair amount of
paragraphs. Paragraphs are called <code><p></code>.</p>
<p>A number of in-line elements are available in the DTD, we will show them
inside an unordered list (<code><ul></code>):</p>
<ul>
<li>Here is a simple list item (<code><li></code>).</li>
<li>Have you seen the use of the <code><code></code> element in the
previous item?</li>
<li>Also, we have <code><sub></code> and <code><sup></code>
elements to show content <sup>above</sup> or <sub>below</sub> the text
baseline.</li>
<li>There is a facility to <em>emphasize</em> certain words using the
<code><em></code> element.</li>
<li>We can use
<icon height="22" width="26" src="images/icon.png" alt="feather"/>
<code><icon></code>s, too.</li>
<li>Another possibility is the <code><img></code> element:
<img src="images/icon.png" alt="another feather" height="22" width="26"/>,
which offers the ability to refer to an image map.</li>
<li>We have elements for hyperlinking:
<dl>
<dt><code><link href="site:index"></code></dt>
<dd>Use this to
<link href="site:index" title="Example of a document via link">link</link>
to another document in the project, irrespective of where it is and
what it's extension will be. The 'index' node must be defined in
site.xml, eg:
<!-- FIXME: use 'source' instead when it's allowed -->
<code><![CDATA[
<site>
<index label="Index" href="index.html"/>
...
</site>
]]></code>
</dd>
<dt><code><link href="index.html"></code></dt>
<dd>Old-style <link href="index.html" title="Example of a document via
link">link</link> directly to a generated file. The
<code>site:</code> equivalent is preferred, as it avoids having to
work out <code>..</code>'s, and leaves rendition (HTML, PDF etc) up
to the sitemap.
</dd>
<dt><code><link href="#section"></code></dt>
<dd>Use this to
<link href="#section" title="Example of a document via local anchor">link</link>
to the named anchor in the current document.
</dd>
<dt><code><link href="sample.html#top"></code></dt>
<dd>Use this to
<link href="sample.html#top" title="Example of a document via link and anchor">link</link>
to another document and go to the named anchor. This will open
the new document in the same browser window.
</dd>
<dt><code><link href="site:sample/section"></code></dt>
<dd>Same as <code>#section</code> above, <link href="site:sample/section"
title="Example of a document via local anchor">links</link> to a
named anchor in this file, except is location-independent. Depends
on a site.xml definition like:
<!-- FIXME: use 'source' here instead -->
<code><![CDATA[
<site>
<sample label="Sample page" href="sample.html">
<section href="#section"/>
</sample>
</site>
]]>
</code>
</dd>
<dt><code><jump href="site:sample"></code></dt>
<dd>Use this to
<jump href="site:sample" title="Example of a document via jump">jump</jump>
to another document and optionally go to a named
<jump href="site:sample/top" title="Example of a document via jump to anchor">anchor</jump>
within that document. This will open the new document in the same
browser window. So what is the difference between link and jump?
The jump behaves differently, in that it will replace any frames
in the current window.
This is the equivalent of
<code><a ... target="_top"></code>
</dd>
<dt><code><fork href="site:changes"></code></dt>
<dd>Use this to
<fork href="site:changes" title="Example of a document via fork">fork</fork>
your webbrowser to another document. This will open the document
in a new, unnamed browser window.
This is the equivalent of
<code><a ... target="_blank"></code>
</dd>
</dl></li>
<li>Oh, by the way, a definition list <code><dl></code> was used inside
the previous list item. We could put another
<ul>
<li>unordered list</li>
<li>inside the list item</li>
</ul> too, but I believe this liberty gets quickly quite hairy as you
see.</li>
</ul>
<p>So far for the in-line elements, let's look at some paragraph-level
elements.</p>
<fixme author="SN">The <code><fixme></code> element is used for stuff
which still needs work. Mind the <code>author</code> attribute!</fixme>
<note>Use the <code><note></code> element to draw attention to something, e.g. ...The <code><code></code> element is used when the author can't
express himself clearly using normal sentences ;-)</note>
<warning>Sleep deprivation can be the result of being involved in an open
source project. (a.k.a. the <code><warning></code> element).</warning>
<p>Apart from unordered lists, we have ordered lists too, of course.</p>
<ol>
<li>Item 1</li>
<li>Item 2</li>
<li>This should be 3 if my math is still OK.</li>
</ol>
<anchor id="section"/>
<section>
<title>Using sections</title>
<p>You can use sections to put some structure in your document. For some
strange historical reason, the section title is an attribute of the
<code><section></code> element.</p>
</section>
<section>
<title>Sections, the sequel</title>
<p>Just some second section.</p>
<section>
<title>Section 2.1</title>
<p>Which contains a subsection (2.1).</p>
</section>
</section>
<anchor id="source"/>
<section>
<title>Showing preformatted source code</title>
<p>Enough about these sections. Let's have a look at more interesting
elements, <code><source></code> for instance:</p>
<source>// This example is from the book _Java in a Nutshell_ by David Flanagan.
// Written by David Flanagan. Copyright (c) 1996 O'Reilly & Associates.
// You may study, use, modify, and distribute this example for any purpose.
// This example is provided WITHOUT WARRANTY either expressed or implied.
import java.applet.*; // Don't forget these import statements!
import java.awt.*;
public class FirstApplet extends Applet {
// This method displays the applet.
// The Graphics class is how you do all drawing in Java.
public void paint(Graphics g) {
g.drawString("Hello World", 25, 50);
}
}</source>
<p>Please take care to still use a sensible line-length within your
source elements.</p>
</section>
<anchor id="table"/>
<section>
<title>Using tables</title>
<p>And now for a table:</p>
<table>
<caption>Table caption</caption>
<tr>
<th>heading cell</th>
<th>heading cell</th>
</tr>
<tr>
<td>data cell</td>
<td>data cell</td>
</tr>
</table>
<p>Not much of attributes with <code><table></code>, if you ask me.</p>
</section>
<anchor id="figure"/>
<section>
<title>Using figures</title>
<p>And a figure to end all of this.</p>
<figure src="images/project-logo.gif" alt="The fine Forrest logo" width="220" height="65"/>
</section>
</body>
<footer>
<legal>© 2002 Apache Forrest</legal>
</footer>
</document>
1.1 ws-site/src/documentation/content/xdocs/sample2.xml
Index: sample2.xml
===================================================================
<?xml version="1.0"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
<document>
<header>
<title>More samples</title>
<authors><person name="Steven Noels" email="stevenn@apache.org"/>
</authors>
</header>
<body>
<section>
<title>Miscellanea</title>
<p>
You can include raw HTML, PDFs and other files in Forrest output by
placing them in <code>src/documentation/content</code>. They will be
copied over automatically, and you can link to them as normal, eg <link
href="hello.pdf"><link href="hello.pdf"/></link>
<link href="test1.html"><link href="test1.html/></link>
</p>
</section>
</body>
</document>
1.1 ws-site/src/documentation/content/xdocs/site.xml
Index: site.xml
===================================================================
<?xml version="1.0"?>
<!--
Forrest site.xml
This file contains an outline of the site's information content. It is used to:
- Generate the website menus (though these can be overridden - see docs)
- Provide semantic, location-independent aliases for internal 'site:' URIs, eg
<link href="site:changes"> links to changes.html (or ../changes.html if in
subdir).
- Provide aliases for external URLs in the external-refs section. Eg, <link
href="ext:cocoon"> links to http://xml.apache.org/cocoon/
See http://xml.apache.org/forrest/linking.html for more info
-->
<site label="Web Services" href="" xmlns="http://apache.org/forrest/linkmap/1.0">
<about label="About">
<index label="Index" href="index.html"/>
<!--
<sample label="Sample page" href="sample.html">
<top href="#top"/>
<section href="#section"/>
<ihtml label="iHtml" href="test.html"/>
</sample>
<changes label="Changes" href="changes.html"/>
-->
<todo label="Todo" href="todo.html"/>
</about>
<external-refs>
<xml.apache.org href="http://xml.apache.org/">
<forrest href="forrest/"/>
<cocoon href="cocoon/"/>
<axis href="axis/"/>
<wsif href="axis/wsif/"/>
<wsil href="axis/wsil/"/>
<soap href="soap/"/>
<xmlrpc href="xmlrpc/"/>
<xmlsec href="security/"/>
</xml.apache.org>
</external-refs>
</site>
1.1 ws-site/src/documentation/content/xdocs/tabs.xml
Index: tabs.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.0//EN" "tab-cocoon-v10.dtd">
<tabs software="MyProj"
title="MyProj"
copyright="Foo"
xmlns:xlink="http://www.w3.org/1999/xlink">
<!-- The rules are:
@dir will always have /index.html added.
@href is not modified unless it is root-relative and obviously specifies a
directory (ends in '/'), in which case /index.html will be added
-->
<tab label="Home" dir=""/>
<!-- Add new tabs here, eg:
<tab label="How-Tos" dir="community/howto/"/>
<tab label="XML Site" dir="xml-site/"/>
-->
</tabs>
1.1 ws-site/src/documentation/content/xdocs/test.ihtml
Index: test.ihtml
===================================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
</head>
<body>
<h1>Test iHTML page</h1>
<p> This HTML is used to render the page instead of using the Forrest
XML DTD directly.</p>
<p>All linked-to pages, like <a href="test2.html">this one</a>, are
also available. </p>
<hr> [<a href="index.html">Index</a>]
</body>
</html>
1.1 ws-site/src/documentation/resources/images/group-logo.gif
<<Binary file>>
1.1 ws-site/src/documentation/resources/images/icon.png
<<Binary file>>
1.1 ws-site/src/documentation/resources/images/images.jpeg
<<Binary file>>
1.1 ws-site/src/documentation/resources/images/project-logo.gif
<<Binary file>>
1.1 ws-site/targets/changes.html
Index: changes.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>changes.html</pre></p><p><b>missing-file</b><pre>C:\jakarta\ws-site\build\site\changes.html</pre></p><hr size="1" noshade="true"/></body></html>
1.1 ws-site/targets/changes.pdf
<<Binary file>>
1.1 ws-site/targets/changes.rss.xml
Index: changes.rss.xml
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE rss PUBLIC "-//Netscape Communications//DTD RSS 0.91//EN" "http://my.netscape.com/publish/formats/rss-0.91.dtd">
<rss version="0.91"><channel><title>MyProject Changes</title><link>http://myproj.mygroup.org//changes.html</link><description>MyProject Changes</description><language>en-us</language><item><title>admin add</title><link>http://myproj.mygroup.org//changes.html</link><description>admin add
by
JB
:
Initial Import
</description></item></channel></rss>
1.1 ws-site/targets/favicon.ico
<<Binary file>>
1.1 ws-site/targets/hello.pdf
<<Binary file>>
1.1 ws-site/targets/index.html
Index: index.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Welcome to Web Services Project @ Apache </title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body marginheight="0" marginwidth="0" topmargin="0" leftmargin="0" text="#000000" bgcolor="#FFFFFF">
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#FFFFFF"><a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="Web Services" src="images/group-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#FFFFFF"><a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="Web Services" src="images/project-logo.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#FFFFFF">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#F7F7F7">
<tr>
<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="3"><img height="8" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
<br>
<span class="search">
the Web Services site
</span></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="3"><img height="7" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td class="bottom-right-thick"></td>
</tr>
</table>
</form>
</td>
<!--================= end Search ==================--><td bgcolor="#FFFFFF"><img height="10" width="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#FFFFFF" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="8"><img alt="" height="8" width="8" src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" height="22" border="0" cellpadding="0" cellspacing="0">
<tr>
<td class="top-left"></td><td valign="middle" bgcolor="#a5b6c6"><span class="tab"><b><a href="index.html"><font color="#000000">Home</font></a></b></span></td><td class="top-right"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#FFFFFF"><img alt="" width="1" height="1" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#a5b6c6" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#F7F7F7" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#FFFFFF"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#F7F7F7"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#F7F7F7">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#000000">About</font>
<ul>
<li>
<span class="sel">Index</span>
</li>
<ul>
<li>
<a href="#N101BD">Project List</a>
</li>
<ul></ul>
<li>
<a href="#N101E5">Committee Memb...</a>
</li>
<ul></ul>
</ul>
<li>
<a href="todo.html">Todo</a>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#F7F7F7"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="2" rowspan="2" class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="10" width="10" border="0" alt="" src="skin/images/spacer.gif"></td><td colspan="2" rowspan="2" class="bottom-right-thick"></td>
</tr>
<tr>
<td height="1" bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><span class="trail">
<script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></span><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#F7F7F7" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
<table class="title">
<tr>
<td valign="middle">
<h1>Welcome to Web Services Project @ Apache </h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="index.pdf"><img src="skin/images/printer.png" border="0"><br>
print-friendly<br>
version</a></td>
</tr>
</table>
<a name="N101BD"></a><a name="Project+List"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Project List</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Project List</title>
<ul>
<li>
<a href="http://xml.apache.org/axis/">Axis</a>
</li>
<li>
<a href="http://xml.apache.org/soap/">SOAP</a>
</li>
<li>
<a href="http://xml.apache.org/axis/wsif/">WSIF</a>
</li>
<li>
<a href="http://xml.apache.org/axis/wsil/">WSIL</a>
</li>
<li>
<a href="http://xml.apache.org/xmlrpc/">XML-RPC</a>
</li>
<li>
<a href="http://xml.apache.org/security/">XML-Security</a>
</li>
</ul>
</div>
<a name="N101E5"></a><a name="Committee+Members"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Committee Members</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Committee Members</title>
<ul>
<li>Owen Burroughs</li>
<li>David Chappell</li>
<li>Glen Daniels</li>
<li>Anthony Elder</li>
<li>Christian Geuer-Pollmann</li>
<li>Jeremy Hughes</li>
<li>Tom Jordahl</li>
<li>Erwin van der Koogh</li>
<li>Ted Leung</li>
<li>Steve Loughran</li>
<li>Axl Mattheus</li>
<li>Nirmal Mukhi</li>
<li>Daniel Rall</li>
<li>Scott Nichol</li>
<li>Sam Ruby</li>
<li>Aleksander Slominski</li>
<li>James Snell</li>
<li>Davanum Srinivas</li>
<li>Sanjiva Weerawarana</li>
</ul>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" height="20" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#F7F7F7"><img height="1" width="1" alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#a5b6c6" class="copyright" align="center" width="90%"><span class="footnote">Copyright ©
2002 The Apache Software Foundation. All rights reserved.
<br>
<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></span></td><td nowrap="nowrap" align="right" bgcolor="#a5b6c6" class="logos"><a href="http://xml.apache.org/forrest/"><img border="0" valign="top" alt="Built with Apache Forrest logo" src="images/built-with-forrest-button.png" width="88" height="31"><img height="1" width="5" alt="" border="0" src="skin/images/spacer.gif"></a></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 ws-site/targets/index.pdf
<<Binary file>>
1.1 ws-site/targets/sample.html
Index: sample.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>The document-v1.1 DTD</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body marginheight="0" marginwidth="0" topmargin="0" leftmargin="0" text="#000000" bgcolor="#FFFFFF">
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#FFFFFF"><a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="Web Services" src="images/group-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#FFFFFF"><a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="Web Services" src="images/project-logo.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#FFFFFF">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#F7F7F7">
<tr>
<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="3"><img height="8" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
<br>
<span class="search">
the Web Services site
</span></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="3"><img height="7" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td class="bottom-right-thick"></td>
</tr>
</table>
</form>
</td>
<!--================= end Search ==================--><td bgcolor="#FFFFFF"><img height="10" width="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#FFFFFF" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="8"><img alt="" height="8" width="8" src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" height="22" border="0" cellpadding="0" cellspacing="0">
<tr>
<td class="top-left"></td><td valign="middle" bgcolor="#a5b6c6"><span class="tab"><b><a href="index.html"><font color="#000000">Home</font></a></b></span></td><td class="top-right"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#FFFFFF"><img alt="" width="1" height="1" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#a5b6c6" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#F7F7F7" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#FFFFFF"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#F7F7F7"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#F7F7F7">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#000000">About</font>
<ul>
<li>
<a href="index.html">Index</a>
</li>
<li>
<span class="sel">Sample page</span>
</li>
<ul>
<li>
<a href="#N102CC">Using sections</a>
</li>
<ul></ul>
<li>
<a href="#N102D9">Sections, the ...</a>
</li>
<ul>
<li>
<a href="#N102E2">Section 2.1</a>
</li>
</ul>
<li>
<a href="#N102F0">Showing prefor...</a>
</li>
<ul></ul>
<li>
<a href="#N10307">Using tables</a>
</li>
<ul></ul>
<li>
<a href="#N1033A">Using figures</a>
</li>
<ul></ul>
</ul>
<li>
<a href="changes.html">Changes</a>
</li>
<li>
<a href="todo.html">Todo</a>
</li>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#F7F7F7"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="2" rowspan="2" class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="10" width="10" border="0" alt="" src="skin/images/spacer.gif"></td><td colspan="2" rowspan="2" class="bottom-right-thick"></td>
</tr>
<tr>
<td height="1" bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><span class="trail">
<script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></span><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#F7F7F7" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
<table class="title">
<tr>
<td valign="middle">
<h1>The document-v1.1 DTD</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="sample.pdf"><img src="skin/images/printer.png" border="0"><br>
print-friendly<br>
version</a></td>
</tr>
</table>
<p>
<a name="top"></a>This is a simple paragraph. Most documents contain a fair amount of
paragraphs. Paragraphs are called <span class="codefrag"><p></span>.</p>
<p>A number of in-line elements are available in the DTD, we will show them
inside an unordered list (<span class="codefrag"><ul></span>):</p>
<ul>
<li>Here is a simple list item (<span class="codefrag"><li></span>).</li>
<li>Have you seen the use of the <span class="codefrag"><code></span> element in the
previous item?</li>
<li>Also, we have <span class="codefrag"><sub></span> and <span class="codefrag"><sup></span>
elements to show content <sup>above</sup> or <sub>below</sub> the text
baseline.</li>
<li>There is a facility to <em>emphasize</em> certain words using the
<span class="codefrag"><em></span> element.</li>
<li>We can use
<img alt="feather" src="images/icon.png" height="22" width="26">
<span class="codefrag"><icon></span>s, too.</li>
<li>Another possibility is the <span class="codefrag"><img></span> element:
<img alt="another feather" height="22" src="images/icon.png" width="26">,
which offers the ability to refer to an image map.</li>
<li>We have elements for hyperlinking:
<dl>
<dt>
<span class="codefrag"><link href="site:index"></span>
</dt>
<dd>Use this to
<a href="index.html">link</a>
to another document in the project, irrespective of where it is and
what it's extension will be. The 'index' node must be defined in
site.xml, eg:
<!-- FIXME: use 'source' instead when it's allowed -->
<span class="codefrag">
<site>
<index label="Index" href="index.html"/>
...
</site>
</span>
</dd>
<dt>
<span class="codefrag"><link href="index.html"></span>
</dt>
<dd>Old-style <a href="index.html">link</a> directly to a generated file. The
<span class="codefrag">site:</span> equivalent is preferred, as it avoids having to
work out <span class="codefrag">..</span>'s, and leaves rendition (HTML, PDF etc) up
to the sitemap.
</dd>
<dt>
<span class="codefrag"><link href="#section"></span>
</dt>
<dd>Use this to
<a href="#section">link</a>
to the named anchor in the current document.
</dd>
<dt>
<span class="codefrag"><link href="sample.html#top"></span>
</dt>
<dd>Use this to
<a href="sample.html#top">link</a>
to another document and go to the named anchor. This will open
the new document in the same browser window.
</dd>
<dt>
<span class="codefrag"><link href="site:sample/section"></span>
</dt>
<dd>Same as <span class="codefrag">#section</span> above, <a href="sample.html#section">links</a> to a
named anchor in this file, except is location-independent. Depends
on a site.xml definition like:
<!-- FIXME: use 'source' here instead -->
<span class="codefrag">
<site>
<sample label="Sample page" href="sample.html">
<section href="#section"/>
</sample>
</site>
</span>
</dd>
<dt>
<span class="codefrag"><jump href="site:sample"></span>
</dt>
<dd>Use this to
<a target="_top" href="sample.html">jump</a>
to another document and optionally go to a named
<a target="_top" href="sample.html#top">anchor</a>
within that document. This will open the new document in the same
browser window. So what is the difference between link and jump?
The jump behaves differently, in that it will replace any frames
in the current window.
This is the equivalent of
<span class="codefrag"><a ... target="_top"></span>
</dd>
<dt>
<span class="codefrag"><fork href="site:changes"></span>
</dt>
<dd>Use this to
<a target="_blank" href="changes.html">fork</a>
your webbrowser to another document. This will open the document
in a new, unnamed browser window.
This is the equivalent of
<span class="codefrag"><a ... target="_blank"></span>
</dd>
</dl>
</li>
<li>Oh, by the way, a definition list <span class="codefrag"><dl></span> was used inside
the previous list item. We could put another
<ul>
<li>unordered list</li>
<li>inside the list item</li>
</ul> too, but I believe this liberty gets quickly quite hairy as you
see.</li>
</ul>
<p>So far for the in-line elements, let's look at some paragraph-level
elements.</p>
<div class="frame fixme">
<div class="label">Fixme (
SN
)</div>
<div class="content">The <span class="codefrag"><fixme></span> element is used for stuff
which still needs work. Mind the <span class="codefrag">author</span> attribute!</div>
</div>
<div class="frame note">
<div class="label">Note</div>
<div class="content">Use the <span class="codefrag"><note></span> element to draw attention to something, e.g. ...The <span class="codefrag"><code></span> element is used when the author can't
express himself clearly using normal sentences ;-)</div>
</div>
<div class="frame warning">
<div class="label">Warning</div>
<div class="content">Sleep deprivation can be the result of being involved in an open
source project. (a.k.a. the <span class="codefrag"><warning></span> element).</div>
</div>
<p>Apart from unordered lists, we have ordered lists too, of course.</p>
<ol>
<li>Item 1</li>
<li>Item 2</li>
<li>This should be 3 if my math is still OK.</li>
</ol>
<a name="section"></a>
<a name="N102CC"></a><a name="Using+sections"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Using sections</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Using sections</title>
<p>You can use sections to put some structure in your document. For some
strange historical reason, the section title is an attribute of the
<span class="codefrag"><section></span> element.</p>
</div>
<a name="N102D9"></a><a name="Sections%2C+the+sequel"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Sections, the sequel</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Sections, the sequel</title>
<p>Just some second section.</p>
<a name="N102E2"></a><a name="Section+2.1"></a>
<table border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h4>Section 2.1</h4>
</td><td></td>
</tr>
<tr>
<td class="bottom-left"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right"></td>
</tr>
</tbody>
</table>
<p>Which contains a subsection (2.1).</p>
</div>
<a name="source"></a>
<a name="N102F0"></a><a name="Showing+preformatted+source+code"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Showing preformatted source code</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Showing preformatted source code</title>
<p>Enough about these sections. Let's have a look at more interesting
elements, <span class="codefrag"><source></span> for instance:</p>
<pre class="code">// This example is from the book _Java in a Nutshell_ by David Flanagan.
// Written by David Flanagan. Copyright (c) 1996 O'Reilly & Associates.
// You may study, use, modify, and distribute this example for any purpose.
// This example is provided WITHOUT WARRANTY either expressed or implied.
import java.applet.*; // Don't forget these import statements!
import java.awt.*;
public class FirstApplet extends Applet {
// This method displays the applet.
// The Graphics class is how you do all drawing in Java.
public void paint(Graphics g) {
g.drawString("Hello World", 25, 50);
}
}</pre>
<p>Please take care to still use a sensible line-length within your
source elements.</p>
</div>
<a name="table"></a>
<a name="N10307"></a><a name="Using+tables"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Using tables</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Using tables</title>
<p>And now for a table:</p>
<table class="ForrestTable" cellspacing="1" cellpadding="4">
<caption>Table caption</caption>
<tr>
<th colspan="1" rowspan="1">heading cell</th>
<th colspan="1" rowspan="1">heading cell</th>
</tr>
<tr>
<td colspan="1" rowspan="1">data cell</td>
<td colspan="1" rowspan="1">data cell</td>
</tr>
</table>
<p>Not much of attributes with <span class="codefrag"><table></span>, if you ask me.</p>
</div>
<a name="figure"></a>
<a name="N1033A"></a><a name="Using+figures"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>Using figures</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>Using figures</title>
<p>And a figure to end all of this.</p>
<div align="center">
<img class="figure" alt="The fine Forrest logo" src="images/project-logo.gif" height="65" width="220"></div>
</div>
<p align="right">
<font size="-2">by Steven Noels</font>
</p>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" height="20" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#F7F7F7"><img height="1" width="1" alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#a5b6c6" class="copyright" align="center" width="90%"><span class="footnote">Copyright ©
2002 The Apache Software Foundation. All rights reserved.
<br>
<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></span></td><td nowrap="nowrap" align="right" bgcolor="#a5b6c6" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 ws-site/targets/sample.pdf
<<Binary file>>
1.1 ws-site/targets/test1.html
Index: test1.html
===================================================================
<html>
<body>
<h1>Test HTML page</h1>
<p>
This raw HTML page is linked to from xdocs/sample2.xml.
</p>
<p>All linked-to pages, like <a href="test2.html">this one</a>, are
also available.
<hr />
[<a href="index.html">Index</a>]
</body>
</html>
1.1 ws-site/targets/test2.html
Index: test2.html
===================================================================
<html>
<h1>Test 2</h1>
<p>
A linked-to-from-HTML page.
<hr />
[<a href="index.html">Index</a>] [<a href="test1.html">test1.html</a>]
</p>
</html>
1.1 ws-site/targets/todo.html
Index: todo.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Todo List</title>
<link type="text/css" href="skin/page.css" rel="stylesheet">
</head>
<body marginheight="0" marginwidth="0" topmargin="0" leftmargin="0" text="#000000" bgcolor="#FFFFFF">
<!--================= start Banner ==================-->
<table summary="header with logos" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<!--================= start Group Logo ==================-->
<td bgcolor="#FFFFFF"><a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="Web Services" src="images/group-logo.gif"></a></td>
<!--================= end Group Logo ==================-->
<!--================= start Project Logo ==================--><td width="100%" align="center" bgcolor="#FFFFFF"><a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="Web Services" src="images/project-logo.gif"></a></td>
<!--================= end Project Logo ==================-->
<!--================= start Search ==================--><td valign="top" rowspan="2" bgcolor="#FFFFFF">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0" bgcolor="#F7F7F7">
<tr>
<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="3"><img height="8" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="15" name="q" id="query" type="text"><img height="1" width="5" alt="" src="skin/images/spacer.gif"><input name="Search" value="Search" type="submit">
<br>
<span class="search">
the Web Services site
</span></td><td><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="3"><img height="7" width="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="skin/images/spacer.gif"></td><td class="bottom-right-thick"></td>
</tr>
</table>
</form>
</td>
<!--================= end Search ==================--><td bgcolor="#FFFFFF"><img height="10" width="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td valign="bottom" bgcolor="#FFFFFF" colspan="2">
<!--================= start Tabs ==================-->
<div class="tab">
<table summary="tab bar" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="8"><img alt="" height="8" width="8" src="skin/images/spacer.gif"></td><td valign="bottom">
<table summary="selected tab" height="22" border="0" cellpadding="0" cellspacing="0">
<tr>
<td class="top-left"></td><td valign="middle" bgcolor="#a5b6c6"><span class="tab"><b><a href="index.html"><font color="#000000">Home</font></a></b></span></td><td class="top-right"></td>
</tr>
</table>
</td>
</tr>
</table>
</div>
<!--================= end Tabs ==================-->
</td><td bgcolor="#FFFFFF"><img alt="" width="1" height="1" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#a5b6c6" colspan="4"><img width="1" height="10" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
<!--================= end Banner ==================-->
<!--================= start Menu, NavBar, Content ==================-->
<table summary="page content" bgcolor="#ffffff" width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td valign="top">
<table summary="menu" border="0" cellspacing="0" cellpadding="0">
<tr>
<!--================= start left top NavBar ==================-->
<td rowspan="3" valign="top">
<table summary="blue line" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td bgcolor="#CFDCED"><font color="#F7F7F7" size="4" face="Arial, Helvetica, Sans-serif"> </font></td>
</tr>
<tr>
<td bgcolor="#FFFFFF"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td>
<!--================= end left top NavBar ==================--><td bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td><td valign="bottom" bgcolor="#F7F7F7"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td nowrap="nowrap" valign="top" bgcolor="#F7F7F7">
<!--================= start Menu items ==================-->
<div class="menu">
<ul>
<li>
<font color="#000000">About</font>
<ul>
<li>
<a href="index.html">Index</a>
</li>
<li>
<span class="sel">Todo</span>
</li>
<ul>
<li>
<a href="#N10008">high</a>
</li>
<ul></ul>
</ul>
</ul>
</li>
</ul>
</div>
<!--================= end Menu items ==================-->
</td><td valign="bottom" bgcolor="#F7F7F7"><img width="10" height="10" alt="" src="skin/images/spacer.gif"></td><td bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="2" rowspan="2" class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="10" width="10" border="0" alt="" src="skin/images/spacer.gif"></td><td colspan="2" rowspan="2" class="bottom-right-thick"></td>
</tr>
<tr>
<td height="1" bgcolor="#a5b6c6"><img width="1" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
</table>
</td><td valign="top" width="100%">
<table summary="content" width="100%" border="0" cellpadding="0" cellspacing="0">
<!--================= start middle NavBar ==================-->
<tr>
<td colspan="4" bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td align="left" width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="50%" bgcolor="#CFDCED"><span class="trail">
<script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script></span><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td align="right" width="50%" bgcolor="#CFDCED"><font color="#F7F7F7" size="3" face="Arial, Helvetica, Sans-serif">
</font><img width="10" height="8" alt="" src="skin/images/spacer.gif"></td><td width="10" bgcolor="#CFDCED"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<tr>
<td colspan="4" bgcolor="#a5b6c6"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end middle NavBar ==================-->
<!--================= start Content==================-->
<tr>
<td align="left" width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td><td align="left" width="100%">
<div class="content">
<table class="title">
<tr>
<td valign="middle">
<h1>Todo List</h1>
</td><td nowrap="nowrap" width="80" align="center"><a class="dida" href="todo.pdf"><img src="skin/images/printer.png" border="0"><br>
print-friendly<br>
version</a></td>
</tr>
</table>
<a name="N10008"></a>
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tbody>
<tr>
<td height="10" width="9"></td><td>
<h3>high</h3>
</td><td></td>
</tr>
<tr>
<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"></td><td class="bottom-right-thick"></td>
</tr>
</tbody>
</table>
<div class="section">
<title>high</title>
<ul>
<li>
<strong>[docs]</strong>
setup pmc and general mailing lists
→ rubys</li>
</ul>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt="" src="skin/images/spacer.gif"></td>
</tr>
<!--================= end Content==================-->
</table>
</td>
</tr>
</table>
<!--================= end Menu, NavBar, Content ==================-->
<!--================= start Footer ==================-->
<table summary="footer" cellspacing="0" cellpadding="0" width="100%" height="20" border="0">
<tr>
<td colspan="2" height="1" bgcolor="#F7F7F7"><img height="1" width="1" alt="" src="skin/images/spacer.gif"><a href="skin/images/label.gif"></a><a href="skin/images/page.gif"></a><a href="skin/images/chapter.gif"></a><a href="skin/images/chapter_open.gif"></a><a href="skin/images/current.gif"></a><a href="/favicon.ico"></a></td>
</tr>
<tr>
<td colspan="2" bgcolor="#a5b6c6" class="copyright" align="center" width="90%"><span class="footnote">Copyright ©
2002 The Apache Software Foundation. All rights reserved.
<br>
<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " + document.lastModified);
// --></script></span></td><td nowrap="nowrap" align="right" bgcolor="#a5b6c6" class="logos"></td>
</tr>
</table>
<!--================= end Footer ==================-->
</body>
</html>
1.1 ws-site/targets/todo.pdf
<<Binary file>>
1.1 ws-site/targets/images/add.jpg
<<Binary file>>
1.1 ws-site/targets/images/built-with-forrest-button.png
<<Binary file>>
1.1 ws-site/targets/images/group-logo.gif
<<Binary file>>
1.1 ws-site/targets/images/icon.png
<<Binary file>>
1.1 ws-site/targets/images/project-logo.gif
<<Binary file>>
1.1 ws-site/targets/images/rss.png
<<Binary file>>
1.1 ws-site/targets/skin/breadcrumbs.js
Index: breadcrumbs.js
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Apache Forrest" and "Apache Software Foundation"
must not be used to endorse or promote products derived from this software
without prior written permission. For written permission, please contact
apache@apache.org.
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
/**
* This script, when included in a html file, builds a neat breadcrumb trail
* based on its url. That is, if it doesn't contains bugs (I'm relatively
* sure it does).
*
* Typical usage:
* <script type="text/javascript" language="JavaScript" src="breadcrumbs.js"></script>
*
*@author <a href="mailto:leosimons@apache.org">Leo Simons</a> (main author)
*@author <a href="mailto:nicolaken@apache.org">Nicola Ken Barozzi</a> (integration in skin)
*@created July 12, 2002
*@version 1.0
*/
/* ========================================================================
CONSTANTS
======================================================================== */
/**
* Two-dimensional array containing extra crumbs to place at the front of
* the trail. Specify first the name of the crumb, then the URI that belongs
* to it. You'll need to modify this for every domain or subdomain where
* you use this script (you can leave it as an empty array if you wish)
*/
var PREPREND_CRUMBS = new Array();
if(!("apache"=="")){
PREPREND_CRUMBS.push( new Array( "apache", "http://www.apache.org/" ) );
}
if(!("ws.apache"=="")){
PREPREND_CRUMBS.push( new Array( "ws.apache", "http://ws.apache.org/" ) );
}
if(!(""=="")){
PREPREND_CRUMBS.push( new Array( "", "" ) );
}
/**
* String to include between crumbs:
*/
var DISPLAY_SEPARATOR = " > ";
/**
* String to include at the beginning of the trail
*/
var DISPLAY_PREPREND = "";
/**
* String to include at the end of the trail
*/
var DISPLAY_POSTPREND = "";
/**
* CSS Class to use for a single crumb:
*/
var CSS_CLASS_CRUMB = "breadcrumb";
/**
* CSS Class to use for the complete trail:
*/
var CSS_CLASS_TRAIL = "breadcrumbTrail";
/**
* CSS Class to use for crumb separator:
*/
var CSS_CLASS_SEPARATOR = "crumbSeparator";
/**
* Array of strings containing common file extensions. We use this to
* determine what part of the url to ignore (if it contains one of the
* string specified here, we ignore it).
*/
var FILE_EXTENSIONS = new Array( ".html", ".htm", ".jsp", ".php", ".php3", ".php4" );
/**
* String that separates parts of the breadcrumb trail from each other.
* When this is no longer a slash, I'm sure I'll be old and grey.
*/
var PATH_SEPARATOR = "/";
/* ========================================================================
UTILITY FUNCTIONS
======================================================================== */
/**
* Capitalize first letter of the provided string and return the modified
* string.
*/
function sentenceCase( string )
{ return string;
//var lower = string.toLowerCase();
//return lower.substr(0,1).toUpperCase() + lower.substr(1);
}
/**
* Returns an array containing the names of all the directories in the
* current document URL
*/
function getDirectoriesInURL()
{
var trail = document.location.pathname.split( PATH_SEPARATOR );
// check whether last section is a file or a directory
var lastcrumb = trail[trail.length-1];
for( var i = 0; i < FILE_EXTENSIONS.length; i++ )
{
if( lastcrumb.indexOf( FILE_EXTENSIONS[i] ) )
{
// it is, remove it and send results
return trail.slice( 1, trail.length-1 );
}
}
// it's not; send the trail unmodified
return trail.slice( 1, trail.length );
}
/* ========================================================================
BREADCRUMB FUNCTIONALITY
======================================================================== */
/**
* Return a two-dimensional array describing the breadcrumbs based on the
* array of directories passed in.
*/
function getBreadcrumbs( dirs )
{
var prefix = "/";
var postfix = "/";
// the array we will return
var crumbs = new Array();
if( dirs != null )
{
for( var i = 0; i < dirs.length; i++ )
{
prefix += dirs[i] + postfix;
crumbs.push( new Array( dirs[i], prefix ) );
}
}
// preprend the PREPREND_CRUMBS
if(PREPREND_CRUMBS.length > 0 )
{
return PREPREND_CRUMBS.concat( crumbs );
}
return crumbs;
}
/**
* Return a string containing a simple text breadcrumb trail based on the
* two-dimensional array passed in.
*/
function getCrumbTrail( crumbs )
{
var xhtml = DISPLAY_PREPREND;
for( var i = 0; i < crumbs.length; i++ )
{
xhtml += '<a href="' + crumbs[i][1] + '" >';
xhtml += sentenceCase( crumbs[i][0] ) + '</a>';
if( i != (crumbs.length-1) )
{
xhtml += DISPLAY_SEPARATOR;
}
}
xhtml += DISPLAY_POSTPREND;
return xhtml;
}
/**
* Return a string containing an XHTML breadcrumb trail based on the
* two-dimensional array passed in.
*/
function getCrumbTrailXHTML( crumbs )
{
var xhtml = '<span class="' + CSS_CLASS_TRAIL + '">';
xhtml += DISPLAY_PREPREND;
for( var i = 0; i < crumbs.length; i++ )
{
xhtml += '<a href="' + crumbs[i][1] + '" class="' + CSS_CLASS_CRUMB + '">';
xhtml += sentenceCase( crumbs[i][0] ) + '</a>';
if( i != (crumbs.length-1) )
{
xhtml += '<span class="' + CSS_CLASS_SEPARATOR + '">' + DISPLAY_SEPARATOR + '</span>';
}
}
xhtml += DISPLAY_POSTPREND;
xhtml += '</span>';
return xhtml;
}
/* ========================================================================
PRINT BREADCRUMB TRAIL
======================================================================== */
// check if we're local; if so, only print the PREPREND_CRUMBS
if( document.location.href.toLowerCase().indexOf( "http://" ) == -1 )
{
document.write( getCrumbTrail( getBreadcrumbs() ) );
}
else
{
document.write( getCrumbTrail( getBreadcrumbs( getDirectoriesInURL() ) ) );
}
1.1 ws-site/targets/skin/page.css
Index: page.css
===================================================================
body { background-color: #FFFFFF; margin: 0px 0px 0px 0px; font-family: Verdana, Helvetica, sans-serif; font-size : 80%; }
p { background-color: #FFFFFF; margin: 10px 0px 0px 0px; font-family: Verdana, Helvetica, sans-serif; font-size : 100%; }
a:link { color: #0F3660; }
a:visited { color: #009999; }
a:active { color: #000066; }
a:hover { color: #000000; border: 1px solid #a5b6c6; background: #CFDCED; !important}
.menu { background-color: #F7F7F7; margin: 0px; padding: 3px 3px 5px 3px; font-size : 70%; }
.menu a:link { color: #000000; text-decoration : none; }
.menu a:visited { color: #000000; text-decoration : none; }
/*.menu a:active { font-weight: bold }*/
.menu a:hover { color: #00AA77; text-decoration : none; }
.menu ul { margin: 0px 0px 6px 8px; padding: 0px; }
.menu li { margin: 0px 0px 2px 0px; padding: 0px; list-style-image: url('images/label.gif'); font-weight : bold; }
.menu ul ul li .sel { list-style-image: url('images/current.gif'); font-style : plain;
background-color:#CFDCED; border-color: #a5b6c6; border-style: solid; border-width: 1px;}
.menu ul ul li { list-style-image: url('images/page.gif'); font-weight : normal; }
table .title { background-color: #FFFFFF; width:100%; border: 0px; }
.dida { font-size: 60%; }
.pre { white-space: pre;}
h1 { font-size : 140%; margin: 0px 0px 0px 0px; padding: 0px; }
h2 { font-size : 130%; margin: 10px 0px 0px 0px; padding: 0px; font-weight : bold;}
h3 { font-size : 110%; margin: 18px 0px 0px 0px; padding: 0px; font-weight : bold; }
h4 { font-size : 100%; margin: 18px 0px 0px 0px; padding: 0px; font-weight : plain; text-align: left; }
h5 { font-size : 90%; margin: 14px 0px 0px 0px; padding: 0px; font-weight : plain; text-align: left; }
.content { padding: 5px 5px 5px 10px; font : small Verdana, Helvetica, sans-serif; font-size : 80%; }
.content .ForrestTable { width: 100%; background-color: #7099C5; color: #ffffff; font-size : 100%;}
.content .ForrestTable caption { text-align: left; color: black; font-weight: bold; }
.content .ForrestTable th { text-align: center; }
.content .ForrestTable td { background-color: #f0f0ff; color: black; }
//.frame { margin: 5px 20px 5px 20px; font-size: 100%; }
//.frame .content { margin: 2px; }
.note, .warning, .fixme {
border-top: 3px solid #900;
border-bottom: 3px solid #900;
background-image: url(images/icon_error_lrg.gif);
background-repeat: no-repeat;
background-position: 0 1.33em;
margin: 1.33em 0;
padding: .33em 0 .67em 36px;
min-height: 32px;
}
.fixme {
background-image: url(images/icon_warning_lrg.gif);
border-color: #c60;
}
.note {
background-image: url(images/icon_info_lrg.gif);
border-color: #069;
}
//.note { border: solid 1px #7099C5; background-color: #f0f0ff; }
//.note .label { background-color: #7099C5; color: #ffffff; }
//.warning { border: solid 1px #D00000; background-color: #fff0f0; }
//.warning .label { background-color: #D30000; color: #ffffff; }
//.fixme { border: solid 1px #C6C600; background-color: #FAF9C3; }
//.fixme .label { background-color: #C6C600; color: #ffffff; }
.code { border-color: #CFDCED; border-style: solid; border-width: 1px; font-size : 120%;}
.codefrag { font-family: "Courier New", Courier, monospace; font-size : 120%;}
.highlight { background-color: yellow; }
.minitoc { list-style-image: url('images/current.gif'); font-weight : normal;}
.search { font-size : 70%; }
.footnote { font-size : 70%; }
input { font-size : 70% }
submit { font-size : 70% }
button { font-size : 70% }
textarea { font-size : 70% }
.tab { font-size : 70%; border: 0 }
.tab a:link { text-decoration : none; }
.tab a:visited { text-decoration : none; }
.trail { font-size: 70%; }
.trail a:link { text-decoration : none; }
.trail a:visited { text-decoration : none; }
.dtdTag { color: #990000; text-transform : uppercase; font-style : normal; font-size : 120%; font-weight : bold; }
.top-left {
background-color: #a5b6c6;
background-image: url(images/top-left.png);
background-repeat: no-repeat;
background-position: top left;
width : 5;
height : 5;
}
.top-right {
background-color: #a5b6c6;
background-image: url(images/top-right.png);
background-repeat: no-repeat;
background-position: top right;
width : 5;
height : 5;
}
.top-left-tab {
background-color: #cedfef;
background-image: url(images/top-left.png);
background-repeat: no-repeat;
background-position: top left;
width : 5;
height : 5;
}
.top-right-tab {
background-color: #cedfef;
background-image: url(images/top-right.png);
background-repeat: no-repeat;
background-position: top right;
width : 5;
height : 5;
}
.bottom-left {
background-color: #a5b6c6;
background-image: url(images/bottom-left.png);
background-repeat: no-repeat;
background-position: bottom left;
width : 5;
height : 5;
}
.bottom-right {
background-color: #a5b6c6;
background-image: url(images/bottom-right.png);
background-repeat: no-repeat;
background-position: bottom right;
width : 5;
height : 5;
}
.bottom-left-thick {
background-color: #a5b6c6;
background-image: url(images/bottom-left.png);
background-repeat: no-repeat;
background-position: bottom left;
width : 5;
height : 9;
}
.bottom-right-thick {
background-color: #a5b6c6;
background-image: url(images/bottom-right.png);
background-repeat: no-repeat;
background-position: bottom right;
width : 5;
height : 9;
}
1.1 ws-site/targets/skin/images/chapter.gif
<<Binary file>>
1.1 ws-site/targets/skin/images/chapter_open.gif
<<Binary file>>
1.1 ws-site/targets/skin/images/current.gif
<<Binary file>>
1.1 ws-site/targets/skin/images/label.gif
<<Binary file>>
1.1 ws-site/targets/skin/images/page.gif
<<Binary file>>
1.1 ws-site/targets/skin/images/printer.png
<<Binary file>>
1.1 ws-site/targets/skin/images/spacer.gif
<<Binary file>>
1.1 ws-site/targets/subdir/index.html
Index: index.html
===================================================================
<html><head><title>Resource not Found</title><STYLE><!--H1{font-family : sans-serif,Arial,Tahoma;color : white;background-color : #0086b2;} BODY{font-family : sans-serif,Arial,Tahoma;color : black;background-color : white;} B{color : white;background-color : #0086b2;} HR{color : #0086b2;} --></STYLE> </head><body><h1>Cocoon 2 - Resource not Found</h1><hr size="1" noshade="noshade"/><p><b>type</b> resource-not-found</p><p><b>message</b> <u>Page Not Available.</u></p><p><b>description</b> <u>The requested resource couldn't be found.</u></p><p><b>sender</b> org.apache.cocoon.Main</p><p><b>source</b> Cocoon commandline (Main.java)</p><p><b>request-uri</b><pre>subdir/index.html</pre></p><p><b>missing-file</b><pre>C:\jakarta\ws-site\build\site\subdir\index.html</pre></p><hr size="1" noshade="true"/></body></html>
1.1 ws-site/targets/subdir/index.pdf
<<Binary file>>
Re: http://ws.apache.org/ is online!
Posted by Davanum Srinivas <di...@yahoo.com>.
Thanks Sam.
--- Sam Ruby <ru...@apache.org> wrote:
> I've set this up to automatically update from cvs every six hours.
>
> - Sam Ruby
>
=====
Davanum Srinivas - http://xml.apache.org/~dims/
__________________________________________________
Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.
http://mailplus.yahoo.com
http://ws.apache.org/ is online!
Posted by Sam Ruby <ru...@apache.org>.
I've set this up to automatically update from cvs every six hours.
- Sam Ruby