You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@portals.apache.org by at...@apache.org on 2012/12/16 23:55:26 UTC
svn commit: r1422709 [42/44] - in /portals/site-live/jetspeed-2.1.3:
2.1/schemas/ adminguide/ adminguide/css/ adminguide/images/
adminguide/images/logos/ css/ deployguide/ deployguide/css/
deployguide/images/ deployguide/images/ldap/ deployguide/images...
Added: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven1.html
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven1.html?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven1.html (added)
+++ portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven1.html Sun Dec 16 22:54:22 2012
@@ -0,0 +1,229 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Jetspeed 2 Enterprise Portal - Building a Custom Jetspeed Portal With Maven-1</title><style type="text/css" media="all">
+ @import url("../../style/maven-base.css");
+
+ @import url("../../style/maven-j2.css");@import url("../../style/project.css");</style><link rel="stylesheet" href="../../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://portals.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://portals.apache.org/images/apache-portals.gif"></img></a><a href="http://portals.apache.org/jetspeed-2" id="projectLogo"><img alt="Jetspeed 2 Enterprise Portal" src="http://portals.apache.org/images/Jetspeed_blue_med.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 23 April 2009
+ | Doc for 2.1.3</div><div class="xright">
+
+ <a href="../../usersguide/index.html">Users Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../../adminguide/index.html">Admin Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../../deployguide/index.html">Deployers Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../../devguide/index.html">Developers Guide</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuEssentials"><h5>Essentials</h5><ul><li class="none"><a href="../../index.html">Welcome</a></li><li class="none"><a href="../../features.html">Features</a></li><li class="none"><a href="../../getting-started.html">Getting Started</a></li><li class="none"><a href="../../demo.html">Jetspeed Online Demos</a></li></ul></div><div id="menuGet_Jetspeed-2_1_3"><h5>Get Jetspeed-2.1.3</h5><ul><li class="none"><a href="../../download.html">Download</a></li><li class="none"><a href="../../getting-started-installer.html">Installer Instructions</a></li><li class="none"><a href="../../release-notes.html">Release Notes</a></li></ul></div><div id="menuDocumentation_Guides"><h5>Documentation Guides</h5><ul><li class="none"><a href="../../usersguide/index.html">Users Guide</a></li><li class="none"><a href="../../adminguide/index.html">Administrators Guide</a></li><li class="none"><a href=".
./../deployguide/index.html">Deployment Guide</a></li><li class="none"><a href="../../devguide/index.html">Developers Guide</a></li><li class="none"><a href="../../guide-migration.html">Migration Guide</a></li></ul></div><div id="menuAPIs"><h5>APIs</h5><ul><li class="none"><a href="../../multiproject/jetspeed-api/apidocs/index.html">Jetspeed-2 Java API</a></li><li class="none"><a href="../../devguide/guide-ajax-api.html">Jetspeed-2 AJAX API</a></li><li class="none"><a href="../../devguide/j2-maven-plugin.html">Jetspeed-2 Maven-2 Plugin</a></li></ul></div><div id="menuTutorials"><h5>Tutorials</h5><ul><li class="none"><a href="../../tutorials/maven-2/index.html">Jetspeed Tutorial - Maven-2 Custom Build</a></li><li class="none"><a href="../../tutorials/ant/index.html">Jetspeed Tutorial - Ant Custom Build (incomplete)</a></li><li class="none"><a href="../../tutorials/stepbystep/guide-building-custom-portal-maven1.html">Maven-1 Custom Build</a></li><li class="none"><a href="../..
/tutorials/stepbystep/guide-building-custom-portal-maven2.html">Maven-2 Custom Build</a></li></ul></div><div id="menuAbout_Jetspeed-2"><h5>About Jetspeed-2</h5><ul><li class="none"><a href="../../j1-users.html">For Jetspeed-1 Users</a></li><li class="none"><a href="../../j1-migration.html">Jetspeed-1 Migration Guideline</a></li><li class="none"><a href="../../supporting-projects.html">Supporting Projects</a></li><li class="none"><a href="../../who-uses-j2.html">Who Uses J2?</a></li><li class="none"><a href="../../portlets-community.html">Portlets Community</a></li><li class="none"><a href="../../how-to-help.html">How to Help?</a></li></ul></div><div id="menuSupport"><h5>Support</h5><ul><li class="none"><a href="../../mail-lists.html">Mailing List</a></li><li class="none"><a href="../../issue-tracking.html">Bug Database</a></li><li class="none"><a href="http://wiki.apache.org/portals/Jetspeed2" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="
../../faq.html">FAQ</a></li></ul></div><div id="menuTranslation"><h5>Translation</h5><ul><li class="none"><a href="http://jetspeed-japan.sourceforge.jp/jetspeed-2-trans/ja/index.html" class="externalLink" title="External Link">Japanese</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../../index.html">About Jetspeed 2 Enterprise Portal</a></li><li class="collapsed"><a href="../../project-info.html">Project Info</a></li><li class="collapsed"><a href="../../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Building_a_Custom_Jet
speed_Portal_With_Maven-1"></a><h2>Building a Custom Jetspeed Portal With Maven-1</h2><ul>
+ <li>
+ <a href="#Introduction">Introduction</a>
+ <ul>
+ <li><a href="#Purpose">Purpose</a></li>
+ <li><a href="#Software_Requirements">Software Requirements</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#Windows_XP_Environment">Windows XP Environment</a>
+ <ul>
+ <li><a href="#Distribution_And_Coventions">Distribution and Coventions</a></li>
+ <li><a href="#Environment">Environment</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#Maven-1_Configuration">Maven-1 configuration</a>
+ <ul>
+ <li><a href="#USER_HOME_Build_properties">USER_HOME build.properties</a></li>
+ <li><a href="#Build_properties">build.properties</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#Database">Database</a>
+ <ul>
+ <li><a href="#MAVEN_REPO_Classpath_Variable">MAVEN_REPO Classpath variable</a></li>
+ <li><a href="#Jetspeed-2_Portal_Sources">Jetspeed-2 portal sources</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#Building_Jet_Express">Building Jet Express</a>
+ <ul>
+ <li><a href="#Building_Jet_Express_For_Tomcat">Building Jet Express for Tomcat</a></li>
+ <li><a href="#Building_Jet_Express_For_Websphere">Building Jet Express for Websphere</a></li>
+ <li><a href="#Synchronizing_The_Portal_With_Latest_Verion_Of________Jetspeed-2">Synchronizing the Portal with latest verion of
+ Jetspeed-2</a></li>
+ </ul>
+ </li>
+ <li><a href="#Revision_History">Revision History</a></li>
+ </ul></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>
+ This document is a step by step guide to building a custom Apache
+ Portals Jetspeed-2 portal with Maven-1. The Maven-1 project
+ provided with this document will:
+ <ol>
+ <li>Build a custom portal</li>
+ <li>Build a custom portlet application</li>
+ <li>Populate the database</li>
+ <li>Create distributable deployment archives for Websphere
+ 6.1 and Tomcat 5</li>
+ </ol>
+ </p><p>
+ This document is for Maven-1 build systems. To build with Maven-2, see
+ the accompanying document "Building Custom a Jetspeed Portal with
+ Maven-2"
+ </p><p>
+ For documentation on deploying the WAR and EAR files created here, see
+ the document "Deploying Jetspeed to Websphere"
+ </p><div class="subsection"><a name="Purpose"></a><h3>Purpose</h3><p>
+ This document will teach you how to build and configure a custom Jetspeed Portal and create deployable archives for Websphere 6.1 and Tomcat 5. The complete source code, projects and deployment environment are described in this document. Deployments are based upon the J2EE standard "Web Application" and "Enterprise Application" deployment. The build is based on the Apache Portals Jetspeed-2 "Maven-1 Custom Build".
+ </p><p>
+ Jetspeed is an open source project, thus all source code is freely available from Apache. See the website for more details: <a href="http://portals.apache.org/jetspeed-2/" class="externalLink" title="External Link">http://portals.apache.org/jetspeed-2/</a>
+ </p><p>
+ This document assumes that the user is familiar with open source Java development. In particular the Apache Software Foundation (ASF) and the essential Apache open source projects:
+ <ol>
+ <li>Apache Portals http://portals.apache.org and subprojects:
+ <ol>
+ <li>Jetspeed-2</li>
+ <li>Bridges</li>
+ <li>Pluto</li>
+ </ol>
+ </li>
+ <li>Ant (<a href="http://ant.apache.org" class="externalLink" title="External Link">http://ant.apache.org</a>)</li>
+ <li>Maven-1 (<a href="http://maven.apache.org" class="externalLink" title="External Link">http://maven.apache.org</a>)</li>
+ <li>Apache Tomcat Web Server (<a href="http://tomcat.apache.org" class="externalLink" title="External Link">http://tomcat.apache.org</a>)</li>
+ <li>IBM Websphere Application Server</li>
+ </ol>
+ </p></div><div class="subsection"><a name="Software_Requirements"></a><h3>Software Requirements</h3><table class="bodyTable"><tr class="a"><td>Product</td><td>Version</td></tr><tr class="b"><td>Ant</td><td>1.6.5 or higher</td></tr><tr class="a"><td>Eclipse</td><td>3.1.1 or higher</td></tr><tr class="b"><td>Maven</td><td>1.0.2 or higher</td></tr><tr class="a"><td>Sun JDK</td><td>1.4.2 or 1.5</td></tr><tr class="b"><td>Tomcat</td><td>5.5.12 (with Java 1.4 compatibility) or higher</td></tr><tr class="a"><td>IBM Websphere</td><td>6.1.0.2 or higher</td></tr></table></div></div><div class="section"><a name="Windows_XP_Environment"></a><h2>Windows XP Environment</h2><p>
+ This section shows how to configure under Windows XP for development, demo, testing and production environments. Since we are working with Java, the environment for Linux will not be much different although components like Eclipse and MySQL require Linux specific versions and setup.
+ </p><p>
+ When using properties files under Windows, please remember that Java requires you to use either the forward slash /, or double back slash \\ for file system paths. You cannot use a single back slash \. Using the back slash does not work with Java, since it is the escape sequence-character.
+ </p><p>WRONG!!!!</p><p>
+ <code>
+ my.files = \path\to\my\files\
+ </code>
+ </p><p>RIGHT :)</p><p>
+ <code>
+ my.files = /path/to/my/files/
+ </code>
+ </p><p>
+ It is strongly recommended to always use forward slashes, whether on Windows or Linux.
+ </p><div class="subsection"><a name="Distribution_and_Conventions"></a><h3>Distribution and Conventions</h3><p>
+ It is strongly recommended that all developers on the project use the same root directory for all project source and supporting files.
+ </p><p>
+ The distribution is a complete environment for software development, unit testing, system testing, and deploying to a production environment.
+ </p></div><div class="subsection"><a name="Environment"></a><h3>Environment</h3><p>
+ The system path will need to include Java, Maven and Ant.
+ </p><p>
+ Under Windows XP, the Environment Variables and the System Path is modified by going to the
+ <i>Start Menu -> Settings -> Control Panel -> System -> Advanced -> Environment Variables</i>.
+ </p><p>
+ Note: You need administrative privileges to be allowed to modify system environment variables.
+ </p><p>
+ With these settings configured, you then have to make your system Windows PATH variable based on the home directories:
+ </p><p>
+ <code>
+ PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin;%MAVEN_HOME%\bin;C:\winnt\system32...
+ </code>
+ </p><p>
+ Note: make sure to put the new path elements in front of the existing path definition!
+ </p></div></div><div class="section"><a name="Maven-1_configuration"></a><h2>Maven-1 configuration</h2><p>
+ The build environment uses the Maven project management tool (<a href="http://maven.apache.org" class="externalLink" title="External Link">http://maven.apache.org</a>). One thing that Maven does well is managing Java jar files and maintaining versions of those files. Maven stores all jar files for almost every known open source project on the planet in a set of distributed repositories on the internet. Maven project descriptors reference specific versions of the jars, and the jars are downloaded to a local repository in order to build the system. By default Maven puts the repository under your Home directory which on Windows XP usually is found under the "Documents and Settings" directory.
+ </p><p>
+ Maven's behavior is for the most part customized through one <i>project.properties</i> and/or one or two <i>build.properties</i> files for each project.
+ </p><p>
+ Specific project properties are usually defined in a <i>project.properties</i> file within the project directory. User overrides of default and project properties can be defined in a <i>build.properties</i> file within the same project directory as well as in the user home directory. Properties defined in the <i>build.properties</i> in the user home directory will overrule any other property definitions.
+ </p><p>
+ Our project development environment is fully contained within one root project directory. In order to be able to have Maven not put its repository under the user home directory, we do need to specify a few properties in the user home <i>build.properties.</i>
+ </p><div class="subsection"><a name="USER_HOME_build_properties"></a><h3>USER_HOME build.properties</h3><p>
+ The distribution contains a <i>build.properties</i> file under the etc directory which can be copied by every developer to its own home directory.
+ </p><p>
+ It defines the following general Maven-1 settings:
+ <ul>
+ <li><i>maven.home.local:</i> the local maven repository (OPTIONAL)</li>
+ <li><i>maven.repo.remote:</i> the remote repositories used by the Jet Express project(s)</li>
+ <li><i>maven.proxy.*:</i> any proxy server configuration</li>
+ </ul>
+ </p></div><div class="subsection"><a name="build_properties"></a><h3>build.properties</h3><p>
+ The build supports both Tomcat 5 and WebSphere 6.1. Because each server requires slightly different handling, there are two sets of property files. To switch between the two, run one of the two batch files:
+ <ol>
+ <li>switchToTomcat.bat</li>
+ <li>switchToWebsphere.bat</li>
+ </ol>
+ </p></div><div class="subsection"><a name="Database"></a><h3>Database</h3><p>
+ The build requires a database installed on the local network. For the examples here, we will use an Oracle database although you can select other databases such as DB2 or MySQL.
+ </p><p>
+ The database properties are defined in <i>build.properties.tomcat</i> and <i>build.properties.was</i>. He is an example of using Oracle configuration parameters and MySQL commented out:
+ </p><p>
+
+ <div class="source"><pre>
+# -------------------------------------------------------------------------
+# MySQL Database Setup
+# -------------------------------------------------------------------------
+org.apache.jetspeed.production.database.default.name=mysql
+org.apache.jetspeed.production.database.url = jdbc:mysql://localhost/express
+org.apache.jetspeed.production.database.driver = com.mysql.jdbc.Driver
+org.apache.jetspeed.production.database.user = express
+org.apache.jetspeed.production.database.password = xxxx
+org.apache.jetspeed.production.jdbc.drivers.path=${express.home}/drivers/mysql-connector-java-3.1.7-bin.jar
+
+# -------------------------------------------------------------------------
+# Oracle Database Setup
+# -------------------------------------------------------------------------
+org.apache.jetspeed.production.database.default.name=oracle
+org.apache.jetspeed.production.database.url = jdbc:oracle:thin:@svn.bluesunrise.com:1521:XE
+org.apache.jetspeed.production.database.driver = oracle.jdbc.driver.OracleDriver
+org.apache.jetspeed.production.database.user = fmr
+org.apache.jetspeed.production.database.password = xxxx
+org.apache.jetspeed.production.jdbc.drivers.path=etc/drivers/ojdbc14.jar
+ </pre></div>
+
+ </p></div><div class="subsection"><a name="MAVEN_REPO_Classpath_variable"></a><h3>MAVEN_REPO Classpath variable</h3><p>
+ To have Eclipse use the local Maven repository which will contain all the jars needed for jetspeed-2, the portal and portlets, the MAVEN_REPO Classpath variable needs to be defined.
+ </p><p>
+ Open the <i>Windows -> Preferences</i> dialog and select the <i>Java -> Build Path -> Classpath</i> Variables node from the Preferences tree. Then use the <i>New...</i> button to add a new MAVEN_REPO variable pointing at your Maven home repository folder.
+ </p></div><div class="subsection"><a name="Jetspeed-2_portal_sources"></a><h3>Jetspeed-2 portal sources</h3><p>
+ For building the portal, the Jetspeed-2 portal sources are not needed, but for debugging purposes, it can be helpful to have them checked out when trying to debug.
+The Jetspeed-2 sources, as well as those for the embedded pluto portlet container and portals bridges, can all be checked out from the <i>svn.apache.org/repos/asf/portals</i> repository root, similar to how the Jet Express sources are checked out.
+ </p></div></div><div class="section"><a name="Building_Jet_Express"></a><h2>Building Jet Express</h2><p>
+ The Jet Express portal project is a Maven based project. It builds the entire portal as well as the example portlet application. The main Jet Express project controls the entire build.
+ </p><div class="subsection"><a name="Building_Jet_Express_for_Tomcat"></a><h3>Building Jet Express for Tomcat</h3><p>
+ <code>maven clean tomcat-all</code>
+ </p><p>
+ This will clean, build and deploy the portal as well as deploy the example portlet application.
+ Note: make sure to first once execute:
+ </p><p>
+ <code>
+ switchToTomcat.bat
+ </code>
+ </p></div><div class="subsection"><a name="Building_Jet_Express_for_Websphere"></a><h3>Building Jet Express for Websphere</h3><p>
+ To build WAR files:
+ </p><p>
+ <code>maven clean was-war-all</code>
+ </p><p>
+ To build EAR files:
+ </p><p>
+ <code>maven clean was-ear-all</code>
+ </p><p>
+ This will clean, build and deploy the portal as well as deploy the example portlet application.
+ Note: make sure to first once execute:
+ </p><p>
+ <code>switchToWebsphere.bat</code>
+ </p></div><div class="subsection"><a name="Synchronizing_the_Portal_with_the_latest_version_of_Jetspeed-2"></a><h3>Synchronizing the Portal with the latest version of Jetspeed-2</h3><p>
+ Because the portal uses jetspeed-2 jars stored in the local maven repository, newer version of jetspeed-2 jars will not automatically be downloaded from the remote bluesunrise maven repository.
+ </p><p>
+ To synchronize with the latest available jetspeed-2 build, the sync-j2.cmd batch file needs to be executed which will clear out the jetspeed-2 jars from the local maven repository and upgrade to the latest jetspeed-2 maven plugin:
+ </p><p>
+ <code>$WS_HOME\workspace\jetexpress>sync-j2.cmd</code>
+ </p><p>
+ A following (full) portal build will then automatically download and use the latest jetspeed-2 jars.
+ </p></div></div><div class="section"><a name="Revision_History"></a><h2>Revision History</h2><table class="bodyTable"><tr class="b"><td>Revision</td><td>Date</td><td>Author</td><td>Comments</td></tr><tr class="a"><td>0.1</td><td>2005-01-01</td><td>David Sean Taylor</td><td>Initial draft</td></tr><tr class="b"><td>0.2</td><td>2006-01-10</td><td>Ate Douma</td><td>Further refinements and clean out of unused sections</td></tr><tr class="a"><td>0.3</td><td>2006-01-10</td><td>David Sean Taylor</td><td>Express refinements</td></tr><tr class="b"><td>0.4</td><td>2006-10-16</td><td>David Sean Taylor</td><td>Websphere 6.1 testing</td></tr></table></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1999-2009, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven1.html
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven2.html
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven2.html?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven2.html (added)
+++ portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven2.html Sun Dec 16 22:54:22 2012
@@ -0,0 +1,339 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Jetspeed 2 Enterprise Portal - Building a Custom Jetspeed Portal With Maven-2</title><style type="text/css" media="all">
+ @import url("../../style/maven-base.css");
+
+ @import url("../../style/maven-j2.css");@import url("../../style/project.css");</style><link rel="stylesheet" href="../../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://portals.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://portals.apache.org/images/apache-portals.gif"></img></a><a href="http://portals.apache.org/jetspeed-2" id="projectLogo"><img alt="Jetspeed 2 Enterprise Portal" src="http://portals.apache.org/images/Jetspeed_blue_med.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 23 April 2009
+ | Doc for 2.1.3</div><div class="xright">
+
+ <a href="../../usersguide/index.html">Users Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../../adminguide/index.html">Admin Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../../deployguide/index.html">Deployers Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../../devguide/index.html">Developers Guide</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuEssentials"><h5>Essentials</h5><ul><li class="none"><a href="../../index.html">Welcome</a></li><li class="none"><a href="../../features.html">Features</a></li><li class="none"><a href="../../getting-started.html">Getting Started</a></li><li class="none"><a href="../../demo.html">Jetspeed Online Demos</a></li></ul></div><div id="menuGet_Jetspeed-2_1_3"><h5>Get Jetspeed-2.1.3</h5><ul><li class="none"><a href="../../download.html">Download</a></li><li class="none"><a href="../../getting-started-installer.html">Installer Instructions</a></li><li class="none"><a href="../../release-notes.html">Release Notes</a></li></ul></div><div id="menuDocumentation_Guides"><h5>Documentation Guides</h5><ul><li class="none"><a href="../../usersguide/index.html">Users Guide</a></li><li class="none"><a href="../../adminguide/index.html">Administrators Guide</a></li><li class="none"><a href=".
./../deployguide/index.html">Deployment Guide</a></li><li class="none"><a href="../../devguide/index.html">Developers Guide</a></li><li class="none"><a href="../../guide-migration.html">Migration Guide</a></li></ul></div><div id="menuAPIs"><h5>APIs</h5><ul><li class="none"><a href="../../multiproject/jetspeed-api/apidocs/index.html">Jetspeed-2 Java API</a></li><li class="none"><a href="../../devguide/guide-ajax-api.html">Jetspeed-2 AJAX API</a></li><li class="none"><a href="../../devguide/j2-maven-plugin.html">Jetspeed-2 Maven-2 Plugin</a></li></ul></div><div id="menuTutorials"><h5>Tutorials</h5><ul><li class="none"><a href="../../tutorials/maven-2/index.html">Jetspeed Tutorial - Maven-2 Custom Build</a></li><li class="none"><a href="../../tutorials/ant/index.html">Jetspeed Tutorial - Ant Custom Build (incomplete)</a></li><li class="none"><a href="../../tutorials/stepbystep/guide-building-custom-portal-maven1.html">Maven-1 Custom Build</a></li><li class="none"><a href="../..
/tutorials/stepbystep/guide-building-custom-portal-maven2.html">Maven-2 Custom Build</a></li></ul></div><div id="menuAbout_Jetspeed-2"><h5>About Jetspeed-2</h5><ul><li class="none"><a href="../../j1-users.html">For Jetspeed-1 Users</a></li><li class="none"><a href="../../j1-migration.html">Jetspeed-1 Migration Guideline</a></li><li class="none"><a href="../../supporting-projects.html">Supporting Projects</a></li><li class="none"><a href="../../who-uses-j2.html">Who Uses J2?</a></li><li class="none"><a href="../../portlets-community.html">Portlets Community</a></li><li class="none"><a href="../../how-to-help.html">How to Help?</a></li></ul></div><div id="menuSupport"><h5>Support</h5><ul><li class="none"><a href="../../mail-lists.html">Mailing List</a></li><li class="none"><a href="../../issue-tracking.html">Bug Database</a></li><li class="none"><a href="http://wiki.apache.org/portals/Jetspeed2" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="
../../faq.html">FAQ</a></li></ul></div><div id="menuTranslation"><h5>Translation</h5><ul><li class="none"><a href="http://jetspeed-japan.sourceforge.jp/jetspeed-2-trans/ja/index.html" class="externalLink" title="External Link">Japanese</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../../index.html">About Jetspeed 2 Enterprise Portal</a></li><li class="collapsed"><a href="../../project-info.html">Project Info</a></li><li class="collapsed"><a href="../../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Building_a_Custom_Jet
speed_Portal_With_Maven-2"></a><h2>Building a Custom Jetspeed Portal With Maven-2</h2><ul>
+ <li>
+ <a href="#Introduction">Introduction</a>
+ <ul>
+ <li><a href="#Purpose">Purpose</a></li>
+ <li><a href="#Software_Requirements">Software Requirements</a></li>
+ <li><a href="#The_Jet_Express_Custom_Portal_Project">The Jet Express Custom Portal Project</a></li>
+ <li><a href="#Environment">Environment</a></li>
+ </ul>
+ </li>
+ <li>
+ <a href="#Building_With_Maven-2">Building with Maven-2</a>
+ <ul>
+ <li><a href="#The_Maven-2_Repository">The Maven-2 Repository</a></li>
+ <li><a href="#The_Portal_Archetype_-_Creating_Your_Custom_Project">The Portal Archetype - Creating your Custom Project</a></li>
+ <li><a href="#The_Jet_Express_Custom_Portal">The Jet Express Custom Portal</a>
+ <ul>
+ <li>Step One: create the custom portal project</li>
+ <li>Step Two: create a portlet application project</li>
+ <li>Step Three: create the eclipse project files</li>
+ <li>Step Four: create the default PSML pages</li>
+ <li>Step Five: create the custom decorators</li>
+ <li>Step Six: add your new portlet application (Jet Express 2) to build</li>
+ <li>Step Seven: deploy your portal and portlet application</li>
+ <li>Optional Step: enable automated EAR build</li>
+ </ul>
+ </li>
+ <li><a href="#Redeploying_The_Portlet_Application">Redeploying the Portlet Application</a></li>
+ </ul>
+ </li>
+ <li><a href="#Revision_History">Revision History</a></li>
+ </ul></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>
+ This document is a step by step guide to building a custom Apache Portals Jetspeed-2 portal with Maven-2.
+ The Maven-2 project provided with this document will:
+ <ol>
+ <li>Build a custom portal</li>
+ <li>Build a custom portlet application</li>
+ <li>Populate the database</li>
+ <li>Create distributable deployment archives for Websphere
+ 6.1 and Tomcat 5</li>
+ </ol>
+ </p><p>
+ This document is for Maven-2 build systems. To build with Maven-2, see
+ the accompanying document "Building Custom a Jetspeed Portal with
+ Maven-1"
+ </p><p>
+ For documentation on deploying the WAR and EAR files created here, see
+ the document "Deploying Jetspeed to Websphere"
+ </p><div class="subsection"><a name="Purpose"></a><h3>Purpose</h3><p>
+ This document will teach you how to build and configure a custom Jetspeed Portal and create deployable archives for Websphere 6.1 and Tomcat 5. The complete source code, projects and deployment environment are described in this document. Deployments are based upon the J2EE standard "Web Application" and "Enterprise Application" deployment. The build is based on the Apache Portals Jetspeed-2 "Maven-2 Custom Build".
+ </p><p>
+ Jetspeed is an open source project, thus all source code is freely available from Apache. See the website for more details: <a href="http://portals.apache.org/jetspeed-2/" class="externalLink" title="External Link">http://portals.apache.org/jetspeed-2/</a>
+ </p><p>
+ This document assumes that the user is familiar with open source Java development. In particular the Apache Software Foundation (ASF) and the essential Apache open source projects:
+ <ol>
+ <li>Apache Portals <a href="http://portals.apache.org" class="externalLink" title="External Link">http://portals.apache.org</a> and subprojects:
+ <ol>
+ <li>Jetspeed-2</li>
+ <li>Bridges</li>
+ <li>Pluto</li>
+ </ol>
+ </li>
+ <li>Ant (<a href="http://ant.apache.org" class="externalLink" title="External Link">http://ant.apache.org</a>)</li>
+ <li>Maven-2 (<a href="http://maven.apache.org" class="externalLink" title="External Link">http://maven.apache.org</a>)</li>
+ <li>Apache Tomcat Web Server (<a href="http://tomcat.apache.org" class="externalLink" title="External Link">http://tomcat.apache.org</a>)</li>
+ <li>IBM Websphere Application Server</li>
+ </ol>
+ </p></div><div class="subsection"><a name="Software_Requirements"></a><h3>Software Requirements</h3><table class="bodyTable"><tr class="a"><td>Product</td><td>Version</td></tr><tr class="b"><td>Ant</td><td>1.6.5 or higher</td></tr><tr class="a"><td>Eclipse</td><td>3.1.1 or higher</td></tr><tr class="b"><td>Maven</td><td>2.0.4 or higher</td></tr><tr class="a"><td>Sun JDK</td><td>1.4.2 or 1.5</td></tr><tr class="b"><td>Tomcat</td><td>5.5.12 (with Java 1.4 compatibility) or higher</td></tr><tr class="a"><td>IBM Websphere</td><td>6.1.0.2 or higher</td></tr></table></div><div class="subsection"><a name="The_Jet_Express_Custom_Portal_Project"></a><h3>The Jet Express Custom Portal Project</h3><p>
+ The example project accompanying this document is called Jet Express. It is a custom Jetspeed portal project. Custom projects are how you build a customized version of Jetspeed. With a custom project, you can override:
+ <ul>
+ <li>Spring configuration of your portal</li>
+ <li>Database connection</li>
+ <li>Portal decorations and layouts</li>
+ <li>Version of Jetspeed to integrate with</li>
+ <li>The context name of the portal</li>
+ </ul>
+ </p><p>
+ Here is what the customized portal will look like after it is built:
+ <br></br>
+ <img src="images/custom-portal-build.png" alt=""></img>
+ </p><p>
+ As you can see, it doesn?t look like the default Jetspeed portal that you can download from Apache. Custom builds are best for developers to integrate their own portlet applications and portal features into a customized build environment.
+ </p><p>
+ The Jet Express project contains the following sub project builds:
+ <ul>
+ <li>The Portal build ? builds a customized version of Jetspeed using the Portal Archetype.</li>
+ <li>The Express Demo build ? builds a demo portlet application</li>
+ </ul>
+ </p><p>
+ With this build environment, you will be able to build both a portal and a portlet application. By following the examples in this document, the goal is to teach you how to create your own custom portal with a similar custom build project as Jet Express.
+ </p></div><div class="subsection"><a name="Environment"></a><h3>Environment</h3><p>
+ The system path will need to include Java, Maven and Ant.
+ </p><p>
+ Under Windows XP, the Environment Variables and the System Path is modified by going to the <i>Start Menu -> Settings -> Control Panel -> System -> Advanced -> Environment</i> Variables.
+ </p><p>
+ Note: You need administrative privileges to be allowed to modify system environment variables.
+ </p><p>
+ With these settings configured, you then have to make your system Windows PATH variable based on the executable directories for:
+ <ol>
+ <li>Maven</li>
+ <li>Ant</li>
+ <li>Java</li>
+ </ol>
+ Make sure you can go to a command line and type:
+ </p><p>
+
+ <div class="source"><pre>mvn -v</pre></div>
+
+ </p><p>
+ This command should display the current version of Maven-2.
+ </p></div></div><div class="section"><a name="Building_with_Maven-2"></a><h2>Building with Maven-2</h2><p>
+ The build environment uses the Maven-2 project management tool (<a href="http://maven.apache.org" class="externalLink" title="External Link">http://maven.apache.org</a>). One thing that Maven does well is managing Java jar files and maintaining versions of those files. Maven stores all jar files for almost every known open source project on the planet in a set of distributed repositories on the internet. Maven project descriptors reference specific versions of the jars, and the jars are downloaded to a local repository in order to build the system.
+ </p><div class="subsection"><a name="The_Maven-2_Repository"></a><h3>The Maven-2 Repository</h3><p>
+ By default Maven looks for the local repository in a directory named ".m2" found under your Home directory which on Windows XP usually is found under the "Documents and Settings" directory.
+ </p><p>
+ We have provided a distribution of the entire Maven-2 repository required to build your custom portal. Simply unzip the <i>repository.zip</i> file into your <code>$HOME/.m2/repository</code> directory. You are now ready to start building with Maven and Jetspeed.
+ </p></div><div class="subsection"><a name="The_Portal_Archetype_-_Creating_your_Custom_Project"></a><h3>The Portal Archetype - Creating your Custom Project</h3><p>
+ The first step is to create a new portal project. In our example, we create a new custom Jetspeed project named "jetexpress-2". Archetypes are Maven templates for creating other Maven kinds of projects. Jetspeed provides several archetypes:
+ <ul>
+ <li><i>Portal</i> archetype -creates a Jetspeed custom portal project</li>
+ <li><i>Application</i> archetype - creates a portlet application project</li>
+ <li><i>Component</i> archetype - create a general <a href="http://www.springsource.org" class="externalLink" title="External Link">Spring</a> component project</li>
+ <li><i>Shared Jetspeed component</i> archetype - create a Jetspeed shared component project</li>
+ </ul>
+ </p><p>
+ From the directory above where you want to create the project, issued this command:
+ </p><p>
+
+ <div class="source"><pre>
+ mvn archetype:create
+ -DarchetypeGroupId=org.apache.portals.jetspeed-2
+ -DarchetypeArtifactId=portal-archetype -DarchetypeVersion=2.1-dev
+ -DgroupId=bluesunrise
+ -DartifactId=jetexpress-2
+ -Dversion=1.0
+ </pre></div>
+
+ </p><p>
+ This command will create a new subdirectory named "jetexpress-2". Under that subdirectory, you will find the shell for a complete Jetspeed portal custom project.
+ </p><p>
+ Note that this and other archetypes can issue many harmless warnings while expanding. Please ignore the warnings unless the expansion of the archetype template fails. When complete, the portal archetype expansion will contain the following structure within a directory named as the specified artifactId relative to the current working directory:
+ <ul>
+ <li><i><artifactId>/applications</i> - conventional subdirectory for portal application war modules.</li>
+ <li><i><artifactId>/app-servers</i> - contains portal deployment builds and resources.</li>
+ <li><i><artifactId>/components</i> - conventional subdirectory for portal component jar modules.</li>
+ <li><i><artifactId>/etc/assembly</i> - custom portal application component Spring assemblies.</li>
+ <li><i><artifactId>/conf</i> - portal application context configuration files.</li>
+ <li><i><artifactId>/etc/decorations</i> - custom decorations in images, layout, and portlet subdirectories.</li>
+ <li><i><artifactId>/etc/pages</i> - custom portal PSML pages augment/override minimal defaults, (e.g. <i>/Administrative/**, /default-page.psml, /myaccount.psml, /page.security, and /system/**</i>).</li>
+ <li><i><artifactId>/etc/schema</i> - Jetspeed-2 database schema definitions.</li>
+ <li><i><artifactId>/etc/sql</i> - Jetspeed-2 base database configuration scripts.</li>
+ <li><i><artifactId>/etc/templates</i> - custom overrides for Jetspeed-2 layout portlet templates.</li>
+ <li><i><artifactId>/etc/webapp</i> - custom content resources to be packaged with portal application.</li>
+ <li><i><artifactId>/portal</i> - portal application war build scripts and webapp resource overrides.</li>
+ <li><i><artifactId>/src</i> - these directories are an artifact of archetype expansion and should be deleted.</li>
+ </ul>
+ </p><p>
+ The archetype also contains a <i>settings.xml.sample</i> that is a subset of the Jetspeed-2 source build parameters. If one has not previously configured the <i>~/.m2/settings.xml</i> file as described above, this sample can be used to do so without J2 test configurations.
+ </p><p>
+ The first step in using the Maven2 build is to either:
+ <ol>
+ <li>copy the <i>settings.xml.sample</i> to <i>~/.m2/settings.xml</i>, or</li>
+ <li>incorporate the settings in this file into your existing Maven2 configuration by copying <i>settings.xml.sample</i> to <i>settings.xml</i></li>
+ </ol>
+ </p><p>
+ For our example, we are going to copy over pre-configured resources, including the <i>settings.xml</i> on top of our project to make the tutorial more useful.
+ </p></div><div class="subsection"><a name="The_Jet_Express_Custom_Portal"></a><h3>The Jet Express Custom Portal</h3><p>
+ The Jet Express project has already been created for you. We ran the <i>archetype:create</i> command, then created all the resources and portlets to make up our custom portal. Lets go through the steps we went through, so that you can apply these same steps to your custom build.
+ </p><p>
+ NOTE: the steps below are not necessary with the training material
+ </p><h3>Step One: create the custom portal project</h3><p>
+ Create your portal application by running <i>archetype:create</i> for example:
+ </p><p>
+
+ <div class="source"><pre>mvn archetype:create
+ -DarchetypeGroupId=org.apache.portals.jetspeed-2
+ -DarchetypeArtifactId=portal-archetype -DarchetypeVersion=2.1-dev
+ -DgroupId=bluesunrise
+ -DartifactId=jetexpress-2
+ -Dversion=1.0
+ </pre></div>
+
+ </p><p>
+ This command will create a new subdirectory named "jetexpress-2". Under that subdirectory, you will find the shell for a complete Jetspeed portal custom project.
+ </p><h3>Step Two: create a portlet application project</h3><p>
+ Jetspeed also have an archetype for creating a portlet application:
+ </p><p>
+
+ <div class="source"><pre>mvn archetype:create
+ -DarchetypeGroupId=org.apache.portals.jetspeed-2
+ -DarchetypeArtifactId=application-archetype
+ -DarchetypeVersion=2.1-dev
+ -DgroupId=bluesunrise
+ -DartifactId=express-demo2
+ -Dversion=1.0
+ </pre></div>
+
+ </p><p>
+ The training material comes with a full express-demo2 portlet application. We have already written the portlets.
+ </p><h3>Step Three: create the eclipse project files</h3><p>
+ Maven can create the eclipse project files for you:
+ </p><p>
+
+ <div class="source"><pre>mvn eclipse:eclipse</pre></div>
+
+ </p><h3>Step Four: create the default PSML pages</h3><p>
+ PSML pages go in the portal/src/webapp/WEB-INF/pages directory by default:
+ <img src="images/webinf-structure-psml.png" alt=""></img>
+ </p><p>
+ Usually each portal has a set of default PSML pages. The users will create their own pages as they use the system.
+ </p><h3>Step Five: create the custom decorators</h3><p>
+ Decorators go in the <i>portal/src/webapp/decorators</i> directory by default:
+ <img src="images/webinf-structure-decorators.png" alt=""></img>
+ </p><p>
+ Here we have two kinds of decorators: page (layout) and portlet decorators. We have defined one of each. The page decorator defines the skin for the pages in our portal. The portlet decorator defines the default skin for the portlets.
+ </p><h3>Step Six: add your new portlet application (Jet Express 2) to the build</h3><p>
+ We need to edit a few files to help automate the Maven build so that it automatically deploys the Jet Express 2 portlet applications. Edit the <i>applications/pom.xml</i> file:
+ </p><p>
+
+ <div class="source"><pre>
+<modules>
+ <module>express-demo2</module>
+</modules>
+ </pre></div>
+
+ </p><p>
+ Edit the root <i>pom.xml</i> file:
+ </p><p>
+
+ <div class="source"><pre>
+
+<dependencyManagement>
+ <dependencies>
+ ...
+ <dependency>
+ <groupId>${pom.groupId}</groupId>
+ <artifactId>express-demo2</artifactId>
+ <type>war</type>
+ <version>${pom.version}</version>
+ </dependency>
+ </pre></div>
+
+ </p><p>
+ Finally, for deployment, add your new portlet application to the <i>app-servers</i> POM found under <i>app-servers/pom.xml</i>:
+ </p><p>
+
+ <div class="source"><pre>
+
+<!-- custom portlet app -->
+<dependency>
+ <groupId>${pom.groupId}</groupId>
+ <artifactId>express-demo2</artifactId>
+ <type>war</type>
+ <version>${pom.version}</version>
+</dependency>
+ </pre></div>
+
+ </p><p>
+ To hot deploy your custom portlet application to Tomcat, add it to the <i>app-servers</i> Ant script for Tomcat:
+ </p><p>
+
+ <div class="source"><pre>
+<target name="hot-deploy-apps">
+...
+ <antcall target="hot-deploy-war">
+ <param name="org.apache.jetspeed.deploy.groupid" value="${portal.groupid}"/>
+ <param name="org.apache.jetspeed.deploy.artifactid" value="express-demo2"/>
+ <param name="org.apache.jetspeed.deploy.version" value="${portal.version}"/>
+ </antcall>
+ </pre></div>
+
+ </p><h3>Step Seven: deploy your portal and portlet application</h3><p>
+ Now you are ready to deploy your new portal and portlet application. In this example, we will deploy to Tomcat:
+ </p><p>
+ <code>mvn ?P tomcat</code>
+ </p><p>
+ Startup Tomcat, and go to:
+ </p><p>
+ <code>http://localhost:8080/jetexpress-2</code>
+ </p><p>
+ <img src="images/startupscreen.png" alt=""></img>
+ </p><h3>Optional Step: enable automated EAR build</h3><p>
+ By default, only WAR files are generated. To generate an EAR file, edit the root <i>pom.xml</i> and uncomment this line:
+ </p><p>
+
+ <div class="source"><pre>
+
+ <module>enterprise</module>
+ </pre></div>
+
+ </p><p>
+ The EAR file will be generated into the <i>enterprise/target</i> directory.
+ </p><p>
+ You can deploy the generated EAR file as is into Websphere. We have tested this EAR with Websphere 6.1. Please read the accompanying document,
+ "Deploying Jetspeed to Websphere.doc" for more information.
+ </p></div><div class="subsection"><a name="Redeploying_the_Portlet_Application"></a><h3>Redeploying the Portlet Application</h3><p>
+ For fast servlet and portlet development, nothing seems to beat developing with Tomcat.
+ Say you make a change to a Java class in the Express Demo portlet application. To build and redeploy:
+ </p><p>
+
+ <div class="source"><pre>
+ cd applications
+ cd express-demo2
+ mvn
+ copy target\express-demo2-1.0.war \JetspeedTraining\tomcat5\webapps\express-demo2.war
+ </pre></div>
+
+ </p><p>
+ Wait a few seconds, and your changes should be deployed by Tomcat.
+ </p></div></div><div class="section"><a name="Revision_History"></a><h2>Revision History</h2><table class="bodyTable"><tr class="b"><td>Revision</td><td>Date</td><td>Author</td><td>Comments</td></tr><tr class="a"><td>0.1</td><td>2006-10-24</td><td>David Sean Taylor</td><td>Initial draft</td></tr></table></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1999-2009, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/guide-building-custom-portal-maven2.html
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/startupscreen.png
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/startupscreen.png?rev=1422709&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/startupscreen.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/startupscreen.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-decorators.png
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-decorators.png?rev=1422709&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-decorators.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-decorators.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-psml.png
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-psml.png?rev=1422709&view=auto
==============================================================================
Binary file - no diff available.
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-psml.png
------------------------------------------------------------------------------
svn:executable = *
Propchange: portals/site-live/jetspeed-2.1.3/tutorials/stepbystep/images/webinf-structure-psml.png
------------------------------------------------------------------------------
svn:mime-type = image/png
Added: portals/site-live/jetspeed-2.1.3/usersguide/aboutuserguide.html
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/aboutuserguide.html?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/aboutuserguide.html (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/aboutuserguide.html Sun Dec 16 22:54:22 2012
@@ -0,0 +1,72 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Jetspeed 2 Enterprise Portal - About Jetspeed Users Guide</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-j2.css");@import url("../style/project.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://portals.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://portals.apache.org/images/apache-portals.gif"></img></a><a href="http://portals.apache.org/jetspeed-2" id="projectLogo"><img alt="Jetspeed 2 Enterprise Portal" src="http://portals.apache.org/images/Jetspeed_blue_med.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 23 April 2009
+ | Doc for 2.1.3</div><div class="xright">
+
+ <a href="../index.html">Main Docs</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../adminguide/index.html">Admin Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../deployguide/index.html">Deployement Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../devguide/index.html">Developers Guide</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuIntroduction"><h5>Introduction</h5><ul><li class="none"><a href="../usersguide/index.html">Welcome</a></li><li class="none"><a href="../usersguide/aboutuserguide.html">About this guide</a></li><li class="none"><a href="../usersguide/definitions.html">Definitions</a></li></ul></div><div id="menuUsing_Jetspeed"><h5>Using Jetspeed</h5><ul><li class="none"><a href="../usersguide/gettingstarted.html">Getting Started</a></li><li class="none"><a href="../usersguide/portalnavigation.html">Navigation</a></li><li class="none"><a href="../usersguide/portletmodes.html">Portlet Modes and Action Bar</a></li><li class="none"><a href="../usersguide/logout.html">Logging out</a></li></ul></div><div id="menuCustomizing"><h5>Customizing</h5><ul><li class="none"><a href="../usersguide/decorators.html">Decorators</a></li><li class="none"><a href="../usersguide/portlets.html">Portlets</a></li>
<li class="none"><a href="../usersguide/tabs.html">Tabs</a></li><li class="none"><a href="../usersguide/menu.html">Menu</a></li><li class="none"><a href="../usersguide/desktop.html">Desktop</a></li></ul></div><div id="menuSupport"><h5>Support</h5><ul><li class="none"><a href="../mail-lists.html">Mailing List</a></li><li class="none"><a href="../issue-tracking.html">Bug Database</a></li><li class="none"><a href="http://wiki.apache.org/portals/Jetspeed2" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../index.html">About Jetspeed 2 Enterprise Portal</a></li><li class="collapsed"><a href="../project-info.html">Project Info</a></li><li class="collapsed"><a href="../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="Exte
rnal Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="About_this_guide"></a><h2>About this guide</h2><p>
+ This User guide is designed for people who are new to Jetspeed or as a reference for navigating
+ through the Jetspeed interface while logged in as a regular user. This guide is meant to be
+ a foundation for those who wish to continue with the Admin guide, Deployers guide and
+ Developers guide. Some concepts, such as security, may cross several guides but will be
+ structured for the Role of that particular guide.
+ </p><p>
+ After reading this guide, the user will be able to:
+ <ul>
+ <li>Create a new user</li>
+ <li>Login to Jetspeed</li>
+ <li>Request a forgotten password</li>
+ <li>Change the language used in Jetspeed</li>
+ <li>Minimize, maximize and restore portlet windows</li>
+ <li>Edit a portlet's preferences</li>
+ <li>Add, move and remove portlets</li>
+ <li>Change the decorators of Jetspeed</li>
+ <li>Change the decorators of individual portlets</li>
+ <li>Create and delete tabs</li>
+ <li>Create and delete folders</li>
+ <li>Navigate through menu's and pages</li>
+ <li>Use breadcrumbs to navigate folders</li>
+ <li>Switch between Jetpeed desktop and portal</li>
+ <li>Use Jetspeed desktop</li>
+ <li>Logout of Jetspeed</li>
+ </ul>
+ </p><div class="subsection"><a name="User_Guide"></a><h3>User Guide</h3><p>
+ The User guide will not cover aspects relating to the Admin guide, Deployers guide or Developers
+ guide. The User guide will focus on introducing the user to the means to log into the portal, navigate
+ within the portal and customize the look and feel of the portal. A definitions page is included
+ for important words or concepts that will make the guide more understandable for those unfamiliar with
+ Portal's or Jetspeed.
+ </p></div><div class="subsection"><a name="Admin_Guide"></a><h3>Admin Guide</h3><p>
+ The Admin guide will not cover topics addressed in the User guide. This guide will be focused on any
+ configuration and managment options that can be altered while Jetspeed is running. The administrator
+ will have full access to configuring users, groups and roles through the administrative portlets.
+ </p></div><div class="subsection"><a name="Deployers_Guide"></a><h3>Deployers Guide</h3><p>
+ The Deployers guide will not cover topics addressed in the User or Admin guide. This guide will address
+ Administrative and Configuration tasks that can not occur while Jetspeed is running. A section of this guide
+ will be dedicated to deploying Jetspeed on Websphere.
+ </p></div><div class="subsection"><a name="Developers_Guide"></a><h3>Developers Guide</h3><p>
+ The Developers guide will not cover topics addressed in the User, Admin or Deployers guide.
+ </p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1999-2009, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/aboutuserguide.html
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/usersguide/css/maven-base.css
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/css/maven-base.css?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/css/maven-base.css (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/css/maven-base.css Sun Dec 16 22:54:22 2012
@@ -0,0 +1,143 @@
+body {
+ margin: 0px;
+ padding: 0px;
+}
+img {
+ border:none;
+}
+table {
+ padding:0px;
+ width: 100%;
+ margin-left: -2px;
+ margin-right: -2px;
+}
+acronym {
+ cursor: help;
+ border-bottom: 1px dotted #feb;
+}
+table.bodyTable th, table.bodyTable td {
+ padding: 2px 4px 2px 4px;
+ vertical-align: top;
+}
+div.clear{
+ clear:both;
+ visibility: hidden;
+}
+div.clear hr{
+ display: none;
+}
+#bannerLeft, #bannerRight {
+ font-size: xx-large;
+ font-weight: bold;
+}
+#bannerLeft img, #bannerRight img {
+ margin: 0px;
+}
+.xleft, #bannerLeft img {
+ float:left;
+}
+.xright, #bannerRight {
+ float:right;
+}
+#banner {
+ padding: 0px;
+}
+#banner img {
+ border: none;
+}
+#breadcrumbs {
+ padding: 3px 10px 3px 10px;
+}
+#leftColumn {
+ width: 170px;
+ float:left;
+ overflow: auto;
+}
+#bodyColumn {
+ margin-right: 1.5em;
+ margin-left: 197px;
+}
+#legend {
+ padding: 8px 0 8px 0;
+}
+#navcolumn {
+ padding: 8px 4px 0 8px;
+}
+#navcolumn h5 {
+ margin: 0;
+ padding: 0;
+ font-size: small;
+}
+#navcolumn ul {
+ margin: 0;
+ padding: 0;
+ font-size: small;
+}
+#navcolumn li {
+ list-style-type: none;
+ background-image: none;
+ background-repeat: no-repeat;
+ background-position: 0 0.4em;
+ padding-left: 16px;
+ list-style-position: outside;
+ line-height: 1.2em;
+ font-size: smaller;
+}
+#navcolumn li.expanded {
+ background-image: url(../images/expanded.gif);
+}
+#navcolumn li.collapsed {
+ background-image: url(../images/collapsed.gif);
+}
+#poweredBy {
+ text-align: center;
+}
+#navcolumn img {
+ margin-top: 10px;
+ margin-bottom: 3px;
+}
+#poweredBy img {
+ display:block;
+ margin: 20px 0 20px 17px;
+}
+#search img {
+ margin: 0px;
+ display: block;
+}
+#search #q, #search #btnG {
+ border: 1px solid #999;
+ margin-bottom:10px;
+}
+#search form {
+ margin: 0px;
+}
+#lastPublished {
+ font-size: x-small;
+}
+.navSection {
+ margin-bottom: 2px;
+ padding: 8px;
+}
+.navSectionHead {
+ font-weight: bold;
+ font-size: x-small;
+}
+.section {
+ padding: 4px;
+}
+#footer {
+ padding: 3px 10px 3px 10px;
+ font-size: x-small;
+}
+#breadcrumbs {
+ font-size: x-small;
+ margin: 0pt;
+}
+.source {
+ padding: 12px;
+ margin: 1em 7px 1em 7px;
+}
+.source pre {
+ margin: 0px;
+ padding: 0px;
+}
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/css/maven-base.css
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/usersguide/css/maven-theme.css
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/css/maven-theme.css?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/css/maven-theme.css (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/css/maven-theme.css Sun Dec 16 22:54:22 2012
@@ -0,0 +1,237 @@
+/*
+ * 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.
+ */
+
+body {
+ padding: 0px 0px 10px 0px;
+}
+body, td, select, input, li{
+ font-family: Verdana, Helvetica, Arial, sans-serif;
+ font-size: 13px;
+}
+code{
+ font-family: Courier, monospace;
+ font-size: 13px;
+}
+a {
+ text-decoration: none;
+}
+a:link {
+ color:#36a;
+}
+a:visited {
+ color:#47a;
+}
+a:active, a:hover {
+ color:#69c;
+}
+#legend li.externalLink {
+ background: url(../images/external.png) left top no-repeat;
+ padding-left: 18px;
+}
+a.externalLink, a.externalLink:link, a.externalLink:visited, a.externalLink:active, a.externalLink:hover {
+ background: url(../images/external.png) right center no-repeat;
+ padding-right: 18px;
+}
+#legend li.newWindow {
+ background: url(../images/newwindow.png) left top no-repeat;
+ padding-left: 18px;
+}
+a.newWindow, a.newWindow:link, a.newWindow:visited, a.newWindow:active, a.newWindow:hover {
+ background: url(../images/newwindow.png) right center no-repeat;
+ padding-right: 18px;
+}
+h2 {
+ padding: 4px 4px 4px 6px;
+ border: 1px solid #999;
+ color: #363738;
+ background-color: #f2f2f2;
+ font-weight:900;
+}
+h3 {
+ padding: 4px 4px 4px 6px;
+ border: 1px solid #aaa;
+ color: #363738;
+ background-color: #f2f2f2;
+}
+h4 {
+ padding: 4px 4px 4px 6px;
+ border: 1px solid #bbb;
+ color: #363738;
+ background-color: #f2f2f2;
+}
+h5 {
+ padding: 4px 4px 4px 6px;
+ color: #363738;
+}
+p {
+ line-height: 1.3em;
+ font-size: small;
+}
+#breadcrumbs {
+ color:#ffffff;
+ background-color: #05549c;
+ border-top-width: 2px;
+ border-top-style: solid;
+ border-top-color: #033563;
+}
+
+#breadcrumbs a {
+ color: #ced7dc;
+ text-decoration: none;
+}
+#breadcrumbs a:hover {
+ color: #f5f7f8;
+ text-decoration: underline;
+}
+
+#leftColumn {
+ margin: 10px 0 0 5px;
+}
+#navcolumn h5 {
+ font-size: smaller;
+ padding-top: 2px;
+
+ border-bottom-width: 1px;
+ border-bottom-style: solid;
+ border-bottom-color: #afafaf;
+ color: #303031;
+
+ margin-top:2px;
+ margin-bottom:2px;
+}
+
+#navcolumn a {
+ color: #012d46;
+ text-decoration: none;
+}
+
+#navcolumn a:active, #navcolumn a:hover {
+ color: #000000;
+ text-decoration: underline;
+}
+
+#navcolumn ul {
+ margin-bottom:2px;
+}
+
+#navcolumn ul li {
+ margin-top:1px;
+ margin-bottom:1px;
+}
+
+table.bodyTable th {
+ color: white;
+ background-color: #bbb;
+ text-align: left;
+ font-weight: bold;
+}
+
+table.bodyTable th, table.bodyTable td {
+ font-size: 1em;
+}
+
+table.bodyTable tr.a {
+ background-color: #ddd;
+}
+
+table.bodyTable tr.b {
+ background-color: #eee;
+}
+
+.source {
+ border: 1px solid #999;
+}
+dl {
+ padding: 4px 4px 4px 6px;
+ border: 1px solid #aaa;
+ background-color: #ffc;
+}
+dt {
+ color: #900;
+}
+#organizationLogo img, #projectLogo img, #projectLogo span{
+ margin: 8px;
+}
+#banner {
+ border-bottom:none;
+ padding:8px;
+ background-color:#000000;
+}
+.errormark, .warningmark, .donemark, .infomark {
+ background: url(../images/icon_error_sml.gif) no-repeat;
+}
+
+.warningmark {
+ background-image: url(../images/icon_warning_sml.gif);
+}
+
+.donemark {
+ background-image: url(../images/icon_success_sml.gif);
+}
+
+.infomark {
+ background-image: url(../images/icon_info_sml.gif);
+}
+
+/*
+----------------------
+Project Style
+----------------------
+*/
+
+#downloadbox {
+ float: right;
+ margin: 0 10px 20px 20px;
+ padding: 5px;
+ border: 1px solid #999;
+ background-color: #eee;
+}
+
+#downloadbox {
+ float: right;
+ margin: 0 10px 20px 20px;
+ padding: 5px;
+ border: 1px solid #999;
+ background-color: #eee;
+}
+
+#downloadbox h5 {
+ color: #000;
+ margin: 0;
+ border-bottom: 1px solid #aaaaaa;
+ font-size: smaller;
+ padding: 0;
+}
+
+#downloadbox p {
+ margin-top: 1em;
+ margin-bottom: 0;
+}
+
+#downloadbox ul {
+ margin-top: 0;
+ margin-bottom: 1em;
+ list-style-type: disc;
+}
+
+#downloadbox li {
+ font-size: smaller;
+}
+
+
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/css/maven-theme.css
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/usersguide/css/print.css
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/css/print.css?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/css/print.css (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/css/print.css Sun Dec 16 22:54:22 2012
@@ -0,0 +1,7 @@
+#banner, #footer, #leftcol, #breadcrumbs, .docs #toc, .docs .courtesylinks, #leftColumn, #navColumn {
+ display: none !important;
+}
+#bodyColumn, body.docs div.docs {
+ margin: 0 !important;
+ border: none !important
+}
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/css/print.css
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/usersguide/css/site.css
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/css/site.css?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/css/site.css (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/css/site.css Sun Dec 16 22:54:22 2012
@@ -0,0 +1 @@
+/* You can override this file with your own styles */
\ No newline at end of file
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/css/site.css
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/usersguide/decorators.html
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/decorators.html?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/decorators.html (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/decorators.html Sun Dec 16 22:54:22 2012
@@ -0,0 +1,95 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Jetspeed 2 Enterprise Portal - Jetspeed Users Guide - Decorators</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-j2.css");@import url("../style/project.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://portals.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://portals.apache.org/images/apache-portals.gif"></img></a><a href="http://portals.apache.org/jetspeed-2" id="projectLogo"><img alt="Jetspeed 2 Enterprise Portal" src="http://portals.apache.org/images/Jetspeed_blue_med.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 23 April 2009
+ | Doc for 2.1.3</div><div class="xright">
+
+ <a href="../index.html">Main Docs</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../adminguide/index.html">Admin Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../deployguide/index.html">Deployement Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../devguide/index.html">Developers Guide</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuIntroduction"><h5>Introduction</h5><ul><li class="none"><a href="../usersguide/index.html">Welcome</a></li><li class="none"><a href="../usersguide/aboutuserguide.html">About this guide</a></li><li class="none"><a href="../usersguide/definitions.html">Definitions</a></li></ul></div><div id="menuUsing_Jetspeed"><h5>Using Jetspeed</h5><ul><li class="none"><a href="../usersguide/gettingstarted.html">Getting Started</a></li><li class="none"><a href="../usersguide/portalnavigation.html">Navigation</a></li><li class="none"><a href="../usersguide/portletmodes.html">Portlet Modes and Action Bar</a></li><li class="none"><a href="../usersguide/logout.html">Logging out</a></li></ul></div><div id="menuCustomizing"><h5>Customizing</h5><ul><li class="none"><a href="../usersguide/decorators.html">Decorators</a></li><li class="none"><a href="../usersguide/portlets.html">Portlets</a></li>
<li class="none"><a href="../usersguide/tabs.html">Tabs</a></li><li class="none"><a href="../usersguide/menu.html">Menu</a></li><li class="none"><a href="../usersguide/desktop.html">Desktop</a></li></ul></div><div id="menuSupport"><h5>Support</h5><ul><li class="none"><a href="../mail-lists.html">Mailing List</a></li><li class="none"><a href="../issue-tracking.html">Bug Database</a></li><li class="none"><a href="http://wiki.apache.org/portals/Jetspeed2" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../index.html">About Jetspeed 2 Enterprise Portal</a></li><li class="collapsed"><a href="../project-info.html">Project Info</a></li><li class="collapsed"><a href="../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="Exte
rnal Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Decorators"></a><h2>Decorators</h2><ul>
+ <li>The portal design, or skins, are known in Jetspeed as decorators. With decorators, you can customize the portal experience to the branding of your organization.</li>
+ <li>There are two different types of decorators: Page Decorator and Portlet Decorator</li>
+ <ul>
+ <li>Page Decorators decorate the entire page</li>
+ <li>Portlet Decorators decorator individual portlets</li>
+ </ul>
+ </ul><div class="subsection"><a name="Page_Decorators"></a><h3>Page Decorators</h3><ul>
+ <li>Each Jetspeed page can be associated with a different page decoration. That said, it is recommended that you set page decorations at the folder, even root folder level.</li>
+ <li>Decorations inherit.</li>
+ <li>Page decorators control important aspects of a page:</li>
+ <ul>
+ <li>The colors, images, CSS styles that skin the page.</li>
+ <li>The meta information of a page such as title.</li>
+ <li>The branding of the page, corporate images, colors.</li>
+ <li>Action buttons displayed.</li>
+ <li>Menus and navigational elements.</li>
+ </ul>
+ <p>
+ </p>
+ </ul></div><div class="subsection"><a name="Portlet_Decorators"></a><h3>Portlet Decorators</h3><ul>
+ <li>Each Jetspeed portlet window on a page can be associated with a different portlet decoration.</li>
+ <li>Portlet decorations control some important aspect of a portlet window:</li>
+ <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.</li>
+ </ul>
+ </ul></div><p>In the upper right hand corner of the Jetspeed Portal Window, you will see a Logout link followed by two icons. the first icon is the edit icon, which in this case
+ is our means to access the customization options for the entire portal window. Click on the pencil (edit) icon <img src="images/customize.png" alt=""></img> and you should now see a
+ page similar to the one below.
+ </p><p>
+ <img src="images/newcustomizewindow.png" alt=""></img>
+ </p><div class="subsection"><a name="Page_Folder_Customizer"></a><h3>Page/Folder Customizer</h3><p>
+ The Page/Folder Customizer section has three options for us to configure. Theme will set the decorator for the portal window's tabs, menu and window itself. Layout will
+ allow us to change the amount of columns in our Jetspeed window. The portlet theme is a global setting for all portlets contained in the portal window. This global setting
+ can be overridden by individual portlets within the window. If you do not set the individual portlet decorators they will inherit the Portlet Theme from this section. Tigris is the default
+ decorator for a standard jetspeed installation.
+ </p><p>
+ <img align="top" src="images/smtigris.png" alt=""></img> <img align="top" src="images/dropdownlayout.png" alt=""></img> <img align="top" src="images/smblueocean.png" alt=""></img>
+ </p><p>
+ Notice the Theme drop down menu does not require pushing a change button to make your selection become active. Once you choose an option from the dropdown menu, Jetspeed will render the window
+ with your choice. Only the Layout was affected, not the portlets window.
+ </p></div><div class="subsection"><a name="Layout_Customizer"></a><h3>Layout Customizer</h3><p>
+ Layout allows you to choose multiple column layouts or a single column for the entire window. Jetspeed will remember the locations of portlets when altering this layout. Changing the Layout to put
+ all the portlets into four columns and changing back to two columns will return the portlets back to their original columns.
+ </p><p>
+ <img align="top" src="images/dropdowncolumns.png" alt=""></img>
+ </p><p>
+ <img align="top" src="images/4column.png" alt=""></img> <img align="top" src="images/2column.png" alt=""></img>
+ </p><p>
+ Add Layout will insert layout options within the window with the portlet. This allows
+ you to setup multiple columns within one column. Clicking on add layout added a new Page/Customizer option below the Bookmark Portlet 2 from our
+ previous example. The user can now customize this new layout within the layout using the options provided. You will also notice arrow icons and an X icon. These will be discussed in the Portlets section of
+ Customizing but they are for moving and removing portlets.
+ </p><p>
+ <img src="images/layconfig.png" alt=""></img>
+ </p></div><div class="subsection"><a name="Portlet_Theme_Customizer"></a><h3>Portlet Theme Customizer</h3><p>
+ Portlet Theme will set the decorator for all the portlets in the window. If you have set individual decorators on your portlets, this will reset all portlets in the window to the Portlet Theme you have chosen. You must
+ reset individual portlets after choosing this option if you wish them to have a different decorator. To have Layout and Portlets all using the same theme, you must set them to the same decorator.
+ </p><p>
+ <img align="top" src="images/smtigris2.png" alt=""></img>
+ </p><p>
+ <img align="top" src="images/dropdowntheme.png" alt=""></img><img align="top" src="images/smbluegrad.png" alt=""></img>
+ </p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1999-2009, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/decorators.html
------------------------------------------------------------------------------
svn:executable = *
Added: portals/site-live/jetspeed-2.1.3/usersguide/definitions.html
URL: http://svn.apache.org/viewvc/portals/site-live/jetspeed-2.1.3/usersguide/definitions.html?rev=1422709&view=auto
==============================================================================
--- portals/site-live/jetspeed-2.1.3/usersguide/definitions.html (added)
+++ portals/site-live/jetspeed-2.1.3/usersguide/definitions.html Sun Dec 16 22:54:22 2012
@@ -0,0 +1,76 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Jetspeed 2 Enterprise Portal - Jetspeed Users Guide Definitions</title><style type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import url("../style/maven-j2.css");@import url("../style/project.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://portals.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://portals.apache.org/images/apache-portals.gif"></img></a><a href="http://portals.apache.org/jetspeed-2" id="projectLogo"><img alt="Jetspeed 2 Enterprise Portal" src="http://portals.apache.org/images/Jetspeed_blue_med.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 23 April 2009
+ | Doc for 2.1.3</div><div class="xright">
+
+ <a href="../index.html">Main Docs</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../adminguide/index.html">Admin Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../deployguide/index.html">Deployement Guide</a>
+
+
+
+ <span class="separator">|</span>
+
+
+ <a href="../devguide/index.html">Developers Guide</a>
+ </div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuIntroduction"><h5>Introduction</h5><ul><li class="none"><a href="../usersguide/index.html">Welcome</a></li><li class="none"><a href="../usersguide/aboutuserguide.html">About this guide</a></li><li class="none"><a href="../usersguide/definitions.html">Definitions</a></li></ul></div><div id="menuUsing_Jetspeed"><h5>Using Jetspeed</h5><ul><li class="none"><a href="../usersguide/gettingstarted.html">Getting Started</a></li><li class="none"><a href="../usersguide/portalnavigation.html">Navigation</a></li><li class="none"><a href="../usersguide/portletmodes.html">Portlet Modes and Action Bar</a></li><li class="none"><a href="../usersguide/logout.html">Logging out</a></li></ul></div><div id="menuCustomizing"><h5>Customizing</h5><ul><li class="none"><a href="../usersguide/decorators.html">Decorators</a></li><li class="none"><a href="../usersguide/portlets.html">Portlets</a></li>
<li class="none"><a href="../usersguide/tabs.html">Tabs</a></li><li class="none"><a href="../usersguide/menu.html">Menu</a></li><li class="none"><a href="../usersguide/desktop.html">Desktop</a></li></ul></div><div id="menuSupport"><h5>Support</h5><ul><li class="none"><a href="../mail-lists.html">Mailing List</a></li><li class="none"><a href="../issue-tracking.html">Bug Database</a></li><li class="none"><a href="http://wiki.apache.org/portals/Jetspeed2" class="externalLink" title="External Link">Wiki</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="../index.html">About Jetspeed 2 Enterprise Portal</a></li><li class="collapsed"><a href="../project-info.html">Project Info</a></li><li class="collapsed"><a href="../maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="Exte
rnal Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Definitions"></a><h2>Definitions</h2><p>
+ Definitions and concepts mentioned in User Guide are listed here for reference.
+ </p><div class="subsection"><a name="Decorator"></a><h3>Decorator</h3><p>
+ The portal design, or skins, are known in Jetspeed as decorators. They can also be referred to as Themes.<br></br>
+ <img src="images/decoratordiagram.png" alt=""></img>
+ </p></div><div class="subsection"><a name="Portal"></a><h3>Portal</h3><p>
+ "A portal is a web based application that
+ commonly-provides personalization, single
+ sign on, content aggregation from different
+ sources and hosts the presentation layer of
+ Information Systems. Aggregation is the action
+ of integrating content from different
+ sources within a web page. A portal may have
+ sophisticated personalization features to
+ provide customized content to users. Portal
+ pages may have different set of portlets
+ creating content for different users." JSR-168:PLT.2.1
+ </p><p>
+ A portal based on Jetspeed can make applications, database information
+ and other data sources available to end-users through a single web site.
+ Jetspeed provides a security infrastructure so that the information and
+ functions made available to each user can be customized on basis of the
+ user or a role that the user has. The user can access the portal via a
+ web browser, WAP-phone, pager or any other device supported by the
+ servlet engine.
+ </p></div><div class="subsection"><a name="Portlet"></a><h3>Portlet</h3><p>
+ "A portlet is a Java technology based web component, managed by a
+ portlet container, that processes requests and generates dynamic content.
+ Portlets are used by portals as pluggable user interface components that
+ provide a presentation layer to Information Systems." JSR-168:PLT.2.2
+ </p></div><div class="subsection"><a name="Portlet_Window_Diagram"></a><h3>Portlet Window Diagram</h3><p>
+ <img src="images/portletwindowdiagram.png" alt=""></img>
+ </p></div><div class="subsection"><a name="Roles"></a><h3>Roles</h3><p>
+ Roles are the persona users can take on when interacting with the system. This allows
+ the system to define behaviors by role, not by individual users.
+ </p></div><div class="subsection"><a name="Tiled_Window"></a><h3>Tiled Window</h3><p>
+ A tiled window in Jetspeed is a window that does not overlap any other windows.
+ </p></div><div class="subsection"><a name="Window_States"></a><h3>Window States</h3><p>
+ Window States indicate the amount of the portal page
+ space that will be assigned to the generated
+ content of a portlet.
+ <ul>
+ <li>Normal - indicates the portlet may be sharing the rendering of the page.</li>
+ <li>Minimized - the portlet should only render minimal or no output at all.</li>
+ <li>Maximized - indicates the portlet that the portlet may be the only portlet being rendered. A portlet may generate richer content in this state.</li>
+ </ul>
+ </p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 1999-2009, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Propchange: portals/site-live/jetspeed-2.1.3/usersguide/definitions.html
------------------------------------------------------------------------------
svn:executable = *