[gatein-commits] gatein SVN: r8451 - in epp/docs/branches/5.2/User_Guide: en-US and 1 other directories.

Author: jaredmorgs Date: 2012-02-21 21:34:28 -0500 (Tue, 21 Feb 2012) New Revision: 8451 Modified: epp/docs/branches/5.2/User_Guide/en-US/Book_Info.xml epp/docs/branches/5.2/User_Guide/en-US/Revision_History.xml epp/docs/branches/5.2/User_Guide/en-US/User_Guide.xml epp/docs/branches/5.2/User_Guide/en-US/modules/portal/Manage_Portals.xml epp/docs/branches/5.2/User_Guide/publican.cfg Log: Draft content for https://bugzilla.redhat.com/show_bug.cgi?id=794408. Require info for Import Modes in Import and Export section of User Guide Modified: epp/docs/branches/5.2/User_Guide/en-US/Book_Info.xml =================================================================== --- epp/docs/branches/5.2/User_Guide/en-US/Book_Info.xml 2012-02-21 21:30:26 UTC (rev 8450) +++ epp/docs/branches/5.2/User_Guide/en-US/Book_Info.xml 2012-02-22 02:34:28 UTC (rev 8451) @@ -8,7 +8,7 @@ <productname>JBoss Enterprise Portal Platform</productname> <productnumber>5.2</productnumber> <edition>5.2.1</edition> - <pubsnumber>2</pubsnumber> + <pubsnumber>3</pubsnumber> <abstract> <para> This document provides an easy to follow guide to the functions and Modified: epp/docs/branches/5.2/User_Guide/en-US/Revision_History.xml =================================================================== --- epp/docs/branches/5.2/User_Guide/en-US/Revision_History.xml 2012-02-21 21:30:26 UTC (rev 8450) +++ epp/docs/branches/5.2/User_Guide/en-US/Revision_History.xml 2012-02-22 02:34:28 UTC (rev 8451) @@ -8,6 +8,20 @@ <simpara> <revhistory> <revision> + <revnumber>5.2.1-3</revnumber> + <date>Wed Feb 22 2012</date> + <author> + <firstname>Jared</firstname> + <surname>Morgan</surname> + <email/> + </author> + <revdescription> + <simplelist> + <member>First draft of content for https://bugzilla.redhat.com/show_bug.cgi?id=794408. NEEDINFO marked as required.</member> + </simplelist> + </revdescription> + </revision> + <revision> <revnumber>5.2.1-2</revnumber> <date>Mon Jan 09 2012</date> <author> Modified: epp/docs/branches/5.2/User_Guide/en-US/User_Guide.xml =================================================================== --- epp/docs/branches/5.2/User_Guide/en-US/User_Guide.xml 2012-02-21 21:30:26 UTC (rev 8450) +++ epp/docs/branches/5.2/User_Guide/en-US/User_Guide.xml 2012-02-22 02:34:28 UTC (rev 8451) @@ -1,10 +1,9 @@ <?xml version='1.0' encoding='UTF-8'?> -<!-- This document was created with Syntext Serna Free. --> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ +<!-- This document was created with Syntext Serna Free. --><!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!ENTITY % BOOK_ENTITIES SYSTEM "User_Guide.ent"> %BOOK_ENTITIES; ]> -<book> +<book status="draft"> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Book_Info.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Preface.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="modules/Introduction.xml"/> @@ -17,5 +16,4 @@ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="modules/GadgetsAdmin.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="modules/Further_Documentation.xml"/> <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/> - <index/> </book> Modified: epp/docs/branches/5.2/User_Guide/en-US/modules/portal/Manage_Portals.xml =================================================================== --- epp/docs/branches/5.2/User_Guide/en-US/modules/portal/Manage_Portals.xml 2012-02-21 21:30:26 UTC (rev 8450) +++ epp/docs/branches/5.2/User_Guide/en-US/modules/portal/Manage_Portals.xml 2012-02-22 02:34:28 UTC (rev 8451) @@ -1,426 +1,565 @@ -<?xml version='1.0' encoding='utf-8' ?> +<?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ <!ENTITY % BOOK_ENTITIES SYSTEM "../../User_Guide.ent"> %BOOK_ENTITIES; ]> <section id="sect-User_Guide-Manage_Portals"> - <title>Manage Portals</title> - - -<section id="sect-User_Guide-Create_a_New_Portal"> + <title>Manage Portals</title> + <section id="sect-User_Guide-Create_a_New_Portal"> <title>Create a New Portal</title> <para> Creating a new portal requires you to have a special permission that only an administrator can give you (if you are not an administrator). </para> <procedure> - <step> - <para> + <step> + <para> Click on <emphasis role="bold">Site</emphasis> in the toolbar then click the <emphasis role="bold">Add New Portal</emphasis> button. </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/AddPortal.png" format="PNG" align="center" scale="90" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/AddPortal.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="90" fileref="images/AddPortal.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/AddPortal.png" format="PNG"/> + </imageobject> + </mediaobject> + </step> + <step> + <para> This opens the <emphasis role="bold">Create New Portal</emphasis> window. </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/PortalSetting2.5.png" format="PNG" align="center" scale="90" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/PortalSetting2.5.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - - </step> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="90" fileref="images/PortalSetting2.5.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/PortalSetting2.5.png" format="PNG"/> + </imageobject> + </mediaobject> + </step> <step> - <para> + <para> The first tab in the window is the <emphasis role="bold">Portal Templates</emphasis> tab. This tab lets you choose a template for the new portal from templates that are saved in the installation. </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/PortalTemplates.png" format="PNG" align="center" scale="90" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/PortalTemplates.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="90" fileref="images/PortalTemplates.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/PortalTemplates.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> Click this tab if you have custom templates stored, or if you wish to use a default template for your portal. </para> </step> - <step> - <para> + <step> + <para> Click the next <emphasis role="bold">Portal Setting</emphasis> tab to configure some aspects of the new portal. </para> - <para> + <para> Enter a string for the <emphasis role="bold">Portal Name</emphasis> field. This field is required and must be unique. Only alphabetical, numerical, dash and underscore characters are allowed for this field and the name must be between 3 and 30 characters. </para> - </step> - <step> - <para> + </step> + <step> + <para> Select the default display language for the portal. </para> - </step> - <step> - <para> + </step> + <step> + <para> Enter a Label for the new portal. This field is optional. </para> - </step> - <step> - <para> + </step> + <step> + <para> Enter a description of the portal. This field is optional. </para> - </step> - <step> - <para> + </step> + <step> + <para> Select a skin for a portal. </para> - </step> - <step> - <para> + </step> + <step> + <para> Click on the <guilabel>Properties</guilabel> tab to fill in the <guilabel>Keep session alive</guilabel> property. There are three options: <variablelist> - <varlistentry> - <term>Never</term> - <listitem> - <para> + <varlistentry> + <term>Never</term> + <listitem> + <para> The session will never timeout, even if an application requests it. </para> - </listitem> - </varlistentry> - <varlistentry> - <term>On-demand</term> - <listitem> - <para> + </listitem> + </varlistentry> + <varlistentry> + <term>On-demand</term> + <listitem> + <para> The session will timeout if an application requests it </para> - </listitem> - </varlistentry> - <varlistentry> - <term>Always</term> - <listitem> - <para> + </listitem> + </varlistentry> + <varlistentry> + <term>Always</term> + <listitem> + <para> The session will time out after a set period. </para> - </listitem> - </varlistentry> - </variablelist> + </listitem> + </varlistentry> + </variablelist> </para> - </step> - <step> - <para> - Also while on the <guilabel>Properties</guilabel> tab, check or uncheck the box labeled <guilabel>Show info bar by default</guilabel>. If checked, portlets show an information bar containing the portlet's name, a <emphasis>help</emphasis> drop-down menu and <guilabel>minimize/maximize</guilabel> buttons after being added to a page. + </step> + <step> + <para> + Also while on the <guilabel>Properties</guilabel> tab, check or uncheck the box labeled <guilabel>Show info bar by default</guilabel>. If checked, portlets show an information bar containing the portlet&apos;s name, a <emphasis>help</emphasis> drop-down menu and <guilabel>minimize/maximize</guilabel> buttons after being added to a page. </para> - </step> - <step> - <para> + </step> + <step> + <para> Click on the <emphasis role="bold">Permission Setting</emphasis> tab and set the permissions for the Portal. </para> - <itemizedlist> - <listitem> - <para> + <itemizedlist> + <listitem> + <para> Two types of permissions need to be set for a new portal; <emphasis>Access Permission</emphasis> and <emphasis>Edit Permission</emphasis>. </para> - </listitem> - <listitem> - <para> + </listitem> + <listitem> + <para> <emphasis>Access Permission</emphasis> can be set to allow global access by checking the <emphasis role="bold">Make it Public</emphasis> box. Alternatively, specific permission for groups can be added by clicking <emphasis role="bold">Add Permission</emphasis>, then selecting a group in the left pane of the box and then a membership level in the right pane. </para> - </listitem> - <listitem> - <para> + </listitem> + <listitem> + <para> <emphasis>Edit Permission</emphasis> requires specific permissions to be set. Click on <emphasis role="bold">Select Permission</emphasis> and choose a group and level as above. </para> - </listitem> - </itemizedlist> - <para> + </listitem> + </itemizedlist> + <para> See <xref linkend="sect-User_Guide-User_management"/> and <xref linkend="sect-User_Guide-Manage_Permissions"/> for further information. </para> - </step> - <step> - <para> + </step> + <step> + <para> Click <emphasis role="bold">Save</emphasis> </para> - </step> + </step> </procedure> <para> - You also can edit or delete a portal. See <xref linkend="sect-User_Guide-Manage_Portals-Access_a_Portal" /> or <xref linkend="sect-User_Guide-Manage_Portals-Delete_a_Portal" /> for more details. + You also can edit or delete a portal. See <xref linkend="sect-User_Guide-Manage_Portals-Access_a_Portal"/> or <xref linkend="sect-User_Guide-Manage_Portals-Delete_a_Portal"/> for more details. </para> -</section> - - - <section id="sect-User_Guide-Manage_Portals-Access_a_Portal"> - <title>Access a Portal</title> - <para> + </section> + <section id="sect-User_Guide-Manage_Portals-Access_a_Portal"> + <title>Access a Portal</title> + <para> An administrator can easily access numerous portals running in the JBoss Enterprise Portal Platform instance. </para> - <para> + <para> To access a portal, click <emphasis role="bold">Site</emphasis> on the Toolbar. You will be taken to the Site Management page, which shows a list of portals and possible actions: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/ActivePortals.png" format="PNG" align="center" scale="110" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/ActivePortals.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - - </section> - <section id="proc-User_Guide-Manage_Portals-Edit_Layout"> - <title>Edit Layout</title> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="110" fileref="images/ActivePortals.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/ActivePortals.png" format="PNG"/> + </imageobject> + </mediaobject> + </section> + <section id="proc-User_Guide-Manage_Portals-Edit_Layout"> + <title>Edit Layout</title> + <para> To edit the layout of a portal, click the <emphasis>Edit Layout</emphasis> key beside the active portal you wish to edit: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/EditLayout.png" format="PNG" align="center" scale="110" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/EditLayout.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="110" fileref="images/EditLayout.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/EditLayout.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> New applications, containers or gadgets can be dragged from the <emphasis role="bold">Edit Inline Composer</emphasis> window (inset on the right of the screen) onto the main portal body. </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/EditLayout2.png" format="PNG" align="center" scale="110" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/EditLayout2.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="110" fileref="images/EditLayout2.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/EditLayout2.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> Elements already in place in the portal body can be rearranged or removed as required. Use the relevant button in the overlay that appears when you mouse over each element: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/EditLayout3.png" format="PNG" align="center" scale="110" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/EditLayout3.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="110" fileref="images/EditLayout3.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/EditLayout3.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> + Click the <guilabel>Finish</guilabel> or <guilabel>Abort</guilabel> buttons on the <emphasis role="bold">Edit Inline Composer</emphasis> window to save or discard your changes. <inlinemediaobject> + <imageobject> + <imagedata fileref="images/FinishAbortButtons.png"/> + </imageobject> + </inlinemediaobject> + </para> + <note> + <title>Custom Portlets</title> <para> - Click the <guilabel>Finish</guilabel> or <guilabel>Abort</guilabel> buttons on the <emphasis role="bold">Edit Inline Composer</emphasis> window to save or discard your changes. <inlinemediaobject><imageobject><imagedata fileref="images/FinishAbortButtons.png"/></imageobject></inlinemediaobject> - </para> - <note> - <title>Custom Portlets</title> - <para> - If you want to include a custom portlet or gadget on a page, you may wish to refer to the <emphasis>JBoss Portlet Tools User Guide</emphasis> in the JBoss Developer Studio documentation (<ulink type="http" url="http://docs.redhat.com/docs/en-US/JBoss_Developer_Studio/"...>) and/or the <emphasis role="bold">Portlet development</emphasis> section of the <emphasis>JBoss Enterprise Portal Platform Reference Guide</emphasis> (<ulink type="http" url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf...>) for more information about creating and deploying portlets. + If you want to include a custom portlet or gadget on a page, you may wish to refer to the <emphasis>JBoss Portlet Tools User Guide</emphasis> in the JBoss Developer Studio documentation (<ulink url="http://docs.redhat.com/docs/en-US/JBoss_Developer_Studio/" type="http"/>) and/or the <emphasis role="bold">Portlet development</emphasis> section of the <emphasis>JBoss Enterprise Portal Platform Reference Guide</emphasis> (<ulink url="http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platf... type="http"/>) for more information about creating and deploying portlets. </para> - </note> - </section> - - - <section id="proc-User_Guide-Manage_Portals-Edit_Navigation"> - <title>Edit Navigation</title> - <para> + </note> + </section> + <section id="proc-User_Guide-Manage_Portals-Edit_Navigation"> + <title>Edit Navigation</title> + <para> The portal navigation can be edited by clicking <emphasis role="bold">Site</emphasis> in the <emphasis role="bold">Toolbar</emphasis> and selecting the <emphasis>Edit Navigation</emphasis> link next to the portal you wish to edit: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/EditNavigation1.png" format="PNG" align="center" scale="110" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/EditNavigation1.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="110" fileref="images/EditNavigation1.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/EditNavigation1.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> The <emphasis>Navigation Management</emphasis> window appears: - </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/NavigationManagement.png" format="PNG" align="center" scale="100" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/NavigationManagement.png" format="PNG" align="center" contentwidth="70mm" /> - </imageobject> - </mediaobject> - <para> + </para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="100" fileref="images/NavigationManagement.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="70mm" align="center" fileref="images/NavigationManagement.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> More information about actions possible in this window can be found in <xref linkend="sect-User_Guide-Manage_Navigation_Nodes"/> </para> - </section> - - <section id="proc-User_Guide-Manage_Portals-Edit_Properties"> - <title>Edit Properties</title> - <para> + </section> + <section> + <title><remark>BZ#794408 NEEDINFO </remark>Export and Import</title> + <para>You can export and import portals and groups using the controls provided in the <menuchoice> + <guimenu>Group</guimenu> + <guimenu>Administration</guimenu> + <guimenu>Site Export/Import</guimenu> + </menuchoice> screen.</para> + <para>Exported sites and groups are saved in a zip archive, with the directory structure and XML configuration files preserved exactly as they appear on the source site.</para> + <para>The data included in the XML files includes the following:</para> + <variablelist> + <varlistentry> + <term>portal.xml</term> + <listitem> + <para>Contains the site layout information for the site.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>pages.xml</term> + <listitem> + <para>Contains all pages for the site.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>navigation.xml</term> + <listitem> + <para>Contains the navigation for the site.</para> + </listitem> + </varlistentry> + </variablelist> + <task id="task-Export_Sites_or_Groups"> + <title>Task: Export Sites or Groups</title> + <tasksummary> + <para>Follow this procedure to export a site or group using the Export/Import Sites tool. </para> + </tasksummary> + <taskprerequisites> + <title>Prerequisites</title> + <itemizedlist> + <listitem> + <para>You are logged into the portal with an Administrator account</para> + </listitem> + </itemizedlist> + </taskprerequisites> + <procedure> + <step> + <para>Click <menuchoice> + <guimenu>Group</guimenu> + <guimenu>Administration</guimenu> + <guimenu>Site Export/Import</guimenu> + </menuchoice> screen.</para> + <formalpara> + <title>Result</title> + <para>The Export/Import Sites screen displays.</para> + </formalpara> + </step> + <step> + <para>Expand the Sites menu.</para> + </step> + <step> + <para>The portal and group menus display, and contain all the portal types and group types (represented as gear icons) for the instance.</para> + </step> + <step> + <para>Select the portal or group you want to export.</para> + <formalpara> + <title>Result</title> + <para>The Export site button becomes available.</para> + </formalpara> + </step> + <step> + <para>Click <guibutton>Export site</guibutton>.</para> + <formalpara> + <title>Result</title> + <para>The site or group selected is exported and saved in your web browser Download directory.</para> + </formalpara> + </step> + </procedure> + </task> + <task id="task-Import_Sites_or_Groups"> + <title>Task: Import Sites or Groups</title> + <tasksummary> + <para>Follow this procedure to import a site or group using the Export/Import Sites tool. </para> + </tasksummary> + <taskprerequisites> + <title>Prerequisites</title> + <itemizedlist> + <listitem> + <para>You are logged into the portal with an Administrator account.</para> + </listitem> + </itemizedlist> + </taskprerequisites> + <procedure> + <step> + <para>Click <menuchoice> + <guimenu>Group</guimenu> + <guimenu>Administration</guimenu> + <guimenu>Site Export/Import</guimenu> + </menuchoice> screen.</para> + <formalpara> + <title>Result</title> + <para>The Export/Import Sites screen displays.</para> + </formalpara> + </step> + <step> + <para>Click <guimenu>Import site</guimenu> to display the Import site dialog.</para> + </step> + <step> + <para>Click Choose File, and select a portal or group Zip archive to import.</para> + <formalpara> + <title>Result</title> + <para>The selected Zip archive is appended to the Import site screen.</para> + </formalpara> + </step> + <step> + <para>Select the Import Mode to apply to the portal or group.</para> + <variablelist> + <varlistentry> + <term>Conserve</term> + <listitem> + <para><remark>NEEDINFO</remark></para> + </listitem> + </varlistentry> + <varlistentry> + <term>Insert</term> + <listitem> + <para><remark>NEEDINFO</remark></para> + </listitem> + </varlistentry> + <varlistentry> + <term>Merge</term> + <listitem> + <para><remark>Guessing what this option means because I have no links to source information.</remark>Merges the differences between the existing portal or group.</para> + </listitem> + </varlistentry> + <varlistentry> + <term>Overwrite</term> + <listitem> + <para><remark>Guessing what this option means because I have no links to source information.</remark>Overwrites the portal if a portal of the same name exists.</para> + </listitem> + </varlistentry> + </variablelist> + </step> + <step> + <para>Click <guibutton>Import</guibutton></para> + <formalpara> + <title>Result</title> + <para>The selected archive is imported, with the import mode applied to the files contained within the Zip.</para> + </formalpara> + </step> + </procedure> + </task> + </section> + <section id="proc-User_Guide-Manage_Portals-Edit_Properties"> + <title>Edit Properties</title> + <para> Portal properties such as language, skin and permissions can be set by clicking on <emphasis role="bold">Site</emphasis> in the <emphasis role="bold">Toolbar</emphasis> and selecting the <emphasis role="bold">Edit Portal Properties</emphasis> link for the portal you wish to edit: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/PortalProperties.png" format="PNG" align="center" scale="100" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/PortalProperties.png" format="PNG" align="center" contentwidth="130mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="100" fileref="images/PortalProperties.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="130mm" align="center" fileref="images/PortalProperties.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> The various tabs available in the edit properties window give access to the properties that can be edited for the chosen portal: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/EditPortal2.6New.png" format="PNG" align="center" scale="110" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/EditPortal2.6New.png" format="PNG" align="center" contentwidth="150mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="110" fileref="images/EditPortal2.6New.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="150mm" align="center" fileref="images/EditPortal2.6New.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> Click on <emphasis role="bold">Save</emphasis> or <emphasis role="bold">Cancel</emphasis> to either set or discard any changes you have made in the portal. </para> - </section> - - <section id="sect-User_Guide-Manage_Portals-Delete_a_Portal"> - <title>Delete a Portal</title> - <procedure> - <step> - <para> + </section> + <section id="sect-User_Guide-Manage_Portals-Delete_a_Portal"> + <title>Delete a Portal</title> + <procedure> + <step> + <para> To delete a portal click on the Delete icon beside the portal you no longer require. </para> - <para> + <para> The confirmation message will appear: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/SureDelete.png" format="PNG" align="center" scale="100" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/SureDelete.png" format="PNG" align="center" contentwidth="100mm" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="100" fileref="images/SureDelete.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="100mm" align="center" fileref="images/SureDelete.png" format="PNG"/> + </imageobject> + </mediaobject> + </step> + <step> + <para> Click <emphasis role="bold">OK</emphasis> </para> - </step> - </procedure> - </section> - - <section id="sect-User_Guide-Change_Portal_Skins"> - <title>Change Portal Skins</title> - <para> + </step> + </procedure> + </section> + <section id="sect-User_Guide-Change_Portal_Skins"> + <title>Change Portal Skins</title> + <para> Skins are graphic styles used to provide an attractive user interface. Each skin has its own characteristics with different backgrounds, icons, and other visual elements. </para> - <para> + <para> There are two ways to change the portal skin, each offering differing effects on the user experience. </para> - - <para> + <para> When you set skin using <emphasis role="bold">method one</emphasis> change is applied to this portal, and every user that accesses this portal will see it in the chosen skin. </para> - <para> + <para> When you change skin using <emphasis role="bold">method two</emphasis>, the skin is set for the logged in user and all portals within the domain will be shown with the chosen skin. </para> - <para> + <para> Portal skins set via method two have a higher priority when the portal is rendered. </para> - <variablelist> - <varlistentry> - <term><emphasis role="bold">Method One</emphasis></term> - <listitem> - <procedure> - <step> - <para> - Click on <emphasis role="bold">Site</emphasis>, then <emphasis role="bold">Edit Portal's Properties</emphasis>. + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">Method One</emphasis> + </term> + <listitem> + <procedure> + <step> + <para> + Click on <emphasis role="bold">Site</emphasis>, then <emphasis role="bold">Edit Portal&apos;s Properties</emphasis>. </para> - </step> - - <step> - <para> + </step> + <step> + <para> In the <emphasis role="bold">Portal Setting</emphasis> tab, select another skin <emphasis role="bold">Skin</emphasis> list </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/Skin1.png" format="PNG" scale="90"/> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/Skin1.png" format="PNG" contentwidth="120mm"/> - </imageobject> - </mediaobject> - </step> - <step> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata scale="90" fileref="images/Skin1.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="120mm" fileref="images/Skin1.png" format="PNG"/> + </imageobject> + </mediaobject> + </step> + <step> + <para> Click <emphasis role="bold">Save</emphasis> to <emphasis role="bold">Finish</emphasis>. </para> - </step> - </procedure> - </listitem> - </varlistentry> - <varlistentry> - <term><emphasis role="bold">Method Two</emphasis></term> - <listitem> - <procedure> - <step> - <para> + </step> + </procedure> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Method Two</emphasis> + </term> + <listitem> + <procedure> + <step> + <para> Mouse over the Start menu and click on <emphasis role="bold">Change Skin</emphasis>. </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/StarPortlet.png" format="PNG" scale="100" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/StarPortlet.png" format="PNG" contentwidth="120mm" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata scale="100" fileref="images/StarPortlet.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="120mm" fileref="images/StarPortlet.png" format="PNG"/> + </imageobject> + </mediaobject> + </step> + <step> + <para> Select a new skin from the Skin list. By clicking on the skin name a picture will appear in the preview pane. </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/SkinSet1.png" format="PNG" scale="90"/> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/SkinSet1.png" format="PNG" contentwidth="120mm" /> - </imageobject> - </mediaobject> - </step> - <step> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata scale="90" fileref="images/SkinSet1.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="120mm" fileref="images/SkinSet1.png" format="PNG"/> + </imageobject> + </mediaobject> + </step> + <step> + <para> Click <emphasis role="bold">Apply</emphasis> to apply to the portal. </para> - </step> - </procedure> - </listitem> - </varlistentry> - </variablelist> - <para> - More information about adding skins to a portal can be found in the <ulink type="http" url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... Guide</ulink> for this product. + </step> + </procedure> + </listitem> + </varlistentry> + </variablelist> + <para> + More information about adding skins to a portal can be found in the <ulink url="http://www.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platfo... type="http">Reference Guide</ulink> for this product. </para> - - </section> - - <section id="sect-User_Guide-Switching_between_Portals"> - <title>Switching between portals</title> - <para> + </section> + <section id="sect-User_Guide-Switching_between_Portals"> + <title>Switching between portals</title> + <para> Mouse over <emphasis role="bold">Site</emphasis> on the Toolbar for a list all portals in which you have at least access rights: </para> - <mediaobject> - <imageobject role="html"> - <imagedata fileref="images/SitePortlet.png" format="PNG" align="center" scale="100" /> - </imageobject> - <imageobject role="fo"> - <imagedata fileref="images/SitePortlet.png" format="PNG" align="center" scalefit="1" contentwidth="130mm" /> - </imageobject> - </mediaobject> - <para> + <mediaobject> + <imageobject role="html"> + <imagedata align="center" scale="100" fileref="images/SitePortlet.png" format="PNG"/> + </imageobject> + <imageobject role="fo"> + <imagedata contentwidth="130mm" align="center" scalefit="1" fileref="images/SitePortlet.png" format="PNG"/> + </imageobject> + </mediaobject> + <para> Users switch between portals by clicking on the desired portal. Please wait a few seconds for the change to take effect. </para> - </section> - - + </section> </section> - - Modified: epp/docs/branches/5.2/User_Guide/publican.cfg =================================================================== --- epp/docs/branches/5.2/User_Guide/publican.cfg 2012-02-21 21:30:26 UTC (rev 8450) +++ epp/docs/branches/5.2/User_Guide/publican.cfg 2012-02-22 02:34:28 UTC (rev 8451) @@ -1,11 +1,6 @@ -# Config::Simple 4.59 -# Tue Nov 17 15:59:35 2009 - xml_lang: en-US type: Book brand: JBoss debug:1 -#show_remarks: 1 -cvs_branch: DOCS-RHEL-6 -cvs_root: :ext:cvs.devel.redhat.com:/cvs/dist -cvs_pkg: JBoss_Enterprise_Portal_Platform-User_Guide-5.2-web-__LANG__ \ No newline at end of file +show_remarks: 1 +git_branch: docs-rhel-6