portals-jetspeed-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From tay...@apache.org
Subject svn commit: r747213 [1/2] - in /portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2: ./ 01/ 02/ 03/ 04/ 05/ images/
Date Mon, 23 Feb 2009 23:33:33 GMT
Author: taylor
Date: Mon Feb 23 23:33:30 2009
New Revision: 747213

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

Added:
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/genapp.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/customizing-overview.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/desktop-theme.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/page-decoration.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/eclipse.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/overview.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/tutorial-psml.xml   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/eclipse-classpath.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/eclipse-classpath2.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/eclipse-classpath3.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/import-project.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/import-project2.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/jetexpress-desktop.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/jetexpress-portal.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/new-home.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/site.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/svn2.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/svn3.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/theme.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/tigris-page.png   (with props)
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/images/tigris-portlet.png   (with props)
Modified:
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/first-steps.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/default-page.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/deploy-custom.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/portlet-decoration.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/pages.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/taglib.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/05/jetspeed-service.xml
    portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/project-directory.xml

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,67 @@
+ <?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 the Custom Portal</title>
+    <subtitle>Building a Custom Jetspeed Portal</subtitle>
+	<authors>
+		<person name="David Sean Taylor" email="taylor@apache.org" />
+	</authors>
+  </properties>
+  <body>
+    <section name="Building and Deploying a Custom Jetspeed Portal">
+      <p>      
+       Now that you have generated a custom portal named <b>jetexpress</b>, we are ready to build the portal.
+       We are going to build the portal from the command line:
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress  	 
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress  	 
+
+mvn -P tomcat,min
+     ]]>
+	</source> 
+      <p>
+      <i>Please take note that there is no space between the comma and the word <b>min</b></i>
+      </p>
+      <p>
+      We are building a <b>min</b> (minimal) deployment. The Min deployment only creates a Jetspeed core portal and a Jetspeed Admin portlet application (j2-admin).
+      When the build process completes, you should see the message <b>BUILD SUCCESSFUL</b> at the end of a large amount of build logging information      
+      The portal is built into a temp directory named <i>target</i> found directory under your <i>jetexpress</i> project directory.
+      As well as building, the <i>tomcat,min</i> goals also:
+      </p>
+      <ul>
+       <li>deploys Jetspeed to the Tomcat application server. If you are following the training material,
+      the Tomcat directory is located under <i>/JetspeedTraining/tomcat-express/</i></li>
+      <li>creates the Jetspeed core schema tables in the Derby database</li>
+      <li>populates the database with a minimal set of portal information, including default roles, groups, profiles, and administrative users</li>
+      </ul>
+      <p>
+      Now that we've built and deployed the portal, lets start up the application server...
+      </p>	
+	  <p>
+	    <a href='genapp.html'>Previous</a> <a href='run-it.html'>Next</a>
+	  </p>            
+    </section>
+  </body>
+</document>
+

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/build-it.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/first-steps.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/first-steps.xml?rev=747213&r1=747212&r2=747213&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/first-steps.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/first-steps.xml Mon Feb 23 23:33:30 2009
@@ -1,102 +1,102 @@
-<?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>Maven First Steps</title>
-    <subtitle>Custom Project First Steps</subtitle>
-	<authors>
-		<person name="David Sean Taylor" email="taylor@apache.org" />
-	</authors>
-  </properties>
-  <body>
-    <section name="First Steps with Maven-2">
-    <p>
-    Minimal configuration is required to get started with your Jetspeed custom build and Maven-2.
-    </p>
-    <subsection name='Copying in the settings.xml'>
-      <p>      
-       The first step to building with Maven-2 is to setup your <b>settings.xml</b>.
-       These settings hold all the information necessary to build with Maven-2 and Jetspeed.             
-      </p>
-      <p>There is a <i>settings.xml.jetexpress</i> file in the <i>/JetspeedTraining/resources/maven/</i> directory.
-         Copy this file into your <i>Maven Home</i> directory. The Maven home directory
-         is located in a directory named <b>.m2</b> found under your <i>User Home</i> directory.
-         So for example that would be <i>~/.m2/</i> on Linux, or <i>"%USERPROFILE%\.m2\"</i> on Windows.
-      </p>
-	  <p>
-	  <b>Linux: paste into Command Line:</b>
-	  <input size ='80' value='mkdir ~/.m2'/>
-	  <input id='cl1' size="80" value="cp resources/maven/settings.xml.jetexpress ~/.m2/settings.xml"/>	  
-	  </p>
-	  <p>
-	  <b>Windows: paste into Command Line:</b>
-	  <input size="80" value='mkdir "%USERPROFILE%\.m2"'/>
-	  <input id='cl1' size="80" value='copy resources\maven\settings.xml.jetexpress "%USERPROFILE%\.m2\settings.xml"'/>	  	  	  
-	  </p>	  
-	</subsection>
-    <subsection name='Editing the settings.xml'>	
-      <p>
-      The settings file is primarily for configuring your application server and database.
-      The settings are preconfigured for an embedded Derby database, so more changes are required 
-      if another database solution is to be used, covered later in this tutorial.      
-      </p>
-	  <p>	 
-	  Edit the <i>~/.m2/settings.xml</i> file. 
-	  </p>
-	</subsection>
-    <subsection name='Change the Jetspeed Server (Tomcat) Location'>		  
-    <p>
-	  For the purpose of the training, lets all use the same Tomcat home, point it to the <i>/JetspeedTraining/tomcat-express</i> directory.
-	  </p>
-	 <source>
-	 <![CDATA[		
-	  <org.apache.jetspeed.server.home>c:/JetspeedTraining/tomcat-express</org.apache.jetspeed.server.home>
-     ]]>
-	</source> 
-	</subsection>
-    <subsection name='Change the Derby Database location'>		  	
-	  <p>	 
-	  Next, lets change the location of our Derby database to the <i>/JetspeedTraining/database/jetexpress</i> directory.
-	  </p>
-	 <source>
-	 <![CDATA[		
-     <org.apache.jetspeed.production.database.url>jdbc:derby:/JetspeedTraining/database/jetexpress</org.apache.jetspeed.production.database.url>	 
-     ]]>
-	</source> 	
-	</subsection>
-    <subsection name='Change the Repository Location'>		
-    <p>  
-        Change the Maven local repository location by modifying the <i>&lt;localRepository&gt;</i>
-	    element in the settings.xml file. If you are using the training material, we have pre-configured
-	    a Maven-2 repository /JetspeedTraining/maven/repository. Lets configure Maven to point there,
-	    edit the <i>settings.xml</i>:	    
-     </p>
-	 <source>
-	 <![CDATA[		
-	  <localRepository>c:/JetspeedTraining/maven/repository/</localRepository>
-     ]]>
-	</source> 
-	  <p>Go on and save that file.</p>     
-	</subsection>
-	  <p>
-	    <a href='genapp.html'>Next</a>
-	  </p>            	  
-    </section>        
-  </body>
-</document>
-
+  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>Maven First Steps</title>
+    <subtitle>Custom Project First Steps</subtitle>
+	<authors>
+		<person name="David Sean Taylor" email="taylor@apache.org" />
+	</authors>
+  </properties>
+  <body>
+    <section name="First Steps with Maven-2">
+    <p>
+    Minimal configuration is required to get started with your Jetspeed custom build and Maven-2.
+    </p>
+    <subsection name='Copying in the settings.xml'>
+      <p>      
+       The first step to building with Maven-2 is to setup your <b>settings.xml</b>.
+       These settings hold all the information necessary to build with Maven-2 and Jetspeed.             
+      </p>
+      <p>There is a <i>settings.xml.jetexpress</i> file in the <i>/JetspeedTraining/resources/maven/</i> directory.
+         Copy this file into your <i>Maven Home</i> directory. The Maven home directory
+         is located in a directory named <b>.m2</b> found under your <i>User Home</i> directory.
+         So for example that would be <i>~/.m2/</i> on Linux, or <i>"%USERPROFILE%\.m2\"</i> on Windows.
+      </p>
+	  <p>
+	  <b>Linux: paste into Command Line:</b>
+	  <input size ='80' value='mkdir ~/.m2'/>
+	  <input id='cl1' size="80" value="cp resources/maven/settings.xml.jetexpress ~/.m2/settings.xml"/>	  
+	  </p>
+	  <p>
+	  <b>Windows: paste into Command Line:</b>
+	  <input size="80" value='mkdir "%USERPROFILE%\.m2"'/>
+	  <input id='cl1' size="80" value='copy resources\maven\settings.xml.jetexpress "%USERPROFILE%\.m2\settings.xml"'/>	  	  	  
+	  </p>	  
+	</subsection>
+    <subsection name='Editing the settings.xml'>	
+      <p>
+      The settings file is primarily for configuring your application server and database.
+      The settings are preconfigured for an embedded Derby database, so more changes are required 
+      if another database solution is to be used, covered later in this tutorial.      
+      </p>
+	  <p>	 
+	  Edit the <i>~/.m2/settings.xml</i> file. 
+	  </p>
+	</subsection>
+    <subsection name='Change the Jetspeed Server (Tomcat) Location'>		  
+    <p>
+	  For the purpose of the training, lets all use the same Tomcat home, point it to the <i>/JetspeedTraining/tomcat-express</i> directory.
+	  </p>
+	 <source>
+	 <![CDATA[		
+	  <org.apache.jetspeed.server.home>c:/JetspeedTraining/tomcat-express</org.apache.jetspeed.server.home>
+     ]]>
+	</source> 
+	</subsection>
+    <subsection name='Change the Derby Database location'>		  	
+	  <p>	 
+	  Next, lets change the location of our Derby database to the <i>/JetspeedTraining/database/jetexpress</i> directory.
+	  </p>
+	 <source>
+	 <![CDATA[		
+     <org.apache.jetspeed.production.database.url>jdbc:derby:/JetspeedTraining/database/jetexpress</org.apache.jetspeed.production.database.url>	 
+     ]]>
+	</source> 	
+	</subsection>
+    <subsection name='Change the Repository Location'>		
+    <p>  
+        Change the Maven local repository location by modifying the <i>&lt;localRepository&gt;</i>
+	    element in the settings.xml file. If you are using the training material, we have pre-configured
+	    a Maven-2 repository /JetspeedTraining/maven/repository. Lets configure Maven to point there,
+	    edit the <i>settings.xml</i>:	    
+     </p>
+	 <source>
+	 <![CDATA[		
+	  <localRepository>c:/JetspeedTraining/maven/repository/</localRepository>
+     ]]>
+	</source> 
+	  <p>Go on and save that file.</p>     
+	</subsection>
+	  <p>
+	    <a href='genapp.html'>Next</a>
+	  </p>            	  
+    </section>        
+  </body>
+</document>
+

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/genapp.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/genapp.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/genapp.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/01/genapp.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,62 @@
+<?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>Generating a Jetspeed Portal</title>
+    <subtitle>Using Maven to Generate a Custom Jetspeed Portal</subtitle>
+	<authors>
+		<person name="David Sean Taylor" email="taylor@apache.org" />
+	</authors>
+  </properties>
+  <body>
+    <section name="Generating a Jetspeed Portal">
+      <p>      
+       To create a new custom portal named <b>jetexpress</b>, enter the following commands:
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace
+
+# Windows
+cd \JetspeedTraining\workspace
+
+mvn archetype:create -DarchetypeGroupId=org.apache.portals.jetspeed-2 
+                     -DarchetypeArtifactId=portal-archetype 
+                     -DarchetypeVersion=2.1 
+                     -DgroupId=org.apache.portals.tutorials
+                     -DartifactId=jetexpress
+                     -Dversion=1.0
+     ]]>
+	</source> 
+	  <p>
+	  <b>Paste into Command Line:</b>
+	  <input id='genapp' size="80" value="mvn archetype:create -DarchetypeGroupId=org.apache.portals.jetspeed-2 -DarchetypeArtifactId=portal-archetype -DarchetypeVersion=2.1 -DgroupId=org.apache.portals.tutorials -DartifactId=jetexpress -Dversion=1.0"/>	  
+	  </p>
+      <p>      
+       A directory named <b>jetexpress</b> under <i>/JetspeedTraining/workspace</i> should have been created.
+       Notice that <b>jetexpress</b> will be the name of your portal, not <b>jetspeed</b>. The idea is that you 
+       can create a customized portal based upon Jetspeed, but with a different name, customized to meet your organization requirements.
+      </p>	
+	  <p>
+	    <a href='first-steps.html'>Previous</a> <a href='build-it.html'>Next</a>
+	  </p>            
+    </section>
+  </body>
+</document>
+

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

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

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/customizing-overview.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/customizing-overview.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/customizing-overview.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/customizing-overview.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,61 @@
+<?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>Customization</title>
+		<subtitle>Decorator and Theme Customization</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Decorator and Theme Customization">
+      <p> 
+      Now that we have created our custom Jetspeed project, lets start customizing the portal design.
+      The portal design, or skins, are known in Jetspeed as <i>decorators and themes</i>.
+      With decorators and themes, you can customize the portal experience to the branding of your 
+      organization. In this tutorial, we will simply change a few images, CSS styles and colors to get 
+      you on your way.
+      </p>
+      <p>
+      It is important to note that all of the changes made in this section 
+      are made in the build environment. The changes we are making here could just as easily
+      be made using the portal's live customization features. For example, you can drop a decorator
+      or theme into the portal while its running. Jetspeed will pick it up automatically. Or, to 
+      customize a page, you can use the portlet customizer or desktop customizer, portlet selector,
+      and site manager: all administrative portlets that work on your live portal. However, the point of
+      configuring everything in a Maven build is to be able to easily reproduce portal environments
+      for development, testing, and new deployments.
+      </p>
+      <p>
+      This section of the tutorial covers customizing:
+      <ul>
+      <li>Portal Skins (or Decorators). We replace the default logo, colors, and page header and footers with our own.
+      </li>
+      <li>Portal Themes. Same as Portal Skins, but themes apply to the Jetspeed Desktop.
+      </li>
+      <li>Configuring the default portal page to use these new decorators and themes</li>
+      </ul>
+      </p>	
+	  <p>Lets get started with customization of the default portal page decoration</p>
+	  <p>
+	    <a href='../01/run-it.html'>Previous</a> <a href='page-decoration.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/maven-2/02/customizing-overview.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/customizing-overview.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/default-page.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/default-page.xml?rev=747213&r1=747212&r2=747213&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/default-page.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/default-page.xml Mon Feb 23 23:33:30 2009
@@ -1,65 +1,65 @@
-<?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>Default Page</title>
-		<subtitle>Modifying the Default Page</subtitle>
-		<authors>
-			<person name="David Sean Taylor" email="taylor@apache.org" />
-		</authors>
-	</properties>
-	<body>
-    <section name="Modifying the Default Page">
-      <p> 
-      Now that we have created our decorators and themes, lets put them to use on the default page.
-	  Lets get started with customization of the default portal page decoration. Copy in our
-	  sample default-page:</p>
-	 <source>
-	 <![CDATA[
-# Linux	 
-cd /JetspeedTraining/workspace/jetexpress
-cp ../../resources/pages/default-page.psml portal/src/webapp/WEB-INF/pages/
-
-# Windows
-cd \JetspeedTraining\workspace\jetexpress
-copy  ..\..\resources\pages\default-page.psml portal\src\webapp\WEB-INF\pages
-     ]]>
-     </source>	  	  
-	<p>Refresh your Eclipse project and edit the default-page.psml.
-	   Make the following modifications 
-	   <ul>
-	   <li>for the layout-decorator, replace tigris with <b>express-page</b></li>
-	   <li>for the portlet-decorator, replace tigris with <b>express-portlet</b></li>
-	   <li>add a skin default attribute as <b>skin="express"</b> for the desktop theme</li>
-	   </ul>
-	   </p>
-	 <source>
-	 <![CDATA[
-<page>
-  <defaults layout-decorator="express-page" 
-            portlet-decorator="express-portlet"
-            skin="express"/>	   	  
-     ]]>
-     </source>	  	  	   	
-     <p>Go ahead and save that file. We are now ready to deploy your changes to the portal</p>  
-	  <p>
-	    <a href='desktop-theme.html'>Previous</a> <a href='deploy-custom.html'>Next</a>
-	  </p>	        
-	  </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>Default Page</title>
+		<subtitle>Modifying the Default Page</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Modifying the Default Page">
+      <p> 
+      Now that we have created our decorators and themes, lets put them to use on the default page.
+	  Lets get started with customization of the default portal page decoration. Copy in our
+	  sample default-page:</p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress
+cp ../../resources/pages/default-page.psml portal/src/webapp/WEB-INF/pages/
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress
+copy  ..\..\resources\pages\default-page.psml portal\src\webapp\WEB-INF\pages
+     ]]>
+     </source>	  	  
+	<p>Refresh your Eclipse project and edit the default-page.psml.
+	   Make the following modifications 
+	   <ul>
+	   <li>for the layout-decorator, replace tigris with <b>express-page</b></li>
+	   <li>for the portlet-decorator, replace tigris with <b>express-portlet</b></li>
+	   <li>add a skin default attribute as <b>skin="express"</b> for the desktop theme</li>
+	   </ul>
+	   </p>
+	 <source>
+	 <![CDATA[
+<page>
+  <defaults layout-decorator="express-page" 
+            portlet-decorator="express-portlet"
+            skin="express"/>	   	  
+     ]]>
+     </source>	  	  	   	
+     <p>Go ahead and save that file. We are now ready to deploy your changes to the portal</p>  
+	  <p>
+	    <a href='desktop-theme.html'>Previous</a> <a href='deploy-custom.html'>Next</a>
+	  </p>	        
+	  </section>	  
+	</body>
 </document>
\ No newline at end of file

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/deploy-custom.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/deploy-custom.xml?rev=747213&r1=747212&r2=747213&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/deploy-custom.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/deploy-custom.xml Mon Feb 23 23:33:30 2009
@@ -1,67 +1,67 @@
-<?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>Deploying Decorations, Themes and Pages</title>
-		<subtitle>Deploying Decorations, Themes and Pages</subtitle>
-		<authors>
-			<person name="David Sean Taylor" email="taylor@apache.org" />
-		</authors>
-	</properties>
-	<body>
-    <section name="Deploying Decorations, Themes and Pages">
-      <p> 
-      To deploy the new resources (decorations, themes, and page) that we created in this section
-      of the tutorial, you could simply rebuild the portal by typing <b>mvn -P tomcat,min</b>.
-      Or, if your portal is aleady up and running, a simpler way is to automate the easy deployment
-      tasks with Ant. We have created a simple build.xml to copy over changed portal resources:</p>
-	 <source>
-	 <![CDATA[
-# Linux	 
-cd /JetspeedTraining/workspace/jetexpress
-cp ../../resources/build.xml .
-
-# Windows
-cd \JetspeedTraining\workspace\jetexpress
-copy  ..\..\resources\build.xml
-     ]]>
-     </source>	  	  
-	<p>To copy over the resources to the running portal, type:
-	   </p>
-	 <source>
-	 <![CDATA[
-ant	 
-     ]]>
-     </source>	  	  	   	
-     <p>Refresh the portal home page, <a href="http://localhost:8080/jetexpress/portal">http://localhost:8080/jetexpress/portal</a>
-     You should now see a portal with our new custom decorators:</p>  
-     <p>
-     <img src="../images/jetexpress-portal.png"/>
-     </p>
-     <p>
-     and desktop theme:
-     </p>
-     <p>
-     <img src="../images/jetexpress-desktop.png"/>     
-     </p>
-	  <p>
-	    <a href='default-page.html'>Previous</a> <a href='../03/portlet-app.html'>Next</a>
-	  </p>	        
-	  </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>Deploying Decorations, Themes and Pages</title>
+		<subtitle>Deploying Decorations, Themes and Pages</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Deploying Decorations, Themes and Pages">
+      <p> 
+      To deploy the new resources (decorations, themes, and page) that we created in this section
+      of the tutorial, you could simply rebuild the portal by typing <b>mvn -P tomcat,min</b>.
+      Or, if your portal is aleady up and running, a simpler way is to automate the easy deployment
+      tasks with Ant. We have created a simple build.xml to copy over changed portal resources:</p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress
+cp ../../resources/build.xml .
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress
+copy  ..\..\resources\build.xml
+     ]]>
+     </source>	  	  
+	<p>To copy over the resources to the running portal, type:
+	   </p>
+	 <source>
+	 <![CDATA[
+ant	 
+     ]]>
+     </source>	  	  	   	
+     <p>Refresh the portal home page, <a href="http://localhost:8080/jetexpress/portal">http://localhost:8080/jetexpress/portal</a>
+     You should now see a portal with our new custom decorators:</p>  
+     <p>
+     <img src="../images/jetexpress-portal.png"/>
+     </p>
+     <p>
+     and desktop theme:
+     </p>
+     <p>
+     <img src="../images/jetexpress-desktop.png"/>     
+     </p>
+	  <p>
+	    <a href='default-page.html'>Previous</a> <a href='../03/portlet-app.html'>Next</a>
+	  </p>	        
+	  </section>	  
+	</body>
 </document>
\ No newline at end of file

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/desktop-theme.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/desktop-theme.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/desktop-theme.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/desktop-theme.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,150 @@
+<?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>Page Themes</title>
+		<subtitle>Desktop Page Themes</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Desktop Page Themes">
+      <p> 
+      The Jetspeed Desktop has its own kinds of decorations.
+      These decorations are called <b>Desktop Themes</b>
+
+      Each Jetspeed Desktop page can be associated with a different theme. Themes
+      control some important aspect of a desktop page:
+      <ul>
+      <li>The colors, images, CSS styles that skin this page</li>
+      <li>The header portion of the page</li>
+      <li>The page margins</li>
+      <li>The footer portion of the page</li>
+      <li>Menus displayed on the page</li>
+      <li>Action buttons displayed on the window</li>            
+      </ul>
+      Themes do not control the placement of portlets. That is handled by the Jetspeed Desktop engine,
+      which follows the layout plan provided by the stuctured page markup (PSML). This is the same
+      layout instructions applied to a portal page. You will see that themes are much simpler
+      content than decorators. That is because most of the content in a theme is populated by the
+      Jetspeed Desktop engine at runtime.
+      Jetspeed comes with a few desktop themes out of the box. The default desktop theme for 
+      most pages is called <i>blue</i>. It looks like this:
+      </p>
+      <img src="../images/theme.png"/>
+      <p>
+      We are going to create a new desktop theme for this tutorial.
+      This new theme can be copied into our project from the <i>/JetspeedTutorial/resources/themes/express/</i> directory.
+      This will save you the trouble of creating all the logo images and CSS definitions.
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress
+mkdir portal/src/webapp/desktop-themes/express
+cp -r ../../resources/desktop-themes/express/* portal/src/webapp/desktop-themes/express/
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress
+mkdir portal\src\webapp\desktop-themes\express
+xcopy /s ..\..\resources\desktop-themes\express\* portal\src\webapp\desktop-themes\express\
+     ]]>
+     </source>	  	  
+    <subsection name="The Theme template">
+    <p>
+    Have a look at the <i>express</i> theme directory. 
+    Notice that there are two theme files: <i>express.jsp</i> and <i>express.vm</i>
+    Since there were so many complaints about no JSP support in templates, with the Desktop we 
+    decided to require support for both. The <i>theme.properties</i> determines which templates
+    is active. Lets look at the Velocity template. We have macros to display-theme relative resources:
+    </p>
+	 <source>
+	 <![CDATA[    
+        <img src="$jetspeedDesktop.getDesktopThemeResourceUrl('images/logo.gif')" alt="Logo" border="0"/>
+     ]]>
+     </source>	  	  
+    </subsection>
+    <subsection name="Theme Variables">    
+    <p>
+    JSP and Velocity make several variables about the context of a theme available for dynamic substition of menus and content:
+    </p>
+    <table>
+    <tr>
+    <th>Variable</th>
+    <th>Desc</th>    
+    <th>Usage</th>
+    </tr>
+    <tr>
+    <td>$jetspeedDesktop</td>
+    <td>Retrieve theme resources, and the name of the theme</td>
+    <td>${jetspeedDesktop.getDesktopTheme()</td>
+    </tr>
+    </table>
+    </subsection>
+    <subsection name="Content Divs">   
+     <p>
+     The remainder of the page is HTML DIV markup with special widget types and identifiers.
+     The desktop will populate these Divs with various content such as the portlets and menus.
+     <i>Jetspeed Menus</i> are build from a collection of portal resources
+     known as the <i>Portal Site</i>. The portal site is a content tree (like a file system) of portal
+     resources. The site can be stored in the file system or in a database. Resources can be a page,
+     folder, or link.  Lets look at some of the available macros for displaying menus on your page.
+     </p>	     
+    <p>
+    <table>
+    <tr>
+    <th>Widget</th>
+    <th>Type</th>
+    <th>Desc</th>
+    </tr>
+    <tr>
+    <td>jetspeed-menu-pages</td>
+    <td>jetspeed:PortalTabContainer</td>
+    <td>relative pages menu of pages in the current folder. Used to define the page tabs above the portal.</td>
+    </tr>
+    <tr>
+    <td>jetspeed-menu-breadcrumbs</td>
+    <td>jetspeed:PortalBreadcrumbContainer</td>
+    <td>paths to page used to provide history links below the page tabs</td>
+    </tr>
+    <tr>
+    <td>jetspeed-menu-navigations</td>
+    <td>jetspeed:PortalAccordionContainer</td>
+    <td>relative subfolders and root level links menu used to define the navigation pane beside the portal.</td>
+    </tr>
+    </table>
+    You can also define your own menus (not covered in this tutorial).
+    </p>
+	<p>
+	Finally, the Div to hold the portlet content must be defined. It is just a plain HTML DIV:
+	 <source>
+	 <![CDATA[
+<div class="layout-${jetspeedDesktop.getDesktopTheme()}" id="jetspeedDesktop"></div>	
+     ]]>
+     </source>	  	  
+	Notice that while decorators require two templates, desktops only require one template.
+	This makes for a much simpler page.
+	</p>
+	</subsection>
+	  <p>
+	    <a href='portlet-decoration.html'>Previous</a> <a href='default-page.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/maven-2/02/desktop-theme.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/desktop-theme.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/page-decoration.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/page-decoration.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/page-decoration.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/page-decoration.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,198 @@
+<?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>Page Decorators</title>
+		<subtitle>Customizing Page Decorators</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Page Decorators">
+      <p> 
+      Each Jetspeed page can be associated with a different page decoration. Page decorations
+      control some important aspect of a portal page:
+      <ul>
+      <li>The colors, images, CSS styles that skin this page</li>
+      <li>The header portion of the page</li>
+      <li>The page margins</li>
+      <li>The footer portion of the page</li>
+      <li>Menus displayed on the page</li>
+      <li>Action buttons displayed on the window</li>      
+      </ul>
+      Decorators do not control the placement of portlets. That is handled by layouts.
+      Jetspeed comes with several page decorations out of the box. The default page decorator for 
+      most pages is called <i>tigris</i>. It looks like this:
+      </p>
+      <img src="../images/tigris-page.png"/>
+      <p>
+      We are going to create a new decorator for this tutorial.
+      This new decorator can be copied into our project from the <i>/JetspeedTutorial/resources/decorations/layout/express-page/</i> directory.
+      This will save you the trouble of creating all the logo images and CSS definitions.
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress
+mkdir portal/src/webapp/decorations/layout/express-page
+cp -r ../../resources/decorations/layout/express-page/* portal/src/webapp/decorations/layout/express-page/
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress
+mkdir portal\src\webapp\decorations\layout\express-page
+xcopy /s ..\..\resources\decorations\layout\express-page\* portal\src\webapp\decorations\layout\express-page
+     ]]>
+     </source>	  	  
+    <subsection name="The Header">
+    <p>
+    Open up the <i>decorations/layout/express-page/header.vm</i>
+    This is a Velocity template, very much like JSP but simpler, with no Java compilation required.
+    Jetspeed does support JSP-based decorators. However no one has contributed one yet.
+    We could spend a lot of time teaching you about all the macros available.
+    But lets just concentrate on changing the logos first.
+    Scroll down to the banner content. Here we add our new left-hand side logo:
+    </p>
+	 <source>
+	 <![CDATA[    
+#GetPageResource('images/blueSunrisePicture.gif')    	 
+     ]]>
+     </source>	  	  
+     <p>
+     We've added a few more custom images, one in the center area of the banner:
+     </p>
+	 <source>
+	 <![CDATA[    
+<img src="#GetPageResource('images/BlueSunriseTextTahoma.gif')" height="29" width="165">	 
+     ]]>
+     </source>	  	  
+     <p>
+     and one more in the right area of the banner:
+     </p>
+	 <source>
+	 <![CDATA[    
+<img src="#GetPageResource('images/RisingEdgeSlogan.gif')" height="28" width="300">
+     ]]>
+     </source>	  	  
+     <p>
+     <i>#GetPageResource</i> is a Velocity macro. It retrieves a resource (image, CSS, HTML) from
+     the decoration folder, relative  to the root of the express-page decoration folder.
+     Besides the images, the header.vm is pretty much the same as Tigris.
+     In fact we simply cut and  paste the Tigris decorator to get us started.
+     This gives you a good  start of customizing the page.
+     </p>
+    </subsection>
+    <subsection name="Velocity Variables">    
+    <p>
+    Velocity makes several variables about the context of a decoration available for dynamic substition of menus and content:
+    </p>
+    <table>
+    <tr>
+    <th>Variable</th>
+    <th>Desc</th>    
+    <th>Usage</th>
+    </tr>
+    <tr>
+    <td>$layoutDecoration</td>
+    <td>Retrieve layout content from the decoration dir</td>
+    <td>$layoutDecoration.getResource("decorator-macros.vm")</td>
+    </tr>
+    <tr>
+    <td>$site</td>
+    <td>Retrieve menus by name</td>
+    <td>$site.getMenu("pages")</td>
+    </tr>
+    </table>
+    </subsection>
+    <subsection name="Menus">   
+     <p>
+     The remainder of the page is HTML markup mixed in with some important macros
+     for displaying Jetspeed Menus. <i>Jetspeed Menus</i> are build from a collection of portal resources
+     known as the <i>Portal Site</i>. The portal site is a content tree (like a file system) of portal
+     resources. The site can be stored in the file system or in a database. Resources can be a page,
+     folder, or link.  Lets look at some of the available macros for displaying menus on your page.
+     </p>	     
+    <p>
+    The $site always has the following menus available to you at any time:
+    <table>
+    <tr>
+    <th>Menu</th>
+    <th>Desc</th>
+    </tr>
+    <tr>
+    <td>pages</td>
+    <td>relative pages menu of pages in the current folder. Used to define the page tabs above the portal.</td>
+    </tr>
+    <tr>
+    <td>breadcrumbs</td>
+    <td>paths to page used to provide history links below the page tabs</td>
+    </tr>
+    <tr>
+    <td>navigations</td>
+    <td>relative subfolders and root level links menu used to define the navigation pane beside the portal.</td>
+    </tr>
+    <tr>
+    <td>back</td>
+    <td>parent folder menu used to define the single "back" link above the portal page tabs.</td>
+    </tr>
+    </table>
+    You can also define your own menus (not covered in this tutorial).
+    </p>
+	<p>
+	There are some helper macros for creating different styles of menus.
+	The macros are defined in the decorator-macros.vm file:	     
+     <table>
+     <tr>
+     <th>Macro</th>
+     <th>Decription</th>     
+     </tr>
+     <tr>
+     <td>#includeTabsNavigation($someMenu $LEFT_TO_RIGHT)</td>
+     <td>Displays a menu in a vertical tabbed navigation style.</td>
+     </tr>
+     <tr>
+     <td>#includeLinksNavigation($breadCrumb $LEFT_TO_RIGHT "" $BREADCRUMBS_STYLE "")</td>
+     <td>Displays a menu of links according to a given style.</td>
+     </tr>
+     <tr>
+     <td>#includeNestedLinksWithIconNavigation($standardNavs $TOP_TO_BOTTOM)</td>
+     <td>Displays a nested top-to-bottom menu navigation of folders, links, and pages.</td>
+     </tr>
+     <tr>
+     <td>#PageActionBar()</td>
+     <td>Not a menu, but the available actions (edit, view, help, print...) for this page</td>
+     </tr>
+     </table>
+     </p>
+    </subsection>    	     
+    <subsection name="The Footer">
+    <p>
+    Open up the <i>decorations/layout/express-page/footer.vm</i>
+    </p>
+	 <source>
+	 <![CDATA[    
+<img src="#GetPageResource('images/jetspeed-powered.gif')" alt="Jetspeed 2 Powered" border="0" />
+     ]]>
+     </source>	  	  
+    </subsection>    
+	  <p>
+	    <a href='customizing-overview.html'>Previous</a> <a href='portlet-decoration.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/maven-2/02/page-decoration.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/page-decoration.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/portlet-decoration.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/portlet-decoration.xml?rev=747213&r1=747212&r2=747213&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/portlet-decoration.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/02/portlet-decoration.xml Mon Feb 23 23:33:30 2009
@@ -1,71 +1,71 @@
-<?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 Decorators</title>
-		<subtitle>Customizing PortletDecorators</subtitle>
-		<authors>
-			<person name="David Sean Taylor" email="taylor@apache.org" />
-		</authors>
-	</properties>
-	<body>
-    <section name="Portlet Decorators">
-      <p> 
-      Each Jetspeed portlet window on a page can be associated with a different portlet decoration. 
-      Portlet decorations control some important aspect of a portlet window:
-      <ul>
-      <li>The colors, images, CSS styles that skin this window</li>
-      <li>The title portion of the portlet</li>
-      <li>The borders of the window</li>
-      <li>Action buttons displayed on the window</li>
-      </ul>      
-      Jetspeed comes with several portlet decorations out of the box. The default page decorator for 
-      most pages is called <i>tigris</i>. It looks like this:
-      </p>
-      <img src="../images/tigris-portlet.png"/>
-      <p>
-      We are going to create a new decorator for this tutorial.
-      This new decorator can be copied into our project from the <i>/JetspeedTutorial/resources/decorations/portlet/express-portlet/</i> directory.
-      This will save you the trouble of creating all the logo images and CSS definitions.
-      </p>
-	 <source>
-	 <![CDATA[
-# Linux	 
-cd /JetspeedTraining/workspace/jetexpress
-mkdir portal/src/webapp/decorations/portlet/express-portlet
-cp -r ../../resources/decorations/portlet/express-portlet/* portal/src/webapp/decorations/portlet/express-portlet/
-
-# Windows
-cd \JetspeedTraining\workspace\jetexpress
-mkdir portal\src\webapp\decorations\portlet\express-portlet
-xcopy /s ..\..\resources\decorations\portlet\express-portlet\* portal\src\webapp\decorations\portlet\express-portlet
-     ]]>
-     </source>	  	  
-     <p>
-     We are going to skip over the intricate details of portlet decorators, as page decorators are much more 
-     important, as they set your organization's branding. Whereas the standard window decorators are good 
-     enough for getting you started. Go ahead and review the content of our custom portlet decorator.
-     You will see that the directory layout is the same as for page decorators. The decorator simply
-     creates a new color variation on an existing window decorator.
-	  </p>	      
-	  <p>
-	    <a href='page-decoration.html'>Previous</a> <a href='desktop-theme.html'>Next</a>
-	  </p>	      	  
- </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 Decorators</title>
+		<subtitle>Customizing PortletDecorators</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Portlet Decorators">
+      <p> 
+      Each Jetspeed portlet window on a page can be associated with a different portlet decoration. 
+      Portlet decorations control some important aspect of a portlet window:
+      <ul>
+      <li>The colors, images, CSS styles that skin this window</li>
+      <li>The title portion of the portlet</li>
+      <li>The borders of the window</li>
+      <li>Action buttons displayed on the window</li>
+      </ul>      
+      Jetspeed comes with several portlet decorations out of the box. The default page decorator for 
+      most pages is called <i>tigris</i>. It looks like this:
+      </p>
+      <img src="../images/tigris-portlet.png"/>
+      <p>
+      We are going to create a new decorator for this tutorial.
+      This new decorator can be copied into our project from the <i>/JetspeedTutorial/resources/decorations/portlet/express-portlet/</i> directory.
+      This will save you the trouble of creating all the logo images and CSS definitions.
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress
+mkdir portal/src/webapp/decorations/portlet/express-portlet
+cp -r ../../resources/decorations/portlet/express-portlet/* portal/src/webapp/decorations/portlet/express-portlet/
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress
+mkdir portal\src\webapp\decorations\portlet\express-portlet
+xcopy /s ..\..\resources\decorations\portlet\express-portlet\* portal\src\webapp\decorations\portlet\express-portlet
+     ]]>
+     </source>	  	  
+     <p>
+     We are going to skip over the intricate details of portlet decorators, as page decorators are much more 
+     important, as they set your organization's branding. Whereas the standard window decorators are good 
+     enough for getting you started. Go ahead and review the content of our custom portlet decorator.
+     You will see that the directory layout is the same as for page decorators. The decorator simply
+     creates a new color variation on an existing window decorator.
+	  </p>	      
+	  <p>
+	    <a href='page-decoration.html'>Previous</a> <a href='desktop-theme.html'>Next</a>
+	  </p>	      	  
+ </section>	  
+</body>
 </document>
\ No newline at end of file

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,71 @@
+<?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>Building and Deploying</title>
+    <subtitle>Building and Deploying the Portlet Application</subtitle>
+	<authors>
+		<person name="David Sean Taylor" email="taylor@apache.org" />
+	</authors>
+  </properties>
+  <body>
+    <section name="Building and Deploying the Portlet Application">
+      <p>      
+       Now that you have generated a portlet app named <b>express-demo</b>, we are ready to build the portal.
+       We are going to build the portal from the command line:
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress/applications/express-demo
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress\applications\express-demo
+
+mvn 
+     ]]>
+	</source> 
+      <p>
+      This builds a portlet application war file name <i>express-demo-1.0.war</i>.
+      This war file is found under <i>target</i> directory. It is a standard JSR-168 portlet application distribution.
+      </p>
+      <p>
+      Now that we've built and deployed the portal, lets start up the application server (if its not already started).
+      While the app server is running, we can drop in the portlet application.
+      </p>	
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress/applications/express-demo
+cp target/express-demo-1.0.war /JetspeedTraining/tomcat-express/webapps/express-demo.war
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress\applications\express-demo
+copy target\express-demo-1.0.war \JetspeedTraining\tomcat-express\webapps\express-demo.war
+
+     ]]>
+	</source> 
+	<p>This will deploy your portlet application. Next, lets see how to add your new portlets to a page.
+	</p>      
+	  <p>
+	    <a href='portlet-app.html'>Previous</a> <a href='pages.html'>Next</a>
+	  </p>            
+    </section>
+  </body>
+</document>
+

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/build-it.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Modified: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/pages.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/pages.xml?rev=747213&r1=747212&r2=747213&view=diff
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/pages.xml (original)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/pages.xml Mon Feb 23 23:33:30 2009
@@ -1,78 +1,78 @@
-<?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>Configuring Portal Pages</title>
-    <subtitle>Configuring Portal Pages</subtitle>
-	<authors>
-		<person name="David Sean Taylor" email="taylor@apache.org" />
-	</authors>
-  </properties>
-  <body>
-    <section name="Configuring Portal Pages">
-      <p>      
-       Now that you have generated a portlet app named <b>express-demo</b>, we are ready to integrate
-       the new portlets into our system. This is done by adding the portlets to the portal pages.
-       These pages are also known as PSML files. Your pages makeup the navigational site of your system.
-	   The new pages we are going to add will have references to the new portlets added in the express-demo
-	   portlet applications. Of course users can use the Portlet Selector and Jetspeed Customizer to
-	   select portlets interactively. Here we are setting up the collection of pages that will  always
-	   be a part of your portal. The file-system tree-like collection of pages is known as your <b>portal site</b>	   
-      </p>
-      <p>
-      We provide a quick Ant task to copy in the new, preconfigured pages:
-      </p>
-	 <source>
-	 <![CDATA[
-# Linux	 
-cd /JetspeedTraining/workspace/jetexpress/
-
-# Windows
-cd \JetspeedTraining\workspace\jetexpress\
-
-ant copy-page-resources
-     ]]>
-	</source> 
-      <p>
-      Open up some of the pages found under <i>portal/src/webapp/WEB-INF/pages/</i>.
-      You will see that we've added a new <i>Contact Us</i> page, and added the some new demo portlets
-      the the default page. We have also changed the default themes and decorators
-      for all administrative pages.
-      </p>
-      <p>
-      Go ahead and deploy those changes:
-      </p>	
-	 <source>
-	 <![CDATA[
-ant
-     ]]>
-	</source> 
-	<p>This will deploy your new pages. Refresh the portal home page to see the new portlets:
-	</p>      
-	<img src="../images/new-home.png"/>
-	<p>
-	Likewise for the desktop:
-	</p>
-	<img src="../images/new-home2.png"/>	
-	  <p>	  
-	    <a href='portlet-app.html'>Previous</a> <a href='../04/overview.html'>Next</a>
-	  </p>            
-    </section>
-  </body>
-</document>
-
+  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>Configuring Portal Pages</title>
+    <subtitle>Configuring Portal Pages</subtitle>
+	<authors>
+		<person name="David Sean Taylor" email="taylor@apache.org" />
+	</authors>
+  </properties>
+  <body>
+    <section name="Configuring Portal Pages">
+      <p>      
+       Now that you have generated a portlet app named <b>express-demo</b>, we are ready to integrate
+       the new portlets into our system. This is done by adding the portlets to the portal pages.
+       These pages are also known as PSML files. Your pages makeup the navigational site of your system.
+	   The new pages we are going to add will have references to the new portlets added in the express-demo
+	   portlet applications. Of course users can use the Portlet Selector and Jetspeed Customizer to
+	   select portlets interactively. Here we are setting up the collection of pages that will  always
+	   be a part of your portal. The file-system tree-like collection of pages is known as your <b>portal site</b>	   
+      </p>
+      <p>
+      We provide a quick Ant task to copy in the new, preconfigured pages:
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress/
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress\
+
+ant copy-page-resources
+     ]]>
+	</source> 
+      <p>
+      Open up some of the pages found under <i>portal/src/webapp/WEB-INF/pages/</i>.
+      You will see that we've added a new <i>Contact Us</i> page, and added the some new demo portlets
+      the the default page. We have also changed the default themes and decorators
+      for all administrative pages.
+      </p>
+      <p>
+      Go ahead and deploy those changes:
+      </p>	
+	 <source>
+	 <![CDATA[
+ant
+     ]]>
+	</source> 
+	<p>This will deploy your new pages. Refresh the portal home page to see the new portlets:
+	</p>      
+	<img src="../images/new-home.png"/>
+	<p>
+	Likewise for the desktop:
+	</p>
+	<img src="../images/new-home2.png"/>	
+	  <p>	  
+	    <a href='portlet-app.html'>Previous</a> <a href='../04/overview.html'>Next</a>
+	  </p>            
+    </section>
+  </body>
+</document>
+

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,85 @@
+<?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>Generating a Portlet Application</title>
+    <subtitle>Using Maven to Generate a Portlet Application</subtitle>
+	<authors>
+		<person name="David Sean Taylor" email="taylor@apache.org" />
+	</authors>
+  </properties>
+  <body>
+    <section name="Generating a Portlet Application">
+      <p>      
+       Portlet applications should be stored in a separate sub-project of your main portal project.
+       Our custom build is setup to put one or more portlet application projects under the <i>applications</i>
+       directory. For this tutorial, we will create one portlet application. The portlet application
+       will be automatically  built and deployed when you run <b>maven -P tomcat,min</b>.
+       </p>
+       <p>
+       To create a new portal application named <b>express-demo</b>, enter the following commands:
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress/applications
+
+# Windows
+cd \JetspeedTraining\workspace\jetexpress\applications
+
+mvn archetype:create -DarchetypeGroupId=org.apache.portals.jetspeed-2 
+                     -DarchetypeArtifactId=application-archetype 
+                     -DarchetypeVersion=2.1 
+                     -DgroupId=org.apache.portals.tutorials
+                     -DartifactId=express-demo
+                     -Dversion=1.0
+     ]]>
+	</source> 
+	  <p>
+	  <b>Paste into Command Line:</b>
+	  <input id='genapp' size="80" value="mvn archetype:create -DarchetypeGroupId=org.apache.portals.jetspeed-2 -DarchetypeArtifactId=application-archetype -DarchetypeVersion=2.1 -DgroupId=org.apache.portals.tutorials -DartifactId=express-demo -Dversion=1.0"/>	  
+	  </p>
+      <p>      
+       A directory named <b>express-demo</b> under <i>/JetspeedTraining/workspace/applications</i> should have been created.
+       Notice that <b>express-demo</b> will be the name of your portlet application.
+      </p>
+      <p>
+        Lets have a closer look at what was created. There is a <b>src</b> directory, and underneath it
+        three subdirectories <b>java, test, webapp</b>. Under the <b>java</b> directory, there is one
+        sample portlet. Under the <b>test</b> directory, you will find one unit test. Under the <b>webapp</b>
+        directory, you will find a number of files that are the basic template for any useful portlet application:
+     </p>
+     <img src="../images/src-dir.png"/>          
+     <p>
+       Here you will find the portlet and servlet deployment descriptors: <b>portlet.xml</b> and <b>web.xml</b>.
+       Review the files in this directory. We are going to copy over some more sample portlets for the tutorial.
+       Lets let an ant task to do the work for us:
+     </p>
+	 <source>
+	 <![CDATA[
+	 ant copy-portlet-resources
+     ]]>
+	</source> 
+     
+	  <p>
+	    <a href='../02/deploy-custom.html'>Previous</a> <a href='build-it.html'>Next</a>
+	  </p>            
+    </section>
+  </body>
+</document>
+

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/03/portlet-app.xml
------------------------------------------------------------------------------
    svn:keywords = Id

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/eclipse.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/eclipse.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/eclipse.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/eclipse.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,92 @@
+<?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>Eclipse Integration</title>
+		<subtitle>Eclipse Integration</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Eclipse Integration">
+      <p> 
+      Before getting started, lets get Eclipse setup.
+      Lets create a Eclipse project for the jetexpress project.
+      Maven-2 can create Eclipse project and classpath files from your Maven-2 project POM,
+      automatically bringing in all dependencies:
+      </p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress
+mvn eclipse:eclipse
+cp portal/.classpath .
+cp portal/.project .
+# Windows
+cd \JetspeedTraining\workspace\jetexpress
+mvn eclipse:eclipse
+copy portal\.classpath .
+copy portal\.project .
+     ]]>
+     </source>	  	        
+      <p>	      	  
+	Lets do the same for the <i>express-demo</i> portlet application.
+	You may prefer to actually create a new Eclipse project to represent the portlet app subproject.
+	We recommend this, since Eclipse doesn't work very well multi-Maven projects. Best to break
+	them out into one Maven project == one Eclipse project:
+	</p>
+	 <source>
+	 <![CDATA[
+# Linux	 
+cd /JetspeedTraining/workspace/jetexpress/applications/express-demo
+mvn eclipse:eclipse
+# Windows
+cd \JetspeedTraining\workspace\jetexpress\applications\express-demo
+mvn eclipse:eclipse
+     ]]>
+     </source>	  	        
+	<p>
+	Now lets import these new projects. From the eclipse menu, select File->Import:
+	</p>
+	<img src="../images/import-project.png"/>	
+	<img src="../images/import-project2.png"/>		
+	<p>
+	Repeat for both the applications/express-demo project.
+	</p>
+	<p>
+	Next, lets setup a classpath variable to point at the Maven Repo, effectively resolving the jars for Eclipse.
+	In Eclipse, go to Window->Preferences->Java->Build Path->Classpath Variables->New...:
+	</p>
+	<img src="../images/eclipse-classpath.png"/>	
+	  <p>
+	If you would like to work with the Jetspeed source from the SVN Trunk, you will need to install the Subversion Plugin for Eclipse.
+	After doing so, simply check out the project using the Subversion plugin:
+	  </p>	
+	<img src="../images/svn1.png"/>	
+	<img src="../images/svn2.png"/>			  
+	<img src="../images/svn3.png"/>			  	
+	  <p>
+	We are now ready to start developing with Eclipse. 
+	  </p>
+	  <p>	  
+	    <a href='overview.html'>Previous</a> <a href='hello.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/maven-2/04/eclipse.xml
------------------------------------------------------------------------------
    svn:eol-style = native

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

Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/overview.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/overview.xml?rev=747213&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/overview.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/overview.xml Mon Feb 23 23:33:30 2009
@@ -0,0 +1,45 @@
+<?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>Portlet Development 101</subtitle>
+		<authors>
+			<person name="David Sean Taylor" email="taylor@apache.org" />
+		</authors>
+	</properties>
+	<body>
+    <section name="Portlet Development with the Portlet API">
+      <p> 
+        This section of the tutorial covers Portlet Development with the Java Portlet API.
+      </p>	
+      <p> 
+	   <ul>
+	     <li>Getting started with Eclipse</li>
+	     <li>Bonjour Monde Portlet: the staple Hello World demo to get things rolling introduces the portlet.xml, as well as basic Portlet API concepts.</li>
+	     <li>The Weather Portlet: using init parameters, preferences, and request parameters</li>	 
+	     <li>The Stock Quote Portlet: actions, JSP, Portlet API Tag Library</li>	 
+	     <li>Interportlet communication, more advanced Portlet programming.</li>
+	   </ul>	   
+      </p>	
+	  <p>
+	    <a href='../03/pages.html'>Previous</a> <a href='eclipse.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/maven-2/04/overview.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/maven-2/04/overview.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


Mime
View raw message