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:31:21 UTC
svn commit: r747206 - in
/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03:
build-it.xml pages.xml portlet-app.xml
Author: taylor
Date: Mon Feb 23 23:31:20 2009
New Revision: 747206
URL: http://svn.apache.org/viewvc?rev=747206&view=rev
Log:
eoln
Added:
portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/build-it.xml (with props)
portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml (with props)
portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/portlet-app.xml (with props)
Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/build-it.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/build-it.xml?rev=747206&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/build-it.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/build-it.xml Mon Feb 23 23:31:20 2009
@@ -0,0 +1,89 @@
+ <?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" />
+ <person name="David Dyer"
+ email="ddyer@artifact-software.com" />
+ <person name="Ron Wheeler"
+ email="rwheeler@artifact-software.com" />
+ </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/ant/03/build-it.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/build-it.xml
------------------------------------------------------------------------------
svn:keywords = Id
Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml?rev=747206&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml Mon Feb 23 23:31:20 2009
@@ -0,0 +1,93 @@
+<?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" />
+ <person name="David Dyer"
+ email="ddyer@artifact-software.com" />
+ <person name="Ron Wheeler"
+ email="rwheeler@artifact-software.com" />
+ </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>
+
Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/pages.xml
------------------------------------------------------------------------------
svn:keywords = Id
Added: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/portlet-app.xml
URL: http://svn.apache.org/viewvc/portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/portlet-app.xml?rev=747206&view=auto
==============================================================================
--- portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/portlet-app.xml (added)
+++ portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/portlet-app.xml Mon Feb 23 23:31:20 2009
@@ -0,0 +1,119 @@
+<?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" />
+ <person name="David Dyer"
+ email="ddyer@artifact-software.com" />
+ <person name="Ron Wheeler"
+ email="rwheeler@artifact-software.com" />
+ </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/ant/03/portlet-app.xml
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: portals/jetspeed-2/portal/branches/JETSPEED-2.1.3-POSTRELEASE/xdocs/tutorials/ant/03/portlet-app.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