[portal-commits] JBoss Portal SVN: r8423 - in docs/trunk/quickstartuser/en: images and 1 other directories.

Author: cdelashmutt Date: 2007-09-21 16:20:32 -0400 (Fri, 21 Sep 2007) New Revision: 8423 Modified: docs/trunk/quickstartuser/en/images/image001.png docs/trunk/quickstartuser/en/images/image002.png docs/trunk/quickstartuser/en/images/image006.png docs/trunk/quickstartuser/en/images/image012.png docs/trunk/quickstartuser/en/images/image013.png docs/trunk/quickstartuser/en/images/image014.png docs/trunk/quickstartuser/en/images/image015.png docs/trunk/quickstartuser/en/images/image016.png docs/trunk/quickstartuser/en/images/image019.png docs/trunk/quickstartuser/en/images/image022.png docs/trunk/quickstartuser/en/images/image023.png docs/trunk/quickstartuser/en/images/image024.png docs/trunk/quickstartuser/en/images/image075.png docs/trunk/quickstartuser/en/images/image076.png docs/trunk/quickstartuser/en/images/image077.png docs/trunk/quickstartuser/en/images/image078.png docs/trunk/quickstartuser/en/images/image080.png docs/trunk/quickstartuser/en/images/image081.png docs/trunk/quickstartuser/en/images/image082.png docs/trunk/quickstartuser/en/images/image084.png docs/trunk/quickstartuser/en/images/image085.png docs/trunk/quickstartuser/en/images/image086.png docs/trunk/quickstartuser/en/images/image087.png docs/trunk/quickstartuser/en/images/image088.png docs/trunk/quickstartuser/en/images/image089.png docs/trunk/quickstartuser/en/images/image090.png docs/trunk/quickstartuser/en/images/image091.png docs/trunk/quickstartuser/en/images/image092.png docs/trunk/quickstartuser/en/images/image093.png docs/trunk/quickstartuser/en/images/image094.png docs/trunk/quickstartuser/en/images/image096.png docs/trunk/quickstartuser/en/images/image098.png docs/trunk/quickstartuser/en/images/image100.png docs/trunk/quickstartuser/en/images/image103.png docs/trunk/quickstartuser/en/images/image104.png docs/trunk/quickstartuser/en/images/image105.png docs/trunk/quickstartuser/en/images/image106.png docs/trunk/quickstartuser/en/images/image107.png docs/trunk/quickstartuser/en/images/image108.png docs/trunk/quickstartuser/en/images/image109.png docs/trunk/quickstartuser/en/master.xml docs/trunk/quickstartuser/en/modules/deployportlet.xml docs/trunk/quickstartuser/en/modules/forward.xml docs/trunk/quickstartuser/en/modules/installation.xml docs/trunk/quickstartuser/en/modules/interaction.xml docs/trunk/quickstartuser/en/modules/portalterminology.xml Log: Updated quick start guide for 2.6.2 screens Modified: docs/trunk/quickstartuser/en/images/image001.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image002.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image006.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image012.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image013.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image014.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image015.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image016.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image019.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image022.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image023.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image024.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image075.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image076.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image077.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image078.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image080.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image081.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image082.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image084.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image085.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image086.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image087.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image088.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image089.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image090.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image091.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image092.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image093.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image094.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image096.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image098.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image100.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image103.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image104.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image105.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image106.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image107.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image108.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/images/image109.png =================================================================== (Binary files differ) Modified: docs/trunk/quickstartuser/en/master.xml =================================================================== --- docs/trunk/quickstartuser/en/master.xml 2007-09-21 16:23:32 UTC (rev 8422) +++ docs/trunk/quickstartuser/en/master.xml 2007-09-21 20:20:32 UTC (rev 8423) @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3CR3//EN" "../../docbook-support/support/docbook-dtd/docbookx.dtd" [ -<!ENTITY overview SYSTEM "../../common/en/modules/overview.xml"> +<!ENTITY overview SYSTEM "modules/overview.xml"> <!ENTITY forward SYSTEM "modules/forward.xml"> <!ENTITY installation SYSTEM "modules/installation.xml"> <!ENTITY portalterminology SYSTEM "modules/portalterminology.xml"> @@ -13,7 +13,7 @@ <bookinfo> <title>JBoss Portal 2.6.2-GA</title> <subtitle>Quickstart User Guide</subtitle> - <releaseinfo>Release 2.6.2-GA "Ninja"</releaseinfo> + <releaseinfo>Release 2.6.2-GA</releaseinfo> <author> <firstname>Kevin</firstname> Modified: docs/trunk/quickstartuser/en/modules/deployportlet.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/deployportlet.xml 2007-09-21 16:23:32 UTC (rev 8422) +++ docs/trunk/quickstartuser/en/modules/deployportlet.xml 2007-09-21 20:20:32 UTC (rev 8423) @@ -87,9 +87,7 @@ </mediaobject></para> <para>A list of all portlets will be displayed. Click on the - local.flashportlet.FlashPortlet link. Once the portal page refreshes, scroll - to the bottom of the page to see a dialog to create a new instance of the - Flash Portlet (Figure 45). <mediaobject> + "Create Instance" action link for the "Flash Portlet". This will bring up a view similar to Figure 45 that will allow you to name the new portlet instance. <mediaobject> <imageobject> <imagedata align="center" fileref="images/image103.png" format="PNG" valign="middle" /> @@ -97,16 +95,14 @@ <caption><para>Figure 45. Portlets admininstration.</para></caption> </mediaobject>Type in "Flash Portlet" as the instance name in the textbox - at the bottom of the page, and click on the "Create Instance" button. The - "Portlet Instances" tab page will be displayed automatically, with the new - "Flash Portlet" portlet instance that we created selected. (Figure 46). + at the bottom of the page, and click on the "Create Instance" button. The resulting view will show the summary information about the "Flash Portlet" portlet instance that we created. (Figure 46). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image104.png" format="PNG" valign="middle" /> </imageobject> - <caption><para>Figure 46. Portlet instances admininstration. + <caption><para>Figure 46. Portlet instances summary. </para></caption> </mediaobject>Now you can add this portlet instance to the Starter portal page. Click on the "Portal Objects" tab and navigate to the "Page layout" @@ -132,4 +128,4 @@ <caption><para>Figure 48. Starter portal page with "flash" portlet. </para></caption> </mediaobject></para> -</chapter> \ No newline at end of file +</chapter> Modified: docs/trunk/quickstartuser/en/modules/forward.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/forward.xml 2007-09-21 16:23:32 UTC (rev 8422) +++ docs/trunk/quickstartuser/en/modules/forward.xml 2007-09-21 20:20:32 UTC (rev 8423) @@ -71,11 +71,11 @@ </listitem> <listitem> - This guide was created with JBoss Portal 2.6. This guide is expected to be forward compatible with future versions of Portal (although the screenshots may vary slightly). + This guide was created with JBoss Portal 2.6.2. This guide is expected to be forward compatible with future versions of Portal (although the screenshots may vary slightly). </listitem> <listitem> JBoss Portal is platform independent, but this guide was developed using a Linux-based platform. This guide should work equally well for Unix/Linux/Windows installations because JBoss Portal is 100% Pure Java. Obviously, you may need use the run.bat instead of run.sh and use forward slashes instead of backslashes, etc. </listitem> </itemizedlist></para> -</chapter> \ No newline at end of file +</chapter> Modified: docs/trunk/quickstartuser/en/modules/installation.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/installation.xml 2007-09-21 16:23:32 UTC (rev 8422) +++ docs/trunk/quickstartuser/en/modules/installation.xml 2007-09-21 20:20:32 UTC (rev 8423) @@ -40,14 +40,13 @@ Once you have Java installed, you are ready to download the JBoss Portal bundle. The following link has the list of downloads for JBoss Portal: <ulink - url="http://www.jboss.com/products/JBoss Portal/downloads">http://labs.jboss.com/portal/jbossportal/downlo... - . Download the "JBoss Portal +JBoss AS" bundle by clicking the "Download" + url="http://labs.jboss.com/jbossportal/download">http://labs...;. + Download the "JBoss Portal + JBoss AS" bundle by clicking the "Download" link on the right of the page. From here, you will need to unzip it to your machine (Note: If you do not have a ZIP utility, please go to this link to get it: <ulink - url="http://sourceforge.net/projects/sevenzip/">http://sourc... - ). Once you have unzipped it, you should have a directory structure with - the following folders under, jboss-portal-2.6-GA: <itemizedlist> + url="http://sourceforge.net/projects/sevenzip/">http://sourc...>). Once you have unzipped it, you should have a directory structure with + the following folders under, jboss-portal-2.6.2-GA: <itemizedlist> <listitem> @@ -118,4 +117,4 @@ Portal.</para></caption> </mediaobject></para> </sect1> -</chapter> \ No newline at end of file +</chapter> Modified: docs/trunk/quickstartuser/en/modules/interaction.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/interaction.xml 2007-09-21 16:23:32 UTC (rev 8422) +++ docs/trunk/quickstartuser/en/modules/interaction.xml 2007-09-21 20:20:32 UTC (rev 8423) @@ -58,11 +58,13 @@ <sect1> <title>User Creation</title> - <para>Let's create a user for the portal. Click on the "You can create an - account." link in the user portlet. The create user view now shows in the + <para>Let's create a user for the portal. Click on the "Register" tab in + the user portlet. The basic create user view now shows in the user portlet. Enter the information as shown in Figure 7 (password is - starter). Once you have clicked "New user registration" button, the - default view will show (Figure 8). <mediaobject> + starter). Once you have clicked "Submit" button, the + user creation confirmation screen will show up (Figure 8). Validate the user + information and then click on the "Submit" button to finish the creation of + the new user.<mediaobject> <imageobject> <imagedata align="center" fileref="images/image077.png" format="png" valign="middle" /> @@ -76,8 +78,7 @@ valign="middle" /> </imageobject> - <caption><para>Figure 8. The default view after registering a new - user.</para></caption> + <caption><para>Figure 8. The user creation confirmation view.</para></caption> </mediaobject>This example models a user enrolling themselves in the portal security repository, and at this point the user could login and would have the default security role for the portal. Administrators can @@ -142,7 +143,7 @@ Please use the quickstart.zip for the batch upload. You may also download it from <ulink - url="http://docs.jboss.org/jbportal/v2.6/quickstartuser/en/quickstar... + url="http://docs.jboss.org/jbportal/v2.6/quickstartuser/quickstart.z... . </note>You can choose the destination folder for the upload by selecting @@ -162,7 +163,7 @@ The quickstart.zip file will be uploaded, extracted into the content repository, and the files and directories will now appear in the content management structure (see the new "quickstart" directory in Figure - 14).<mediaobject> + 14). This process may take a minute.<mediaobject> <imageobject> <imagedata align="left" fileref="images/image012.png" format="PNG" valign="middle" /> @@ -184,7 +185,7 @@ </imageobject> <caption><para>Figure 15. HTML files and sub-directories that were - uploaded intoquickstart directory shows in content management + uploaded into quickstart directory shows in content management repository. </para></caption> </mediaobject></para> @@ -207,7 +208,7 @@ <caption><para>Figure 17. Version view for index.html. </para></caption> </mediaobject>To edit this HTML file, click on the "text/html" link. The - WYSIWYG editor view will appear (Figures 18). Note: The WYSIWYG editor is + WYSIWYG editor view will appear (Figures 18). Click on the maximize icon in the upper right corner of the WYSIWYG editor if needed to make the editor portlet take up the entire page. Note: The WYSIWYG editor is dependent on browser. Some browsers show a box to enter HTML. <mediaobject> <imageobject> <imagedata align="center" fileref="images/image016.png" format="PNG" @@ -220,7 +221,7 @@ <para>HTML pages can be edited through this view. Let's change this page to point to our uploaded pages. Change the section title next to the PortletSwap table cell from "Project Information" to "Quickstart Guide" - and change the text following the link below that to "to see the + and change the text following the heading to be "Click here to see the Quickstart guide for JBoss Portal.". The updated text is in Figure 19. <mediaobject> <imageobject> @@ -231,8 +232,8 @@ <caption><para>Figure 19. Updated text in HTML page.</para></caption> </mediaobject></para> - <para>Now let's update the link to point to the index.html page in the - quickstart directory. Click on the "Click here" link under Portal + <para>Now let's create the link that will point to the index.html page in the + quickstart directory. Select the "Click here" text under Portal Documentation, then on the edit link button (it looks like a chain). The insert/edit link window appears. Change the Link URL to "quickstart/index.html" (Figure 20). <mediaobject> @@ -243,10 +244,10 @@ <caption><para>Figure 20. Insert/edit link window with updated link URL </para></caption> - </mediaobject>Click "Update" button to save the updated link. Then click + </mediaobject>Click "Insert" button to create the link. Then click "Create" button at the bottom of the portlet window to create the new version of the HTML file. The CMS Administration view shows again with the - new 1.1 version shown (Figure 21). The star icon next to the version + new 1.1 version shown (Figure 21). The check icon next to the version number shows this is the live version. <mediaobject> <imageobject> <imagedata align="left" fileref="images/image022.png" format="PNG" @@ -293,7 +294,7 @@ <caption><para>Figure 24. Admin portal page.</para></caption> </mediaobject>Click the "Members" tab to access the member management - page. Click on the "Search" button to see all of the users currently + page. Click on the "Search users" link to see all of the users currently enrolled in the portal security repository (Figure 25). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image084.png" format="PNG" @@ -312,10 +313,10 @@ <caption><para>Figure 26. User portlet with available roles view. </para></caption> - </mediaobject>Add the "Administrators" role to this user by selecting it - from the "Available roles" list box and clicking the "Add Roles" button. - Click the "Assign roles" button to apply the new roles list to the user. - This brings us back to the User portlet menu view (Figure 27). + </mediaobject>Add the "Administrators" role to this user by checking the + check box next to the "Administrators" label. + Click the "Submit" button to apply the new role to the user. + This brings us back to the main User Management view (Figure 27). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image086.png" format="PNG" @@ -324,7 +325,8 @@ <caption><para>Figure 27. User portlet menu view.</para></caption> </mediaobject>Now let's look at the user profile for the starter user. - Click on the "Profile" link next to the starter user. The user profile + Click on "Search Users" again to get back to the user result list, and then + click on the "Edit user" link next to the starter user. The user profile view appears (Figure 28). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image087.png" format="PNG" @@ -333,15 +335,17 @@ <caption><para>Figure 28. User profile view.</para></caption> </mediaobject>This shows all of the fields available in the user - profile. Enter the first name of "starter" and click the "Save changes" - button. The Member management page is displayed now (Figure 29). + profile. Under the "Personal Information" section, enter the first name + of "Starter" and click the "Submit" + button at the bottom of the page. The user list is redisplayed with the + updated first name for the "starter" user (Figure 29). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image089.png" format="PNG" valign="middle" /> </imageobject> - <caption><para>Figure 29. Member management portal page default view. + <caption><para>Figure 29. User search results with updated user first name. </para></caption> </mediaobject>Now, let's explore the management portlet, by clicking on the "Home" tab. This portlet shows a view of the portals, portal pages and @@ -354,9 +358,8 @@ <caption><para>Figure 30. Management portlet page view. </para></caption> - </mediaobject>Let's create a new portal page. Click on the "root" - breadcrumb link below the "Portal Objects" tab then choose "default" - portal. Enter "Starter" in the text field next to the "Create a page:" + </mediaobject>Let's create a new portal page. Click on the "default" + portal link in the "Portals" list at the bottom of the page. In the resulting view, enter "Starter" in the text field next to the "Create a page named:" label. Your portal page view should match the following figure (Figure 31).<mediaobject> <imageobject> @@ -366,7 +369,7 @@ <caption><para>Figure 31. Management portlet add page view. </para></caption> - </mediaobject>Click the "Add" button to create the new page. We now see + </mediaobject>Click the "Create Page" button to create the new page. We now see the "Starter" page in the list of portal pages (Figure 32). <mediaobject> <imageobject> <imagedata align="left" fileref="images/image091.png" format="PNG" @@ -386,13 +389,11 @@ <caption><para>Figure 33. Management portlet for Starter portal page. </para></caption> - </mediaobject>First, let's add a weather portlet. We know this is - portlet, so we can leave the "Content Type" drop-down set to "portlet". - It's a good idea to give the new portlet window a name instead of relying + </mediaobject>First, let's add a weather portlet. It's a good idea to + give the new portlet window a name instead of relying on the portal to generate one for you, so enter "weather" in the "Window - Name" field. In the list labeled "Select a portlet instance to associate - to this window", select the "WeatherPortletInstance" portlet instance and - click the "Select" button. You can verify that you have the proper portlet + Name" field. The weather portlet is a JSR-168 portlet, so we can leave the "Content Type" drop-down set to "portlet". +In the list labeled "Portlet instance associated to this window:", select the "WeatherPortletInstance" portlet instance. You can verify that you have the proper portlet instance selected by viewing the details that show up below the Portlet Instance list at the bottom of the portlet (Figure 34).<mediaobject> <imageobject> @@ -400,7 +401,7 @@ valign="middle" /> </imageobject> - <caption><para>Figure 34. Choosing the "WeatherPorletInstance" portlet + <caption><para>Figure 34. Choosing the "WeatherPortletInstance" portlet instance from the list. </para></caption> </mediaobject>Scroll up to the list box that is labeled "center Region". Click the "Add" button to the left of that list box. The "weather" portlet @@ -412,11 +413,9 @@ <caption><para>Figure 35. Weather portlet instance is added. </para></caption> - </mediaobject>Lets change the theme for the weather portlet window we + </mediaobject>Let's change the theme for the weather portlet window we just added so that the weather portlet window doesn't display any - decorations. Click on the "default" link in the breadcrumbs below the - "Portal Objects" tab, then choose the "Starter" link. Click on the "theme" - action link next to the "weather" window. Let's set the Window Renderer, + decorations. Just below the "Portal Objects" tab near the top of the page is a breadcrumbs list that shows us we are in the "Portals" management section, in the "default" portal, and in the "Starter" page layout. Each of the elements in the breadcrumbs list is a link that will allow you to navigate back to other portal components. Click on the "Starter page" link in the breadcrumbs. In the resulting view under the "Manage windows within Starter page" section, click on the "theme" action link next to the "weather" window. Let's set the Window Renderer, Decoration Renderer, and Portlet Renderer to "emptyRenderer" (Figure 36). <mediaobject> <imageobject> @@ -428,8 +427,8 @@ instance. </para></caption> </mediaobject>Click the "Update" button to apply the theme changes. Finally, let's take a look at security in the Management Portlet. Click on - the "Starter" page in the breadcrumbs below the "Portal Objects" tab. Next - click the "Security" link which is just below the breadcrumbs links, and + the "Starter page" link in the breadcrumbs below the "Portal Objects" tab. Next + click the "Security" link just under the "Manage Starter page" section title, and the list of available roles and actions is shown for the "Starter" portal page.(Figure 37). <mediaobject> <imageobject> @@ -450,4 +449,4 @@ <caption><para>Figure 38. The Starter portal page.</para></caption> </mediaobject></para> </sect1> -</chapter> \ No newline at end of file +</chapter> Modified: docs/trunk/quickstartuser/en/modules/portalterminology.xml =================================================================== --- docs/trunk/quickstartuser/en/modules/portalterminology.xml 2007-09-21 16:23:32 UTC (rev 8422) +++ docs/trunk/quickstartuser/en/modules/portalterminology.xml 2007-09-21 20:20:32 UTC (rev 8423) @@ -89,11 +89,11 @@ <caption><para>Figure 4. The default portal page with components highlighted.</para></caption> </mediaobject>Now we see that the default portal we are looking at has - four portal pages, and the default portal page has three portlets on it + five portal pages, and the default portal page has three portlets on it (greetings, user, and content view). In addition, we see that each portlet window is made up of decorations/controls and a portlet fragment (the content view does not have any decoration/controls). Each portlet can represent some fragment of information that you want to present to users. By having multiple portlets on a portal page, we can aggregate information from the portlets into a single browser window.</para> -</chapter> \ No newline at end of file +</chapter>