You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by ta...@apache.org on 2009/02/24 00:32:45 UTC

svn commit: r747211 - in /portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant: ./ references/

Author: taylor
Date: Mon Feb 23 23:32:43 2009
New Revision: 747211

URL: http://svn.apache.org/viewvc?rev=747211&view=rev
Log:
eoln

Added:
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/navigation.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml   (with props)
Modified:
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/eclipse.xml

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,168 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more	contributor license agreements.  See the NOTICE file distributed with
+	this work for additional information regarding copyright ownership.
+	The ASF licenses this file to You under the Apache License, Version 2.0
+	(the "License"); you may not use this file except in compliance with
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Jetspeed-2 Tutorial with Ant and Eclipse</title>
+		<subtitle>Building a Custom Jetspeed-2 Portal</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+		</authors>
+	</properties>
+	<body>
+		<section
+			name="Welcome to the Jetspeed-2 Tutorial with Ant and Eclipse">
+			
+				<p>
+					This Jetspeed-2 tutorial is a step-by-step set of
+					instructions and source code for creating a custom
+					Jetspeed-2 Portal from scratch using Ant and
+					Eclipse.
+				</p>
+			
+			<p>
+				When starting a new Jetspeed-2 portal project, we
+				strongly recommend that you create a new portal project
+				using the working JetExpress as a base. Do not edit the
+				Jetspeed-2 source and resources directly.
+			</p>
+			<p>
+				As your project progresses, you may want to look at the
+				Jetspeed-2 sources to answer questions or for hints on
+				how to implement additional functionality in the Portal
+				framework. It is not a bad idea to download them into a
+				separate Eclipse project for ease of access.
+			</p>
+			<subsection name='Goal of the Tutorial'>
+				<p>
+					This tutorial will guide you through the steps to
+					create your own sample portal based on a working
+					portal called
+					<b>JetExpress</b>
+					. The goal of this tutorial is to show you how to
+					create your own custom Jetspeed-2 portal, complete
+					with your own set of portal pages, your company
+					logos and text, your own set of portlet
+					applications, and any special integration required
+					to run your portlets inside Jetspeed-2.
+				</p>
+				<p>
+					We are going to use the following steps to get you
+					started:
+					<ul>
+						<li>
+							We will get the development environment
+							setup.
+						</li>
+						<li>
+							Then, we will build and test the JetExpress
+							as it is comes "out of the box". It is a
+							simple portal with a very basic layout and
+							simple "look and feel". It will support
+							logging in and a few simple portlets.
+						</li>
+						<li>
+							Once it runs, we will show you how to alter
+							the "look and feel" with your own logo and
+							colour scheme.
+						</li>
+						<li>
+							Once you can change the appearance, we will
+							show how to add portlets to a Jetspeed-2
+							Portal. Since Jetspeed-2 complies with the
+							JSR-168 portlet specification, any JSR-168
+							portlet can be configured as part of your
+							application.
+						</li>
+						<li>
+							We will then start 4 new
+							<strong>portlet</strong>
+							projects and show you how to build your own
+							JSR-168 portlets and add them to your
+							customized portal.
+						</li>
+						<li>
+							Once we have implemented some custom
+							portlets we will show how Jetspeed-2 can
+							used to provide WebServices.
+						</li>
+						<li>
+							Finally, we will discuss some of the
+							alternatives for Servlet containers and
+							databases. We will also introduce you to the
+							full Jetspeed-2 documentation, the pre-built
+							portals and the support services available.
+						</li>
+					</ul>
+				</p>
+			</subsection>
+			<subsection name='Prerequisites'>
+				<p>
+					The tutorial requires the following software
+					installed on your system:
+				</p>
+				<ul>
+					<li>
+						<a href="refences/java.html">Java</a>
+						1.4 or higher. Java 5 is recommended.
+					</li>
+					<li>
+						<a href="refences/eclipse.html">Eclipse</a>
+						3.2.2 or higher
+					</li>
+					<li>WTP Eclipse plug-in</li>
+					<li>
+						<a href="refences/ant.html">Ant</a>
+						1.7.1 or higher
+					</li>
+					<li>
+						<a href="06/databases.html">Database</a>
+						- The tutorial uses
+						<a href="http://db.apache.org/derby">Derby</a>
+						which is included the tutorial.
+					</li>
+					<li>
+						The tutorial includes its own built-in
+						<a href="06/servlet.html">servlet engine</a>
+					</li>
+
+				</ul>
+				<p>
+					Of course, you will need an internet connection to
+					use internet-based portlets and download components.
+				</p>
+			</subsection>
+			<p>
+				If you are familiar with Eclipse, Ant and Java you can
+				<a href='01/first-steps.html'>
+					start work on the tutorial.
+				</a>
+				Otherwise, take some time to review the pre-requisite
+				software packages that are new to you.
+			</p>
+			<p>
+				You might also want to take a quick look at the
+				<a href="knowledge.html">skills profile</a>
+				that this tutorial assumes.
+
+			</p>
+		</section>
+	</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/index.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,179 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+	contributor license agreements.  See the NOTICE file distributed with
+	this work for additional information regarding copyright ownership.
+	The ASF licenses this file to You under the Apache License, Version 2.0
+	(the "License"); you may not use this file except in compliance with
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Portlet 101</title>
+		<subtitle>Portal Builder's Knowledge</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Introduction">
+			<p>
+				Every software development tool requires that the person
+				using it has some basic knowledge before they start.
+				Jetspeed is no exception.
+			</p>
+			<p>
+				In a typical project, there is a team of people with
+				different areas of expertise. In that case, there may be
+				some tasks that not everyone on the team would be
+				comfortable in executing. This tutorial is designed to
+				show the different steps in building a portal and we
+				expect that everyone on the team should be able to
+				follow this successfully.
+			</p>
+			<p>
+				In order to successfully build this tutorial, we expect
+				that each person has some basic skills.
+			</p>
+		</section>
+		<section name="Pre-requisite Knowledge">
+			<subsection name="Installing Software">
+
+				<p>
+					We expect that you can download and install software
+					on your own workstation. This implies that you have
+					system administration privileges on your workstation
+					and can follow relatively simple instructions. None
+					of the software required is difficult to install.
+				</p>
+			</subsection>
+			<subsection name='Environment variables' />
+			<p>
+				We expect that you know how to create system-wide
+				environment variables on your workstation.
+			</p>
+			<subsection name='Editing text and XML files'>
+				<p>
+					You should be able to edit text files and XML files.
+				</p>
+			</subsection>
+		</section>
+		<section
+			name='Skills you might need for developing your own portal'>
+			<p>
+				Although programming is not required to complete this
+				tutorial, you will need to be able to program in order
+				to build your own portlets or to add functionality to
+				the basic Jetspeed-2 package. In addition, you will need
+				to understand a bit about the HTTP Request/Response
+				process to understand how a portal communicates with the
+				browser.
+			</p>
+
+			<subsection name='Programming in Java'>
+				<p>
+					Portlets are frequently written in Java and you will
+					need at least a basic knowledge of Java to modify an
+					existing portlet and fairly comprehensive knowledge
+					of Java if you want to design a portlet from
+					scratch.
+				</p>
+				<p>
+					There are many books and on-line resources for
+					learning Java.
+				</p>
+			</subsection>
+			<subsection name='Developing with JSF'>
+				<p>
+					JSF can be used to present data and to control
+					interactions with the user in a portlet. You will
+					need a basic knowledge of JSF to modify an existing
+					portlet and fairly comprehensive knowledge of JSF if
+					you are designing a portlet from scratch.
+				</p>
+				<p>
+					There are a few books and on-line resources for
+					learning JSF.
+				</p>
+			</subsection>
+			<subsection name='Developing with Velocity'>
+				<p>
+					Velocity is used extensively in Jetspeed-2 and if
+					you need to make changes to the functionality of
+					Jetspeed-2, you will need to be able to code in
+					Velocity. You will need a basic knowledge of
+					Velocity to modify an existing portlet and fairly
+					comprehensive knowledge of Velocity if you are
+					designing a portlet from scratch.
+				</p>
+				<p>
+					Velocity is a fairly simple language to learn and
+					there are very few books and on-line resources for
+					learning Velocity.
+				</p>
+			</subsection>
+			<subsection name='Developing with JSP and Taglib'>
+				<p>
+					JSP is used extensively in Jetspeed-2 and there is
+					an entire module in the tutorial that talks about
+					JSP. You will need a basic knowledge of JSP to
+					modify an existing portlet that uses JSP and fairly
+					comprehensive knowledge of JSP if you are designing
+					a portlet from scratch.
+				</p>
+				<p>
+					There are a few books and on-line resources for
+					learning JSP.
+				</p>
+			</subsection>
+
+		</section>
+		<section name="Specialist Knowledge">
+			<p>
+				In the tutorial, we have provided simplied tools for
+				data persistence and for hosting the Jetspeed Portal.
+				However, most applications require some very specialized
+				knowledge that not everyone is required to know. If you
+				are going to build a real application with Jetspeed-2
+				you will need someone in each of the following areas of
+				expertise
+			</p>
+			<subsection name='Database Technology'>
+				<p>
+					This includes both the programming and system
+					administration aspects of handling data persistence.
+					Jetspeed can handle most relational database systems
+					as well as higher level tools such as Hibernate.
+				</p>
+			</subsection>
+			<subsection name='Servlet Engines'>
+				<p>
+					This includes both the configuring and system
+					administration of a serlet engine that can deliver
+					Jetspeed-2 functionality over the Internet. Jetspeed
+					can run under a number of serlet engines and you
+					will need someone who knows how to configure the
+					servlet engine and how to deploy a web application
+					under it.
+				</p>
+			</subsection>
+						<p>
+				<a href='index.html'>Previous</a>
+				<a href='01/first-steps.html'>Next</a>
+			</p>
+			
+		</section>
+	</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/knowledge.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/navigation.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/navigation.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/navigation.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/navigation.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one or more
+    contributor license agreements.  See the NOTICE file distributed with
+    this work for additional information regarding copyright ownership.
+    The ASF licenses this file to You under the Apache License, Version 2.0
+    (the "License"); you may not use this file except in compliance with
+    the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+-->
+<project>
+    <body>
+        <links>
+        	<item name="Jetspeed-1" href="http://portals.apache.org/jetspeed-1" target="_nw"/>
+        	<item name="Jetspeed-2" href="http://portals.apache.org/jetspeed-2" target="_nw"/>
+        	<item name="Bridges" href="http://portals.apache.org/bridges" target="_nw"/>
+        </links>
+        <menu name="Tutorial Overview">
+            <item name="Welcome" href="index.html" />        
+        	<item name="Build Commands" href="build-commands.html" />
+        	<item name="Project Directory Overview" href="project-directory.html" />        	
+        </menu>        
+        <menu name="01. Custom Portal Generation">
+        	<item name="Maven First Steps" href="01/first-steps.html" />                    
+            <item name="Generating a Jetspeed Portal" href="01/genapp.html" />
+        	<item name="Build and Deploy Custom Portal" href="01/build-it.html" />            
+        	<item name="Run the Custom Portal" href="01/run-it.html" />            
+        </menu>
+        <menu name="02. Customizing Your Portal Design">
+            <item name="Decorators and Themes" href="02/customizing-overview.html" />        
+            <item name="Page Decoration" href="02/page-decoration.html" />
+            <item name="Portlet Decoration" href="02/portlet-decoration.html" />            
+            <item name="Desktop Themes" href="02/desktop-theme.html" />            
+            <item name="Changing the Default Page" href="02/default-page.html" />            
+            <item name="Deploying your Customizations" href="02/deploy-custom.html"/>            
+        </menu>
+        <menu name="03. Portlet Application Configuration">
+            <item name="Generating a Portlet Application" href="03/portlet-app.html" />
+            <item name="Building and Deploying" href="03/built-it.html" />            
+            <item name="Configuring Portal Pages" href="03/pages.html" />                                    
+        </menu>
+        <menu name="04. Portlet Development 101">
+            <item name="Overview" href="04/overview.html" />
+            <item name="Eclipse" href="04/eclipse.html" />            
+            <item name="Hello World" href="04/hello.html" />                        
+            <item name="Adding a Page" href="04/tutorial-psml.html" />             
+            <item name="JSP and Portlet API Taglib" href="04/taglib.html" />                         
+        </menu>
+        <menu name="05. Jetspeed Services">
+            <item name="Services Tutorial Portlet" href="05/jetspeed-service.html" />
+        </menu>
+    </body>
+</project>

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/navigation.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,101 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Project Generation</title>
+		<subtitle>
+			Project Generation Commands for Maven-2 and Jetspeed
+		</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+
+		</authors>
+	</properties>
+	<body>
+		<section
+			name="Project Generation Commands for Maven-2 and Jetspeed">
+			<p>
+				We support several kinds of project generation commands
+				in the build. These commands are based on
+				<i>Maven Archetypes</i>
+				. The project generation commands create a template for
+				building certain types of Jetspeed projects. The most
+				common archetype is the
+				<i>portal-archetype</i>
+				, which creates a new Jetspeed Custom Portal. The
+				complete list of project generation commands are:
+			</p>
+			<div>
+				<table>
+					<tr>
+						<td>
+							<strong>
+								<tt>archetypeArtifactId</tt>
+							</strong>
+						</td>
+						<td>
+							<strong>
+								<tt>explanation</tt>
+							</strong>
+						</td>
+					</tr>
+					<tr>
+						<td>portal-archetype</td>
+						<td>
+							Generate a Maven project for a new custom
+							Jetspeed Portal Application
+						</td>
+					</tr>
+					<tr>
+						<td>application-archetype</td>
+						<td>
+							Generate a Maven project for a new JSR 168
+							Portlet Application
+						</td>
+					</tr>
+					<tr>
+						<td>component-archetype</td>
+						<td>
+							Generate a Maven project for a new general
+							Java component
+						</td>
+					</tr>
+					<tr>
+						<td>shared-component-archetype</td>
+						<td>
+							Generate a Maven project for a new shared
+							Jetspeed component
+						</td>
+					</tr>
+					<tr>
+						<td>portal-component-archetype</td>
+						<td>
+							Generate a Maven project for a new Jetspeed
+							component (installed in Jetspeed core)
+						</td>
+					</tr>
+				</table>
+			</div>
+		</section>
+	</body>
+</document>
+

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/project-generation.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant.xml?rev=747211&r1=747210&r2=747211&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant.xml Mon Feb 23 23:32:43 2009
@@ -1,51 +1,51 @@
-<?xml version="1.0"?>
-<!--
+<?xml version="1.0"?>
+<!--
 	Licensed to the Apache Software Foundation (ASF) under one or more
 	contributor license agreements.  See the NOTICE file distributed with
 	this work for additional information regarding copyright ownership.
 	The ASF licenses this file to You under the Apache License, Version 2.0
 	(the "License"); you may not use this file except in compliance with
-	the License.  You may obtain a copy of the License at
-	
-	http://www.apache.org/licenses/LICENSE-2.0
-	
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
--->
-<document>
-	<properties>
-		<title>Portlet 101</title>
-		<subtitle>Ant</subtitle>
-		<authors>
-			<person name="David Sean Taylor" email="taylor@apache.org" />
-			<person name="David Dyer"
-				email="ddyer@artifact-software.com" />
-			<person name="Ron Wheeler"
-				email="rwheeler@artifact-software.com" />
-		</authors>
-	</properties>
-	<body>
-		<section name="Ant Overview">
-			<p>
-				<a href="ant.apache.org">Ant</a>
-				is a powerful platform independent scripting package.
-
-			</p>
-		</section>
-		<section name="installing Ant">
-			<subsection name='Installation'>
-				<p>You can download Ant from <a href="ant.apache.org">the Ant web site</a>
-				and install it by following their instructions.</p>
-			</subsection>
-			<subsection name='Environment variables' />
-			<p>Create an environmental variable called ANT_HOME and add ANT_HOME\bin to your PATH.</p>
-			<subsection />
-			<subsection name='Testing Ant'>
-				<p>If get the correct version number displayed when you type ant -version at a command prompt, you have a working ant package.</p>
-			</subsection>
-		</section>
-	</body>
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Portlet 101</title>
+		<subtitle>Ant</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Ant Overview">
+			<p>
+				<a href="ant.apache.org">Ant</a>
+				is a powerful platform independent scripting package.
+
+			</p>
+		</section>
+		<section name="installing Ant">
+			<subsection name='Installation'>
+				<p>You can download Ant from <a href="ant.apache.org">the Ant web site</a>
+				and install it by following their instructions.</p>
+			</subsection>
+			<subsection name='Environment variables' />
+			<p>Create an environmental variable called ANT_HOME and add ANT_HOME\bin to your PATH.</p>
+			<subsection />
+			<subsection name='Testing Ant'>
+				<p>If get the correct version number displayed when you type ant -version at a command prompt, you have a working ant package.</p>
+			</subsection>
+		</section>
+	</body>
 </document>
\ No newline at end of file

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,160 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Build Commands</title>
+		<subtitle>Build Commands for Ant and Jetspeed</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Ant Target for Building and Deploying Jetspeed-2">
+			<subsection name="Major Targets">
+				<p>
+					Here is a quick summary of the most frequently used Ant
+					targets available in the JetExpress build.xml file.
+				</p>
+				<div>
+					<table>
+						<tr>
+							<td>
+								<strong>
+									<tt>targets</tt>
+								</strong>
+							</td>
+							<td>
+								<strong>
+									<tt>explanation</tt>
+								</strong>
+							</td>
+						</tr>
+						<tr>
+							<td>
+								<strong>
+									<tt>create.installer</tt>
+								</strong>
+							</td>
+							<td>
+								Builds the entire jetexpress portal and
+								creates a Jetspeed Custom Installer.
+							</td>
+						</tr>
+						<tr>
+							<td>
+								<strong>
+									<tt>delta</tt>
+								</strong>
+							</td>
+							<td>
+								The default target. Deploys any
+								modifications to the source tree to an
+								existing, deployed portal. Note: you
+								must first build and install the portal
+								before running this goal using the
+								create.installer goal.
+							</td>
+						</tr>
+						<tr>
+							<td>
+								<strong>
+									<tt>deploy.decorations</tt>
+								</strong>
+							</td>
+							<td>
+								Deploys any modifications to decorations
+								to the live portal.
+							</td>
+						</tr>
+						<tr>
+							<td>
+								<strong>
+									<tt>deploy.pages</tt>
+								</strong>
+							</td>
+							<td>
+								Deploys any modifications to PSML pages
+								to the live portal.
+							</td>
+						</tr>
+						<tr>
+							<td>
+								<strong>
+									<tt>deploy.webapps</tt>
+								</strong>
+							</td>
+							<td>
+								Deploys all webapps to the live portal.
+							</td>
+						</tr>
+					</table>
+				</div>
+			</subsection>
+			<subsection name="All Targets">
+				<p>
+					You can see all of the targets available in the
+					build.xml file by selecting the build.xml file in
+					the Navigator view and selecting the Outline view
+					from the "Window" menu.</p>
+					<p>
+					<img src="../images/AntTargetOutline.png" />
+				</p>
+				<p>
+				Ant build files are a bit intimidating but are pretty easy to understand if they are well structured and you take the time to look at definitions carefully.
+				Once you understand the existing tasks, you can add your own to automate tasks that are particular to your workflow.
+				</p>
+			</subsection>
+		</section>
+		<section name="Build Properties">
+			<p>
+				It is a good practice in Ant to separate the task
+				definitions from the specifics of your installation. Ant
+				does this through a file called build.properties.
+				Definitions put into this file are available for use in
+				the build.xml file.
+			</p>
+			<p>
+				This makes is easy to distribute an Ant build that is
+				easy to customize. The person receiving the Ant build
+				configuration can usually just modify the
+				build.properties file to make the build work in their
+				enviroment without having to look through each Ant goal
+				to see where files are expected or where they are going
+				to be put by the Ant Goal
+			</p>
+			<source>
+				<![CDATA[# general properties
+portal.name = jetexpress
+
+# installation properties
+installer.src.jar = /JetspeedTraining/installers/jetspeed-2.1.1-dev-installer.jar
+installer.target = ./target
+installer.dst.jar = jetexpress-installer.jar
+
+# development deployment properties
+app.server.home = /JetspeedTraining/servers/tomcat-express
+]]>
+			</source>
+		</section>
+	</body>
+</document>
+

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/ant_targets.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/eclipse.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/eclipse.xml?rev=747211&r1=747210&r2=747211&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/eclipse.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/eclipse.xml Mon Feb 23 23:32:43 2009
@@ -1,91 +1,91 @@
-<?xml version="1.0"?>
-<!--
+<?xml version="1.0"?>
+<!--
 	Licensed to the Apache Software Foundation (ASF) under one or more
 	contributor license agreements.  See the NOTICE file distributed with
 	this work for additional information regarding copyright ownership.
 	The ASF licenses this file to You under the Apache License, Version 2.0
 	(the "License"); you may not use this file except in compliance with
-	the License.  You may obtain a copy of the License at
-	
-	http://www.apache.org/licenses/LICENSE-2.0
-	
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
--->
-<document>
-	<properties>
-		<title>Portlet 101</title>
-		<subtitle>Eclipse</subtitle>
-		<authors>
-			<person name="David Sean Taylor" email="taylor@apache.org" />
-			<person name="David Dyer"
-				email="ddyer@artifact-software.com" />
-			<person name="Ron Wheeler"
-				email="rwheeler@artifact-software.com" />
-		</authors>
-	</properties>
-	<body>
-		<section name="Eclipse Overview">
-			<p>
-				<a href="www.eclipse.org">Eclipse</a>
-				is an free IDE originally donated to the community by
-				IBM. It has become the most dominant IDE for developing
-				Java applications as well as applications in other
-				laguages. Sun and Microsoft have alternative IDEs but
-				Eclipse has attracted the the largest following.
-			</p>
-		</section>
-		<section name="Installing Eclipse">
-			<subsection name='Installation'>
-				<p>
-					Install the
-					<a href="http://www.eclipse.org/callisto/">
-						Callisto version of Eclipse
-					</a>
-					for Java development. It contains all of the
-					plug-ins for Java development including Web Tools
-					Platform which we need.
-				</p>
-			</subsection>
-
-			<subsection name='Environment Variables'>
-				<p>
-					Eclipse does not have any environment variables of
-					its own but does want to find "JAVA_HOME" which
-					should point to your version of
-					<a href="java.html">Java.</a>
-				</p>
-			</subsection>
-
-			<subsection name='Testing Eclipse'>
-				<p>
-					If you start Eclipse and it runs, you have a good
-					installation. If not, refer to the
-					<a href="www.eclipse.org">Eclipse Site</a>
-					for help.
-				</p>
-			</subsection>
-
-
-			<subsection name='Eclipse Plugins'>
-				<p>
-					The Callisto version of Eclipse should contain the
-					WTP(Web Tools Platform) plug-ins. They show up in
-					the list of plug-ins as individual items:
-					<ul>
-						<li>Web Standard Tools (WST)</li>
-						<li>J2EE Standard Tools (JST)</li>
-						<li>AJAX Toolkit Framework (ATF)</li>
-						<li>Dali JPA Tools</li>
-						<li>JavaServer Faces Tools (JSF)</li>
-					</ul>
-				</p>
-				<p>If you are missing the any of the Eclipse Web Tools platform compents, you can download them from the <a href="http://www.eclipse.org/webtools/main.php">Eclipse site</a></p>
-			</subsection>
-
-		</section>
-	</body>
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Portlet 101</title>
+		<subtitle>Eclipse</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Eclipse Overview">
+			<p>
+				<a href="www.eclipse.org">Eclipse</a>
+				is an free IDE originally donated to the community by
+				IBM. It has become the most dominant IDE for developing
+				Java applications as well as applications in other
+				laguages. Sun and Microsoft have alternative IDEs but
+				Eclipse has attracted the the largest following.
+			</p>
+		</section>
+		<section name="Installing Eclipse">
+			<subsection name='Installation'>
+				<p>
+					Install the
+					<a href="http://www.eclipse.org/callisto/">
+						Callisto version of Eclipse
+					</a>
+					for Java development. It contains all of the
+					plug-ins for Java development including Web Tools
+					Platform which we need.
+				</p>
+			</subsection>
+
+			<subsection name='Environment Variables'>
+				<p>
+					Eclipse does not have any environment variables of
+					its own but does want to find "JAVA_HOME" which
+					should point to your version of
+					<a href="java.html">Java.</a>
+				</p>
+			</subsection>
+
+			<subsection name='Testing Eclipse'>
+				<p>
+					If you start Eclipse and it runs, you have a good
+					installation. If not, refer to the
+					<a href="www.eclipse.org">Eclipse Site</a>
+					for help.
+				</p>
+			</subsection>
+
+
+			<subsection name='Eclipse Plugins'>
+				<p>
+					The Callisto version of Eclipse should contain the
+					WTP(Web Tools Platform) plug-ins. They show up in
+					the list of plug-ins as individual items:
+					<ul>
+						<li>Web Standard Tools (WST)</li>
+						<li>J2EE Standard Tools (JST)</li>
+						<li>AJAX Toolkit Framework (ATF)</li>
+						<li>Dali JPA Tools</li>
+						<li>JavaServer Faces Tools (JSF)</li>
+					</ul>
+				</p>
+				<p>If you are missing the any of the Eclipse Web Tools platform compents, you can download them from the <a href="http://www.eclipse.org/webtools/main.php">Eclipse site</a></p>
+			</subsection>
+
+		</section>
+	</body>
 </document>
\ No newline at end of file

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,60 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+	contributor license agreements.  See the NOTICE file distributed with
+	this work for additional information regarding copyright ownership.
+	The ASF licenses this file to You under the Apache License, Version 2.0
+	(the "License"); you may not use this file except in compliance with
+	the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Portlet 101</title>
+		<subtitle>Java</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+		</authors>
+	</properties>
+	<body>
+		<section name="Java Overview">
+			<p>
+You do not have to be a Java programmer to install and configure a Jetspeed portal but you will need to have a <a href="www.java.sum.com">Java SDK(Software Development Kit)</a> installed.
+This is not the same as the Java Run-time Library.
+			</p>
+		</section>
+		<section name="Installing Java">
+			<subsection name='Installation'>
+				<p>
+			Download <a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">Java version 5</a>(not version 6).
+	Follow the instructions and choose the default installation configuration.
+				</p>
+			</subsection>
+
+			<subsection name='Environment Variables'>
+				<p> 
+				You will need to set the JAVA_HOME environment variable to the root of the Java installation.
+				</p>
+				<p>In addition, you will need to add JAVA_HOME/bin or JAVA_HOME\bin (for Windows) to your PATH</p>
+			</subsection>
+
+			<subsection name='Testing Java'>
+				<p>
+Open a comand window and type "java -version". If the information typed out matches the version of Java that you installed, then you probably have a working Java SDK.
+If not check your installation and Environment variables.</p>
+			</subsection>
+
+		</section>
+	</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/java.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,125 @@
+s<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Project Directory</title>
+		<subtitle>
+			Overview of the Custom Project Directory Structure
+		</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+
+		</authors>
+	</properties>
+	<body>
+		<section
+			name="Overview of the Custom Portal Directory Structure">
+			<p>
+				The directory structure for developing a custom Jetspeed
+				portal is designed to be similar to the directory
+				structure of the Jetspeed-2 core source tree.
+			</p>
+			<p>
+				Note that this directory structure only covers the
+				custom portal itself. Each portlet is a separate project
+				with its own directory structure.
+			</p>
+			<p>
+				Here is an overview of directories (directories are
+				relative to the custom portal project root):
+			</p>
+			<div>
+				<table>
+					<tr>
+						<td>
+							<strong>
+								<tt>directory</tt>
+							</strong>
+						</td>
+						<td>
+							<strong>
+								<tt>explanation</tt>
+							</strong>
+						</td>
+					</tr>
+					<tr>
+						<td>dist</td>
+						<td>
+							Distributable files(wars, jars) created
+							during the build, such as installers or web
+							applications
+						</td>
+					</tr>
+					<tr>
+						<td>src/installer</td>
+						<td>
+							Customized installation script for the
+							Jetexpress installer
+						</td>
+					</tr>
+					<tr>
+						<td>src/sql</td>
+						<td>
+							Jetspeed XML seed data to provide initial
+							test data for the portal(user, roles,
+							profiling rules...)
+						</td>
+					</tr>
+					<tr>
+						<td>src/webapp/decorations/layout</td>
+						<td>
+							Page decorations (skins) to brand the custom
+							portal (CSS, images, HTML)
+						</td>
+					</tr>
+					<tr>
+						<td>src/webapp/decorations/portlet</td>
+						<td>
+							Page decorations (skins) to brand the custom
+							portal (CSS, images, HTML)
+						</td>
+					</tr>
+					<tr>
+						<td>src/webapp/WEB-INF/pages</td>
+						<td>
+							The collection of folders and pages that
+							make up the Portal Site for the Jetexpress
+							portal
+						</td>
+					</tr>
+					<tr>
+						<td>jetexpress/target</td>
+						<td>Temporary build area used by Ant</td>
+					</tr>
+					<tr>
+						<td>jetexpress/webapps</td>
+						<td>
+							<div class="todo">Place the web application here that are
+							required to run the jetexpress portal</div>
+							
+						</td>
+					</tr>
+				</table>
+			</div>
+		</section>
+	</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/project_directory.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml?rev=747211&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml Mon Feb 23 23:32:43 2009
@@ -0,0 +1,102 @@
+<?xml version="1.0"?>
+<!--
+	Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing, software
+	distributed under the License is distributed on an "AS IS" BASIS,
+	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+	See the License for the specific language governing permissions and
+	limitations under the License.
+-->
+<document>
+	<properties>
+		<title>Tutorial Distribution Kit</title>
+		<subtitle>
+			Overview of the Structure of the JetExpress distribution
+		</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+			<person name="David Dyer"
+				email="ddyer@artifact-software.com" />
+			<person name="Ron Wheeler"
+				email="rwheeler@artifact-software.com" />
+
+		</authors>
+	</properties>
+	<body>
+		<section name="Overview of the Tutorial Directory Structure">
+			<p>
+				The Jetspeed Ant Tutorial is provided as zip files and
+				downloaded from the Apache Portals website. There are two
+				projects available for download: the source code for a Custom Jetspeed
+				Portal named "jetexpress" in the <b>jetexpress.zip</b> distribution, and an example portlet application named
+				"express-demo" found in the	<b>express-demo.zip</b>	directory.
+			</p>			
+			<p>
+				Note that we make a clean separation between the portal
+				(Jetspeed) integration code, and the portlet
+				application. Additionally, you will be required to download an official release of Jetspeed 2.1.2 in basic installer format.
+				The Jetspeed installer is the foundation of a custom installer that we will create in this tutorial.
+			</p>
+			<div>
+				<table>
+					<tr>
+						<td>
+							<strong>
+								<tt>resource</tt>
+							</strong>
+						</td>
+						<td>
+							<strong>
+								<tt>url</tt>
+							</strong>
+						</td>
+						<td>
+							<strong>
+								<tt>explanation</tt>
+							</strong>
+						</td>
+					</tr>
+					<tr>
+						<td>Express Demo PA</td>
+						<td><a href='http://people.apache.org/~taylor/tutorial/express-demo.zip'>express-demo.zip</a></td>
+						<td>
+							The Express Demo Portlet Application. This
+							application can be built with Eclipse WTP
+							(Web Tools Platform) or Ant.
+						</td>
+					</tr>
+					<tr>
+						<td>Jetexpress Custom Portal</td>
+						<td><a href='http://people.apache.org/~taylor/tutorial/jetexpress.zip'>jetexpress.zip</a></td>						
+						<td>The Jetspeed Custom Portal Ant Project. This project can also be editing in Eclipse and built with the Ant plugin for Eclipse.</td>
+					</tr>
+					<tr>
+						<td>Jetspeed 2.1.2 Installer</td>
+						<td><a href='http://portals.apache.org/jetspeed-2/download.html'>Jetspeed 2.1.2 Installer</a></td>						
+						<td>
+						   The Jetspeed 2.1.2 installer. The tutorial custom portal is based on the 2.1.2 version of Jetspeed.
+						   The tutorial covers the steps of merging a released version of Jetspeed with customizations.
+						</td>
+					</tr>
+					<tr>
+						<td>Jetspeed Shared Library</td>
+						<td><a href='http://people.apache.org/~taylor/tutorial/jetspeed-library.zip'>jetspeed-library.zip</a></td>						
+						<td>The Express Demo Eclipse project requires several references to Java libraries such as the Java Portlet API and Jetspeed API to compile. 
+						    Download this zip, unzip the jars into a directory, and then setup a new Eclipse Classpath variable named <b>JETSPEED_LIBRARY</b> to point at this directory
+						    (Window-&gt;Preferences-&gt;Java-&gt;Build Path-&gt;Classpath Variables-&gt;New...)
+						     .</td>
+					</tr>					
+				</table>
+			</div>
+		</section>
+
+	</body>
+</document>
\ No newline at end of file

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/references/tutorial_distribution.xml
------------------------------------------------------------------------------
    svn:keywords = Id



---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org