[gatein-commits] gatein SVN: r8451 - in epp/docs/branches/5.2/User_Guide: en-US and 1 other directories.
do-not-reply at jboss.org
do-not-reply at jboss.org
Tue Feb 21 21:34:29 EST 2012
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'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/"></ulink>) 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_Platform/"></ulink>) 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_Platform/" 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'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_Platform/">Reference 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_Platform/" 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
More information about the gatein-commits
mailing list