Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/desktop.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/desktop.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/desktop.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/desktop.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,87 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Desktop"> + <p> + Jetspeed Desktop and Jetspeed Portal run concurrently when Jetspeed has been started. Switching back and forth between the two is + as easy as changing the URL in your web browser. Our example has been using http://localhost:8080/jetspeed/portal as the url for access to the portal. + Change the url to http://localhost:8080/jetspeed/desktop and hit enter. You will now be in Jetspeed Desktop and currently logged in if + you were logged in before changing the url. + </p> + <p> + Jetspeed desktop uses Web 2.0 technology. Unlike Jetspeed portal, updates to the screen only occur where required. Jetspeed + portal must render the entire screen when changes are made to any portlet. + </p> + <p> + <img align="top" src="images/desktop.png"/> + </p> + <p> + Updating portions of the screen are not the only differences between the two. Users can drag and drop portlets to a new location without entering edit mode. + Click and hold the mouse button on the title bar of any portlet to have the ability to move the portlet anywhere in allowable areas for portlets. + The portlets will adjust automatically as you move them. + </p> + <p> + A new icon is now next to the minimize and maximize options. This custom icon can have edit and help links included as well as other + options. View, which is the normal portlet mode, like restore, is now an option when you are in help and edit modes. + Several options are available through this icon: + <ul> + <li>Tiling and untiling of portlet windows</li> + <li>Height options of variable and fit in window</li> + </ul> + </p> + <p> + <img align="top" src="images/deskcustom.png"/> + </p> + <p> + Portlet preferences are available through the edit icon as they were in Jetspeed Portal. + </p> + <p> + A tiled window in Jetspeed is a window that does not overlap any other windows. Tiling the portlet will move the portlet window into the layout structure with the other portlets, the default option. Untiling the portlet will move the + portlet to the front, or on top, of the other portlets. Clicking and holding the mouse on the title bar will allow you to place the portlet anywhere within your browser window + without restrictions. + </p> + <p> + <img align="top" src="images/untiled.png"/> + </p> + <p> + Depending on the height of the window, whether it has been modified or not, you will have the option of Fit Content or Variable under the height option. Fit Content + will resize the portlet around all data within that portlet window. Variable, the default option, gives you a scrollable window if the content exceeds the current window size. + You may also adjust the height of the portlet while in Fit Content mode or Variable mode using the resize arrow located at the bottom right of the portlet window. + </p> + <p> + Adding Portlets no longer require you enter edit mode of the portal window. A plus icon now appears standard in the portal window and will + bring you directly to the Portlet Selector. Clicking on the arrow or [GoBack] will bring you back to the normal Portal Window + </p> + <p> + <img align="top" src="images/deskplus.png"/> + </p> + <p> + The help page is available through the help icon as it was in Jetspeed Portal. + </p> + </section> + </body> +</document> \ No newline at end of file
Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/features.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/features.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/features.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/features.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,195 @@ +<?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>Features</title> + <subtitle>Features</subtitle> + <authors> + <person name="David Le Strat" email="[email protected]" /> + <person name="Marky Goldstein" email="[email protected]" /> + <person name="David Sean Taylor" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Features"> + <p> + The Apache Portals Jetspeed Team is pleased to present the Jetspeed-2 Open Source Enterprise Portal. This open source project has matured past several releases, + and has been fully-compliant with the Portlet Specification 1.0 (JSR-168) since version 2.0. + Jetspeed-2 passes the TCK (Test Compatibility Kit) suite and is fully CERTIFIED to the Java Portlet Standard. + </p> + <subsection name="Standardized"> + <ul> + <li>Fully compliant with Java Portlet API Standard 1.0 (JSR 168)</li> + <li>Passed JSR-168 TCK Compatibility Test Suite</li> + <li>J2EE Security based on JAAS Standard, JAAS DB Portal Security Policy</li> + <li>LDAP Support for User Authentication</li> + </ul> + </subsection> + <subsection name='Portal Engine Features'> + <ul> + <li>The Jetspeed Portal - Server-Side Parallel JSR-168 Portlet Rendering Engine</li> + <li>The Jetspeed Desktop - Web 2.0 Client-Side JSR-168 Portlet Rendering Engine</li> + <li>Full Support for JSR-168 Portlet Caching and per portlet cache configuration</li> + <li>Portlet Timeout Tracking with mimimal render time limits</li> + <li>Portlet Service Manager for automated removal of slow or dead portlets.</li> + <li>Parallel rendering on Websphere 6.1</li> + </ul> + </subsection> + <subsection name="Customization Features"> + <ul> + <li>Portal Page Customizer</li> + <li>Desktop Page Customizer</li> + <li>Nested Fragment Customization</li> + <li>Drag and drop moving of portlets</li> + <li>Resizing of desktop portlet windows</li> + <li>Portlet Selector with Portlet Categorizations, Full-Text Search of Portlets</li> + <li>Customizable Themes (Skins)</li> + </ul> + </subsection> + <subsection name='Security'> + <ul> + <li>Portlet-level Security checks based on Security Constraints or Security Permissions</li> + <li>Declarative Security Constraints and JAAS Database Security Policy</li> + <li>Fully swappable Security Constraint or Security Permission support</li> + <li>Jetspeed SSO (Single Sign-on)</li> + <li>Delegation of Security</li> + <li>Administrative actions logged to Audit Activity database</li> + </ul> + </subsection> + <subsection name="Distributed Cluster Support"> + <ul> + <li>Jetspeed Distributed Cluster - support for distributed deployments of the portal on multiple application server platforms</li> + <li>Distributed Cache for portal components including preferences, registry and portlet entities.</li> + <li>Distributed invalidation of portlet cache</li> + </ul> + </subsection> + <subsection name="Foundation Component Architecture"> + <ul> + <li>Spring-based Components and Scalable Architecture</li> + <li>Configurable Pipeline Request Processor</li> + <li>Auto Deployment of Portlet Applications</li> + <li>Jetspeed Component Java API</li> + <li>Jetspeed AJAX XML API</li> + <li>PSML: Extended Portlet Site Markup Language + <ul><li>Database Persistent</li> + <li>Content Management Facilities</li> + <li>Security Constraints</li></ul> + </li> + <li>Full security maintenance using LDAP is now supported for many LDAP providers</li> + </ul> + </subsection> + <subsection name="Portal Core Features"> + <ul> + <li>Runtime Portlet API Standard Role-based Security</li> + <li>Portal Content Management and Navigations: Pages, Menus, Folders, Links</li> + <li>PSML Folder CMS Navigations, Menus, Links</li> + <li>Rules-based Profiler for page and resource location</li> + <li>Role-based Aggregation of Visible Pages</li> + <li>Integrates with most popular databases including Derby, MySQL, MS SQL, Postgres, Oracle, DB2</li> + <li>Client independent capability engine (html, xhtml, wml,vml)</li> + <li>Support for Pocket PC</li> + <li>Internationalization: Localized Portal Resources in 12 Languages</li> + <li>Statistics Logging Engine</li> + <li>Portlet Registry</li> + <li>Full Text Search of Portlet Resources with Lucene</li> + <li>User Registration</li> + <li>Forgotten Password</li> + <li>Rich Login and Password Configuration Management</li> + </ul> + </subsection> + <subsection name="Administrative Portlets"> + <ul> + <li>User, Role, Group, Password, and Profile Management</li> + <li>Portal Site Manager</li> + <li>Remote Portal Application Deployer (RPAD) - hot deploy portlet applications from remote locations on the Web</li> + <li>JSR 168 Generic User Attributes Editor</li> + <li>JSR 168 Preferences Editor</li> + <li>SSO Manager</li> + <li>Permission Management (JAAS Security)</li> + <li>Security Constraints Management</li> + <li>Portlet Application and Lifecycle Management</li> + <li>Profiler Administration</li> + <li>Statistics Reports</li> + <li>Portlet Out of Service Manager</li> + <li>PSML and XML Import / Export Admin Portlet</li> + </ul> + </subsection> + <subsection name="Web Framework Support and Sample Portlets"> + <ul> + <li>Bridges to other Web Frameworks: Wicket, JSF, Groovy, Struts, PHP, Perl, Velocity</li> + <li>Sample Portlets: + <ul><li>RSS, IFrame, Calendar XSLT, Struts Petstore, Bookmark, Database Browser</li> + <li>Integration with Display Tags, Spring MVC</li></ul> + </li> + </ul> + </subsection> + <subsection name='Data Migration Features'> + <ul> + <li>XML Import/Export Utility for all Jetspeed database data to support data migration over versions</li> + <li>All initial portal data seeded with XML</li> + <li>XML Schemas for all XML content</li> + </ul> + </subsection> + <subsection name="Portal Design Features"> + <ul> + <li>Deployment Jetspeed Portlet and Page Skins (Decorators) CSS Components</li> + <li>Configurable CSS Page Layouts</li> + <li>Easy to Use Velocity Macro Language for Skin and Layout Components</li> + </ul> + </subsection> + <subsection name="Development Tools"> + <ul> + <li>Ant-based Custom Build with Tutorial and Installer</li> + <li>Automated Maven-2 Build</li> + <li>Automated Maven-1 Build</li> + <li>Jetspeed-2 Maven Plugin for Custom Portal Development</li> + <li>Maven-2 Profiles and Archetypes</li> + <li>AutoDeployment of Portlet Applications, Portal Resources</li> + <li>Deployment Tools</li> + <li>Plugin Goals integrated with Auto Deployment Feature</li> + <li>XML Schemas for PSML, jetspeed-portlet.xml, and Jetspeed XML (seed data)</li> + </ul> + </subsection> + <subsection name='Extended JSR-168 Features'> + <ul> + <li>Custom Portlet Modes and Window States: <b>Edit Defaults, Configure, Print, About</b></li> + <li>Custom Window States: <b>Solo</b></li> + <li>Dynamically hide Portlets at request time</li> + <li>Maximize on Edit Defaults or Edit modes option</li> + <li>Preliminary Portlet API 2.0 ResourceURL support allowing full response control</li> + </ul> + </subsection> + <subsection name='Other Features'> + <ul> + <li>Installation choice of either Demo Portal or Minimal Starter Portal</li> + <li>In-depth Jetspeed 2 Tutorial</li> + </ul> + </subsection> + <subsection name="Application Servers Supported"> + <ul> + <li>Tomcat 6.x</li> + <li>Jetty</li> + <li>Websphere 6.0</li> + <li>Geronimo</li> + <li>JBoss</li> + <li>Weblogic</li> + </ul> + </subsection> + </section> + </body> +</document> Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/gettingstarted.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/gettingstarted.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/gettingstarted.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/gettingstarted.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,100 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide - Getting Started</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Getting Started"> + <p> + If you are running Jetspeed locally on your computer, you may access the + portal by pointing your internet Web browser to http://localhost:8080. The + screenshots used for this guide were generated from Jetspeed without any + extra customization. Your screen may vary depending upon the user you login as or if you are using + a customized version of jetspeed. + </p> + <p> + You may be using this guide as a supplement to accessing Jetspeed on the internet. Enter the URL + to the portal to begin following along with this guide. + </p> + <p> + When you are done reading this page, login via the Login Portlet to begin using Jetspeed. + </p> + <subsection name="Initial Display Window"> + <p> + <img src="images/welcomepagereduced.png"/> + </p> + <p> + The first screen you come across has several portlets to get you started. Each Portlet has a title bar to identify it by name. These portlets can be minimized, maximized, moved to different locations or removed, which we will be covering in this guide. + </p> + </subsection> + <subsection name="Portlet : Locale Selector"> + <p> + Locale Selector Portlet allows you to select the language you wish the portal to be be using.<br/> + </p> + <p> + <img src="images/localedropdown.png"/> + </p> + </subsection> + <subsection name="Portlet : Forgotten Password"> + <p> + Forgotten Password allows a user to request a new password in case the current password is lost or forgotten. Jetspeed will email a new password to the email address entered, provided it can match that address with a registered user in the Jetspeed user database.<br/> + </p> + <p> + <img src="images/forgotten.png"/> + </p> + </subsection> + <subsection name="Portlet : User Registration"> + <p> + User Registration is your first step if you have not been provided with a username and password from an administrator. The username and email address must be unique for each user in the Jetspeed user database. Jetspeed uses "templates" to create default pages for users when the user first registers or is created by an Administrator. + </p> + <p> + Create a new user in the User registration portlet by filling in the required fields of username, address, password and password confirm Click on the register me button and you have created a user ready to login to Jetspeed.<br/> + </p> + <p> + <img src="images/userreg.png"/> + </p> + </subsection> + <subsection name="Portlet : Login"> + <p> + Login Portlet is your access to your private secure area within Jetspeed. Any changes you make to your settings while you are logged in will only affect you. Once you are logged in, you will also see a change password link become available. + </p> + <p> + Change the username in the Login Portlet to the username you just registered. Enter your case sensitive password and press the Login button. The screen will reload and you will now be in your private secure area of Jetspeed.<br/> + </p> + <p> + <img src="images/login.png"/> + </p> + </subsection> + <subsection name="Logging in as different users or roles"> + <p> + Jetspeed has different views for different users and different views for different roles. The screenshots below illustrate the way + the menu's change based on the authenticated user or role. + </p> + <p> + Logged in as User<img align="top" src="images/userlogincompare1.png"/> Logged in as Admin<img align="top" src="images/userlogincompare2.png"/> + </p> + </subsection> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/index.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/index.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/index.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/index.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,54 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Welcome to Jetspeed"> + <p> + Jetspeed is an Open Portal Platform and Enterprise Information Portal, written entirely in open source under the Apache license in Java and XML. Jetspeed is an open component portal architecture based on standards. All access to the portal is managed through a robust portal security policy. Within a Jetspeed portal, individual portlets can be aggregated to create a page. Each portlet is an independent application with Jetspeed acting as the central hub making information from multiple sources available in an easy to use manner. + </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> + <p> + Users can personalize their experience, by adding new content with + portlet customizers, styling their view with portal decorators (skins) + and layouts. Personalization blends with secure access to provide a + custom view of the portal based on runtime customizations and + parameters. + </p> + <p> + Jetspeed provides the following personalization features: + <ul> + <li>Portlet Selector (search for portlets, add portlets, categorize portlets)</li> + <li>Portal Customizer (move portlets, choose decorations, layouts) </li> + <li>Desktop Customizer (same as portal, drag and drop, resizing, detach) </li> + <li>Portlet API Preferences Editors </li> + <li>Administrative Customization </li> + </ul> + </p> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/logout.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/logout.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/logout.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/logout.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,52 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide - Logout</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Ending your Jetspeed Session"> + <subsection name="Logout Link"> + <p> + <img align="top" src="images/customize.png"/> The logout link is located in the upper right just above the portlet windows. + </p> + <p> + There are multiple ways to end your session with Jetspeed. The easiest and most secure is to click the logout link located in the upper + right of the portal window. Logging out returns the user to the Jetspeed Welcome Page where you can login again. + </p> + </subsection> + <subsection name="Session Timeout"> + <p> + Session timeout occurs after a designated amount of time has passed and no interaction between Jetspeed the browser has occurred. This setting is configurable by your administrator. + Interacting with Jetspeed at any time after the timeout has occurred will result in the user being presented with the Jetspeed Welcome Page. + </p> + </subsection> + <subsection name="Clearing Cookies"> + <p> + Clearing the browsers cookies will also result in the user being logged out. In certain situations such as SSO (Single Sign On), clearing the cookies + can be the safest way to logout. + </p> + </subsection> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/menu.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/menu.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/menu.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/menu.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,53 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Menu"> + <p> + The left hand Menu of the Portal Window contains additional navigation items. The links, pages and folders are pre-configured links + that can vary based on a person's role or group. You may add new folders using the Folder Configuration option. Enter the Folder Name, Title + and Short Title. The Short Title will be used for the name of the Folder in the left hand side menu. The Folder Name will be the name of the Tab in + your window that appears when you click on your folder name in the Menu. Once you have the Folder created, you may change the name, move the folder + left or right or delete the folder. You must have some information entered into the fields for these buttons to work. + Using just the Short Title field will work. + </p> + <p> + <img align="top" src="images/folderconfig.png"/> + </p> + <p> + You may add additional folders, add folders within folders and add tabs within each folder. Each new folder creates a new blank + page that you may then customize by changing themes, layouts, Portlet Themes and adding portlets. The Menu on the left and the Tab bar across + the top will change when you click on a folder name. + </p> + <p> + <img align="top" src="images/customfolder.png"/> + </p> + <p> + The Breadcrumbs bar underneath the leftmost Tab gives you navigation links back to the user home page. + </p> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/navigation.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/navigation.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/navigation.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/navigation.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<project> + <body> + <links> + <item name="Main Docs" href="index.html"/> + <item name="Admin Guide" href="adminguide/index.html"/> + <item name="Deployement Guide" href="deployguide/index.html"/> + <item name="Developers Guide" href="devguide/index.html"/> + <!--<item name="PDF Documentation" href="/jetspeed2.pdf" img="images/pdf.gif" />--> + </links> + <menu name="Introduction"> + <item name="Welcome" href="usersguide/index.html" /> + <item name="About this guide" href="usersguide/aboutuserguide.html" /> + <item name="Definitions" href="usersguide/definitions.html" /> + </menu> + <menu name="Using Jetspeed"> + <item name="Getting Started" href="usersguide/gettingstarted.html" /> + <item name="Navigation" href="usersguide/portalnavigation.html" /> + <item name="Portlet Modes and Action Bar" href="usersguide/portletmodes.html" /> + <item name="Logging out" href="usersguide/logout.html" /> + </menu> + <menu name="Customizing"> + <item name="Decorators" href="usersguide/decorators.html" /> + <item name="Portlets" href="usersguide/portlets.html" /> + <item name="Tabs" href="usersguide/tabs.html" /> + <item name="Menu" href="usersguide/menu.html" /> + <item name="Desktop" href="usersguide/desktop.html" /> + </menu> + <!-- <menu name="Reference"> + <item name="QuickRef : Option Locations" href="usersguide/options.html" /> + </menu> --> + <menu name="Support"> + <item name="Mailing List" href="mail-lists.html" /> + <item name="Bug Database" href="issue-tracking.html" /> + <item name="Wiki" href="http://wiki.apache.org/portals/Jetspeed2"; /> + <!--<item name="Quality Testing" href="quality-testing.html" />--> + <item name='FAQ' href='faq.html'/> + </menu> + </body> +</project> Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/options.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/options.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/options.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/options.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,34 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide - Option locations</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Quick Reference to location of options"> + <p> + TODO : Locations of options for quick reference + </p> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portalnavigation.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portalnavigation.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portalnavigation.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portalnavigation.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,64 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide - Navigation</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Navigating the Portal"> + <p> + Tabbed Menus, Breadcrumbs and Menu Items are the main ways to Navigate through your portal. Edit, Help and other portlet bar action items can + display different screens, but you have not navigated to a new location. Customization of all navigation items can be configured by the + Administrator of the portal. + </p> + <subsection name="Tabbed Menus"> + <p> + Tabbed menus across the top contain selections for each page found in the current folder. The current Tabs may have come pre-configured as standard or may have been created and configured by the user. Each Tab + can be configured with a different Theme, Layout, Portlet Theme and different Portlets. + </p> + <p> + <img src="images/tabbedmenu.png"/> + </p> + </subsection> + <subsection name="Breadcrumbs"> + <p> + Breadcrumbs are located just below the Tabbed Menus. Breadcrumbs give you a visual representation of the path you have + taken to reach your current location. From the breadcrumb trail, you can navigate back out of the folder hierarchy up to previous + destinations. + </p> + <p> + <img src="images/breadcrumbs.png"/> + </p> + </subsection> + <subsection name="Menu Items"> + <p> + Menu Items are located in the Left Hand side menu. Each one of these links can take you to a location within the Portal or to an external + location such as a website. Folders you have created will appear in this menu. + </p> + <p> + <img src="images/leftmenu.png"/> + </p> + </subsection> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portletmodes.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portletmodes.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portletmodes.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portletmodes.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide - Portlet Modes</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Portlet Modes and Action Bar"> + <subsection name="Portlet Modes"> + <p> + Portlet Modes indicate the function that a portlet is + performing. A portlet mode advises a portlet what task it + should perform. Availability of portlet modes may be + restricted based on user roles. + </p> + <ul> + <li>View - general portlet rendering and interaction. </li> + <li>Edit - customization the behavior of a portlet, update preferences. </li> + <li>Help - provides context-sensitive help for this portlet. </li> + <li>Custom Portlet Modes - vendor specific.</li> + </ul> + </subsection> + <subsection name="Portlet Action Bar"> + <p> + The portlet action bar <img align="top" src="images/editactionbar.png"/> + </p> + <p> + <img align="top" src="images/editicon.png"/> The edit icon will change the portlet window to display configurable preferences for that particular portlet. For instance, a weather portlet can give you the options to change the city it is displaying as well as other options. Each portlet will have unique preferences. It is possible to have two or more of the same portlets displayed, but each will use it's own set of preferences. This would allow you to have two weather portlets displaying the weather for two different cities. + </p> + <p> + <img align="top" src="images/helpicon.png"/> The help icon will display a page that display detailed information on how to use the portlet, version numbers or anything the developer has chosen to display in this page. + </p> + <p> + <img align="top" src="images/minicon.png"/> The minimize icon will reduce your portlet down to displaying the title bar of the portlet only. <img align="top" src="images/restoreicon.png"/> You can click on the restore which is available to return the portlet to it's original window state. + </p> + <p> + <img align="top" src="images/maxicon.png"/> The maximize icon will enlarge the portlet to display only that portlet in your portal window. <img align="top" src="images/restoreicon.png"/> The restore button will be available again when in this mode. + </p> + <p> + Other icons that you may see in the icon bar are <img align="top" src="images/printicon.png"/> print and other customized icons. + </p> + </subsection> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portlets.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portlets.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portlets.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/portlets.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,115 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Portlets"> + <p> + While in the edit mode of the portal window, you will notice that each portlet on your page now has several options to customize. A drop down menu option for changing your decorator of that individual portlet, + an icon bar <img align="top" src="images/arrowsxbar.png"/> for removing the portlet or arrows for moving the portlet one location spot in the direction of the arrow. Menus + will not be displayed for resources that are not accessible. + </p> + <p> + Each portlet can have it's own decorator that will override the decorator selected in the portal window section. + However, choosing a new theme in the Page/Folder Customizer will change all portlets to that theme regardless + if they have been given individual themes. You will need to change the individual portlet themes again to have + the portlets display their own if you have set the theme globally. + </p> + <p> + <img align="top" src="images/indportlettheme.png"/> + </p> + <subsection name="Moving Portlets"> + <p> + Depending upon their current placement in the window, arrows will be available to move your portlets across + columns or up and down within a column. Portlets will auto-adjust for each move. + </p> + <p> + Before Clicking on Right Arrow of Calendar Portlet. + </p> + <p> + <img align="top" src="images/leftmove.png"/> + </p> + <p> + After Clicking on Right Arrow of Calendar Portlet. + </p> + <p> + <img align="top" src="images/rightmove.png"/> + </p> + </subsection> + <subsection name="Removing Portlets"> + <p> + To remove a portlet from your window, click on the <img align="top" src="images/xicon.png"/> icon of the portlet you wish to remove. The remaining portlets + will adjust to fill the space if any are lower in the same column. + </p> + <a name="adding_portlets"></a> + </subsection> + <subsection name="Adding Portlets"> + <p> + Click on Add Portlet in the upper right. + <img align="middle" src="images/addportlet.png"/> + </p> + <p> + The Portlet Selector shows the portlets that are available to be added. + </p> + <p> + <img align="top" src="images/smportletselector.png"/> + </p> + <p> + There are multiple pages that you may navigate through by using the numbered links. + <img align="middle" src="images/portletnav.png"/> + </p> + <p> + There is a search field where you can search for a portlet by name. + </p> + <p> + <img align="top" src="images/portletsearch.png"/> + </p> + <p> + The portlets are separated into categories as well. + </p> + <p> + <img align="top" src="images/categories.png"/> + </p> + <p> + The portlet selector displays the name of the portlet, a brief description, an Add option and a counter of how many instances + of this portlet are currently running. Clicking on the Add link will increase the counter by 1, but no other visible changes will + occur at this time. + </p> + <p> + <img align="top" src="images/portletdetails.png"/> + </p> + <p> + Clicking on the [GoBack] option or arrow will bring you to the original customization window where you can see your portlets have been added + to your portlet window. If you have changed your decorator from the default decorator, you may find that your new portlets are using a + different decorator rather than the decorator you are now using. + </p> + <p> + You will need to return at one point to the original customization window before you see the restore option to leave the configuration + area. + </p> + </subsection> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/tabs.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/tabs.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/tabs.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/tabs.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,47 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Tabs"> + <p> + The page configuration area allows you to create Tabs for creating new pages across the top of the window. Enter the Page Name, Title and + Short Title. The Short Title field will be the name of the Tab in the window. Once you have the Tab created, you may change the name, move the page + left or right or delete the page. You must have some information entered into the fields for these buttons to work. Using just the Short Title field will work. + </p> + <p> + <img src="images/pageconfig.png"/> + </p> + <p> + Once the page is created, you may also change the Decorator Theme for the Window, change the Layout Columns and set a global Portlet theme. Add Portlets + to your page and you now have a new page that can only be seen by you and is completely separate from any of the other pages. Adding Portlets is covered in the + Portlet Section of Customizing. + </p> + <p> + <img src="images/customtab.png"/> + </p> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/windowstates.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/windowstates.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/windowstates.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-guide-users/src/site/xdoc/windowstates.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Jetspeed Users Guide</title> + <subtitle>Guide to Using Jetspeed</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Jody McAlister" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Portlet Window States"> + <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> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/pom.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/pom.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/pom.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/pom.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,65 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + 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. + + $Id: pom.xml 775034 2009-05-15 06:50:03Z taylor $ +--> +<project xmlns="http://maven.apache.org/POM/4.0.0"; xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd";> + + <modelVersion>4.0.0</modelVersion> + <prerequisites> + <maven>2.0.9</maven> + </prerequisites> + + <artifactId>jetspeed-tutorial</artifactId> + <name>Jetspeed Tutorial</name> + <description>Jetspeed 2.2 Tutorial</description> + <packaging>pom</packaging> + <parent> + <artifactId>jetspeed-site-docs</artifactId> + <groupId>org.apache.portals.site</groupId> + <version>2.2</version> + </parent> + + <!-- this is for a bug Maven, see http://jira.codehaus.org/browse/MSHARED-18 + should be removed once Maven incorporates this bug in an official release--> + <build> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-site-plugin</artifactId> + <version>2.0</version> + </plugin> + </plugins> + </build> + + <reporting> + <plugins> + <plugin> + <groupId>org.apache.maven.plugins</groupId> + <artifactId>maven-project-info-reports-plugin</artifactId> + <reportSets> + <reportSet> + <reports> + </reports> + </reportSet> + </reportSets> + </plugin> + </plugins> + </reporting> + +</project> Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/01/run-it-small.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/01/run-it-small.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/01/run-it-small.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/01/run-it.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/01/run-it.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/01/run-it.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetexpress-portal-small.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetexpress-portal-small.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetexpress-portal-small.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetexpress-portal.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetexpress-portal.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetexpress-portal.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetspeed-page-decorator.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetspeed-page-decorator.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetspeed-page-decorator.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetspeed-portlet.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetspeed-portlet.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/02/jetspeed-portlet.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/bonjourmonde-portlet.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/bonjourmonde-portlet.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/bonjourmonde-portlet.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/eclipse-classpath.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/eclipse-classpath.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/eclipse-classpath.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/import-project.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/import-project.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/import-project.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/import-project2.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/import-project2.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/import-project2.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/jsp-portlet.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/jsp-portlet.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/jsp-portlet.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/menu-tutorial.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/menu-tutorial.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/menu-tutorial.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/new-portlet.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/new-portlet.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/new-portlet.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/override-impl.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/override-impl.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/03/override-impl.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/tutorial.png URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/tutorial.png?rev=1691449&view=auto ============================================================================== Binary file - no diff available. Propchange: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/resources/images/tutorial.png ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/site.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/site.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/site.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/site.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,78 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<project name="Jetspeed Tutorial"> + <publishDate format="d MMMM yyyy"/> + <bannerLeft> + <name>Jetspeed Tutorial</name> + <src>images/jetspeed-logo.gif</src> + <href>http://portals.apache.org/jetspeed-2/</href> + </bannerLeft> + <bannerRight> + <name>Jetspeed Tutorial</name> + <href>http://portals.apache.org/jetspeed-2/tutorial/</href> + <src>images/tutorial.png</src> + </bannerRight> + <skin> + <groupId>org.apache.portals.jetspeed-2</groupId> + <artifactId>jetspeed-maven-skin</artifactId> + <version>2.2.2</version> + </skin> + <body> + + <links> + <item name="Home" href="../index.html"/> + <item name="Admin Guide" href="../adminguide/index.html"/> + <item name="Build Guide" href="../build/guide/index.html"/> + <item name="Deployers Guide" href="../deployguide/index.html"/> + <item name="Developer Guide" href="../devguide/index.html"/> + </links> + + <menu name="Jetspeed Tutorial"> + <item name="Welcome" href="index.html"/> + <item name="Before you start" href="before-you-start.html"/> + </menu> + <menu name="01. Custom Portal Generation"> + <item name="Generating a Jetspeed Portal" href="01/genapp.html"/> + <item name="Project Structure" href="01/project-structure.html"/> + <item name="Configure Maven Build" href="01/configure-maven.html"/> + <item name="Build and Deploy Custom Portal" href="01/build-it.html"/> + <item name="Run the Custom Portal" href="01/run-it.html"/> + </menu> + <menu name="02. Customizing Your Portal Design"> + <item name="Decorators and Themes" href="02/customizing-overview.html"/> + <item name="Page Decoration" href="02/page-decoration.html"/> + <item name="Portlet Decoration" href="02/portlet-decoration.html"/> + <item name="Desktop Themes" href="02/desktop-theme.html"/> + <item name="Changing the Default Page" href="02/default-page.html"/> + <item name="Deploying your Customizations" href="02/deploy-custom.html"/> + </menu> + <menu name="03. Portlet Development 101"> + <item name="Overview" href="03/overview.html"/> + <item name="Eclipse" href="03/eclipse.html"/> + <item name="Hello World" href="03/hello.html"/> + <item name="Adding a Page" href="03/tutorial-psml.html"/> + <item name="JSP and Portlet API Taglib" href="03/taglib.html"/> + </menu> + <menu name="04. Jetspeed Services"> + <item name="Services Tutorial Portlet" href="04/jetspeed-service.html"/> + </menu> + <menu name="Reference"> + <item name="Build commands" href="reference/build-commands.html" /> + </menu> + </body> +</project> Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/build-it.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/build-it.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/build-it.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/build-it.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,65 @@ +<?xml version="1.0"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Build the Custom Portal</title> + <subtitle>Building a Custom Jetspeed Portal</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Niels van Kampenhout" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Building and Deploying a Custom Jetspeed Portal"> + <p> + Now that you have completed the <a href="configure-maven.html">build and deployment configuration</a> + of your custom portal, you are ready to build the portal. + Inside the root directory of your project (<i>jetexpress</i>), run the following command: + </p> + <source><![CDATA[mvn jetspeed:mvn -Dtarget=all]]></source> + <p> + As well as building your custom portal project, this command also: + </p> + <ul> + <li>deploys both the portal and the portlet application to the Tomcat application server</li> + <li>creates the Jetspeed core schema tables in the Derby database</li> + <li>populates the database with a minimal set of portal information, including default roles, groups, profiles, and administrative users</li> + </ul> + <p> + Maven will produce a large amount of build logging information. The Jetspeed Maven Plugin invokes several other + Maven goals during the build process, each resulting in a message "BUILD SUCCESSFUL". + Eventually Maven will print a final "BUILD SUCCESSFUL" message and exit to the + command line prompt. + </p> + <p> + <i> + Note: for finer grained build and deploy commands see the <a href="../reference/build-commands.html">Build Commands Reference</a>. + </i> + </p> + </section> + <section name="Next"> + <p> + Now that you have built and deployed the portal, <a href="run-it.html">lets start up the application server</a>. + </p> + <p> + <a href="configure-maven.html">Previous</a> - <a href="run-it.html">Next</a> + </p> + </section> + </body> +</document> + Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/configure-maven.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/configure-maven.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/configure-maven.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/configure-maven.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,105 @@ +<?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. +--> +<!-- + status: TODO +--> +<document> + <properties> + <title>Configure the Maven build</title> + <subtitle>Configure the Maven build</subtitle> + <authors> + <person name="Niels van Kampenhout" email="[email protected]"/> + </authors> + </properties> + <body> + <section name="Build and deployment configuration"> + <p> + In the previous steps you <a href="genapp.html">generated a custom portal project</a> and + learned about the <a href="project-structure.html">structure of the generated project</a>. + Before you can build and deploy the portal, you need to set a few configuration + parameters. + </p> + <subsection name="Configure application server and database locations"> + <p> + The file <i>jetspeed-mvn-settings.xml</i> in the root of your project contains + information about the location of your application server and database. The generated + project is configured to use Tomcat as application server, and Derby as database. + All you have to do is set the correct location for both. + </p> + <p> + Find the <i>org.apache.jetspeed.server.home</i> configuration parameter and change + the path to where you installed Tomcat: + </p> + <source><![CDATA[<org.apache.jetspeed.server.home>/home/johndoe/j2tutorial/apache-tomcat-6.0.33/</org.apache.jetspeed.server.home>]]></source> + <p> + Find the <i>org.apache.jetspeed.production.database.url</i> configuration parameter. + It has a location inside the /tmp directory configured by default, which might or might not + work for you, depending on your environment. Just to be sure, change it to a location + you have write access to: + </p> + <source><![CDATA[<org.apache.jetspeed.production.database.url>jdbc:derby:/home/johndoe/j2tutorial/derby/productiondb;create=true</org.apache.jetspeed.production.database.url>]]></source> + <p> + <i> + Note: it is of course possible to use/configure a different application server and database but + it's beyond the purpose of this tutorial to describe this. + The <a href="http://portals.apache.org/jetspeed-2/deployguide/index.html";>Jetspeed Deployment Guide</a> + describes in detail how to deploy your portal to different application servers, and how to + configure different databases. + </i> + </p> + </subsection> + <subsection name="Configure Jetspeed Maven Plugin"> + <p> + The Jetspeed build requires the Jetspeed Maven Plugin. Because this is not a standard Maven plugin, + you need to specify its fully qualified Maven name (groupId:artifactId:version) each time you use + it. In case of the Jetspeed Maven Plugin this is <i>org.apache.portals.jetspeed-2:jetspeed-mvn-maven-plugin:mvn</i>, + which is a little long to remember. Luckily you can add the Jetspeed Maven Plugin to the standard Maven + plugins, so you can use <i>jetspeed:mvn</i> instead. + </p> + <p> + Maven has global configuration file called <i>settings.xml</i>, which is located + inside a directory <i>.m2</i> inside your user home directory. + So for example that would be <i>~/.m2/settings.xml</i> on Linux, or <i>%USERPROFILE%\.m2\settings.xml</i> on Windows. + If the file does not exist on your system, you can create it yourself and copy paste in to it the XML below. + If it does exist, it probably already has some configuration in it. Add the <i>pluginGroup</i> for Jetspeed + as below. + </p> + <source><![CDATA[<settings xmlns="http://maven.apache.org/POM/4.0.0"; + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"; + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 + http://maven.apache.org/xsd/settings-1.0.0.xsd";> + + <pluginGroups> + <pluginGroup>org.apache.portals.jetspeed-2</pluginGroup> + </pluginGroups> + + <!-- There might be more configuration here --> + +</settings>]]></source> + </subsection> + </section> + <section name="Next"> + <p> + Now that everything is configured you are ready to <a href="build-it.html">build and deploy your project</a>! + </p> + <p> + <a href="genapp.html">Previous</a> - <a href="build-it.html">Next</a> + </p> + </section> + </body> +</document> Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/genapp.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/genapp.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/genapp.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/genapp.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,95 @@ +<?xml version="1.0"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Generating a Jetspeed Portal</title> + <subtitle>Using Maven to Generate a Custom Jetspeed Portal</subtitle> + <authors> + <person name="David Sean Taylor" email="[email protected]" /> + <person name="Niels van Kampenhout" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Generating a Jetspeed Portal"> + <p> + The easiest way to start a custom portal project is to use the Jetspeed Archetype to + generate a Maven project. + An <a href="http://maven.apache.org/guides/introduction/introduction-to-archetypes.html";>archetype</a> + is a template that you can use to generate + a boilerplate project. Technically it is not required to use Maven, but it is recommended + because it will give you more control over your build and release management. + Also the generated project will keep your customizations clearly separated from + core Jetspeed functionality, and will make updates to newer Jetspeed version easier. + </p> + <p> + To create a new custom portal named <b>jetexpress</b>, enter the following command in a location of choice: + </p> +<source><![CDATA[ +mvn org.apache.maven.plugins:maven-archetype-plugin:2.3 \ + -DarchetypeGroupId=org.apache.portals.jetspeed-2 \ + -DarchetypeArtifactId=jetspeed-archetype \ + -DarchetypeVersion=2.3.0 \ + -DartifactId=jetexpress \ + -Dpackage=org.apache.portals.tutorials \ + -DgroupId=org.apache.portals.tutorials \ + -Dversion=1.0-SNAPSHOT +]]></source> + <p> + <b>Paste into Command Line:</b> + <input id='genapp' size="80" value="mvn org.apache.maven.plugins:maven-archetype-plugin:2.3:generate -DarchetypeGroupId=org.apache.portals.jetspeed-2 -DarchetypeArtifactId=jetspeed-archetype -DarchetypeVersion=2.3.0 -DartifactId=jetexpress -Dpackage=org.apache.portals.tutorials -DgroupId=org.apache.portals.tutorials -Dversion=1.0-SNAPSHOT"/> + </p> + <p> + With this command you specify which archetype to use (<i>archetypeGroupId</i>, <i>archetypeArtifactId</i>), and which version of + the archetype (<i>archetypeVersion</i>). In addition you specify a number of parameters that will be used by + Maven to uniquely identify your project: a name (<i>artifactId</i>) and group (<i>groupId</i>), + a package name (<i>package</i>), and a version (<i>version</i>). + </p> + <p> + Maven will ask you to confirm the groupId, artifactId, version and package for your project: + </p> + <source> +Confirm properties configuration: +groupId: org.apache.portals.tutorials +artifactId: jetexpress +version: 1.0-SNAPSHOT +package: org.apache.portals.tutorials +Y: : </source> + <p> + Simply confirm the values by pressing Enter. + </p> + <p> + Maven will then generate the project and finish with the message "BUILD SUCCESSFUL". + A directory named <b>jetexpress</b> will have been created. + </p> + <p> + <i>Notice that <b>jetexpress</b> will be the name of your portal, not <b>jetspeed</b>. The idea is that you + can create a customized portal based upon Jetspeed, but with a different name, customized to meet your organization requirements.</i> + </p> + </section> + <section name="Next"> + <p> + Now that you have generated your portal project, + <a href="project-structure.html">let's take a look what's inside the project.</a> + What files and folders were generated, and what are they for? + </p> + <p> + <a href="../before-you-start.html">Previous</a> - <a href="project-structure.html">Next</a> + </p> + </section> + </body> +</document> \ No newline at end of file Added: portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/project-structure.xml URL: http://svn.apache.org/viewvc/portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/project-structure.xml?rev=1691449&view=auto ============================================================================== --- portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/project-structure.xml (added) +++ portals/site/jetspeed/jetspeed-2.3/jetspeed-tutorial/src/site/xdoc/01/project-structure.xml Thu Jul 16 21:01:09 2015 @@ -0,0 +1,114 @@ +<?xml version="1.0"?> +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> +<document> + <properties> + <title>Project Structure</title> + <subtitle>The structure of your generated project</subtitle> + <authors> + <person name="Niels van Kampenhout" email="[email protected]" /> + </authors> + </properties> + <body> + <section name="Project structure"> + <p> + In the previous step you <a href="genapp.html">generated a custom portal project</a> using the Jetspeed Archetype + for Maven. The jetexpress directory that was generated by the archetype has the following contents: + </p> +<source> + jetexpress/ + |-- jetexpress-pa + | |-- jetspeed-mvn-pa-pom.xml + | |-- pom.xml + | `-- src + | `-- main + | |-- java + | | `-- org + | | `-- apache + | | `-- portals + | | `-- tutorials + | | `-- MyPortlet.java + | `-- webapp + | |-- WEB-INF + | | |-- portlet.xml + | | `-- web.xml + | |-- help.jsp + | |-- maximized.jsp + | `-- normal.jsp + |-- jetexpress-portal + | |-- jetspeed-mvn-portal-pom.xml + | |-- pom.xml + | `-- src + | |-- main + | | `-- webapp + | | `-- WEB-INF + | | `-- pages + | | `-- default-page.psml + | `-- sql + | `-- min + | `-- j2-seed.xml + |-- jetspeed-mvn-settings.xml + `-- pom.xml +</source> + <subsection name="Modules"> + <p> + The generated portal project is a Maven multi-module project. It consists of a simple + parent project, and two submodules: <b>jetexpress-portal</b> and <b>jetexpress-pa</b>. + The parent project does not produce any artifact by itself, but it lists its submodules + and defines some project wide settings and properties, such as versions of dependencies. + </p> + <p> + The <b>jetexpress-portal</b> submodule provides a Jetspeed portal. It contains the configuration + of the portal, its pages and decorators. This is where you do any portal-wide customizations. + </p> + <p> + The <b>jetexpress-pa</b> submodule provides a portlet application. It contains the actual + portlets that will be displayed on your portal's pages. The generated project comes with + one sample portlet, MyPortlet.java. + </p> + </subsection> + <subsection name="Dependencies"> + <p> + Since this is a Maven project, all project dependencies are managed by Maven. + The parent project as well as its submodules each have a <b>pom.xml</b> file + in which their dependencies are defined. Versions of dependencies are all + stored as properties in the parent project's pom, so they are in one place + for easier maintenance. + </p> + </subsection> + <subsection name="Configuration"> + <p> + The file <b>jetspeed-mvn-settings.xml</b> contains a number of configuration + parameters to build and deploy the portal. This file needs to be adapted to your + local environment before you can build and deploy the portal. We will do this + in the <a href="configure-maven.html">next step.</a> + </p> + </subsection> + </section> + <section name="Next"> + <p> + Now that you have a general idea of what is inside the project, and what it is for, + let's <a href="configure-maven.html">configure the Maven build for your system</a>. + </p> + <p> + <a href="genapp.html">Previous</a> - <a href="configure-maven.html">Next</a> + </p> + </section> + + </body> +</document> +
