Author: mcaspers Date: 2011-03-15 18:28:27 -0400 (Tue, 15 Mar 2011) New Revision: 29807 Modified: trunk/jsf/docs/userguide/en-US/css_perspective.xml trunk/jsf/docs/userguide/en-US/preferences.xml trunk/jsf/docs/userguide/en-US/richfaces_support.xml trunk/jsf/docs/userguide/en-US/web_projects.xml Log: "General editing and screenshot updates" Modified: trunk/jsf/docs/userguide/en-US/css_perspective.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/css_perspective.xml 2011-03-15 22:27:53 UTC (rev 29806) +++ trunk/jsf/docs/userguide/en-US/css_perspective.xml 2011-03-15 22:28:27 UTC (rev 29807) @@ -177,7 +177,7 @@ <itemizedlist> <listitem> - <para id="text_font"> + <para id="text_font" xreflabel="Text/Font"> CSS Text/Font properties define the appearance of text, its font family, boldness, size and the style. </para> @@ -215,11 +215,11 @@ </listitem> <listitem> - <para id="background"> + <para id="background" xreflabel="Background"> You should use CSS background properties and <emphasis><property>Background</property></emphasis> tab to define the background effects of an element. </para> - <para id="boxes"> + <para id="boxes" xreflabel="Boxes"> <emphasis><property>Boxes</property></emphasis> tab is used to define CSS border properties, the box model and dimensions. The CSS border properties allow you to specify the style and color of an element's border. </para> @@ -257,7 +257,7 @@ </listitem> <listitem> - <para id="property_sheet"> + <para id="property_sheet" xreflabel="Property Sheet"> <emphasis><property>Property Sheet</property></emphasis> tab contains the categorized list of properties. Like in <xref linkend="PropertiesView"/> it's possible to edit the properties values. </para> @@ -272,7 +272,7 @@ </listitem> <listitem> - <para id="edited_properties"> + <para id="edited_properties" xreflabel="Edited Properties"> <emphasis><property>Edited Properties</property></emphasis> tab contains only "overflow-y" property which determines clipping of the element's content at the top and bottom edges. </para> Modified: trunk/jsf/docs/userguide/en-US/preferences.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/preferences.xml 2011-03-15 22:27:53 UTC (rev 29806) +++ trunk/jsf/docs/userguide/en-US/preferences.xml 2011-03-15 22:28:27 UTC (rev 29807) @@ -1,262 +1,329 @@ <?xml version='1.0' encoding='UTF-8'?> <chapter id="preferences"> - <?dbhtml filename="preferences.html"?> - <title>JBoss Tools Preferences</title> - - <para>Configuring the various <property>JBoss Developer Studio</property> features is done via - the <property>Preferences</property> screen by selecting <emphasis> - <property>Window &gt; Preferences &gt; JBoss Tools</property> - </emphasis> from the menu bar.</para> + <title>JBoss Tools Preferences</title> + <para> + Configuring the various <property>JBoss Developer Studio</property> features is done via the <property>Preferences</property> screen by selecting <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem></menuchoice> from the menu bar. + </para> + + <figure> + <title>Preferences are included in this dialog.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + From this screen, you can select these more specific sets of <property>JBoss Tools preferences</property>: + </para> + + <itemizedlist> + <listitem> + <para> + <xref linkend="ProjectArchives"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="Editors"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="VisualPageEditor2"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="el_variables"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="JSF"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="JSFPage"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="JSFPropject"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="JSFFlowDiagram"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="Seam"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="SeamValidator"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="Struts"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="struts_automation"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="Plug-inInsets"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="ResourceInsets"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="StrutsCustomization"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="StrutsProject"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="StrutsSupport"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="StrutsPages"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="StrutsFlowDiagram"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="tiles_diagram"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="Verification"/> + </para> + </listitem> + </itemizedlist> + + <para> + The <property>Preferences</property> dialog (<menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem></menuchoice> ) also allows to adjust settings for <xref linkend="JBossServerPreferences"/> and <xref linkend="XDoclet"/> module. + </para> + + <section id="ProjectArchives"> +<?dbhtml filename="ProjectArchives.html"?> + <title>Project Archives</title> + <para> + Click on the <emphasis> <property>Project Archives</property> </emphasis> to open the page for changing Project Archives preferences. + </para> + + <para> + Here you can determine settings for Core Preferences, Project Archives View, Project Explorer Preferences and Fileset Preferences. + </para> + <figure> - <title>Preferences are included in this dialog.</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_1.png"/> - </imageobject> - </mediaobject> + <title>Project Archives</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_2.png"/> + </imageobject> + </mediaobject> </figure> - - <para>From this screen, you can select these more specific sets of <property>JBoss Tools - preferences</property>:</para> - - <itemizedlist> - <listitem> - <para> - <xref linkend="ProjectArchives"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="Editors"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="VisualPageEditor2"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="el_variables"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="JSF"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="JSFPage"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="JSFPropject"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="JSFFlowDiagram"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="Seam"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="SeamValidator"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="Struts"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="struts_automation"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="Plug-inInsets"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="ResourceInsets"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="StrutsCustomization"/> - </para> - </listitem> - - - <listitem> - <para> - <xref linkend="StrutsProject"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="StrutsSupport"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="StrutsPages"/> - </para> - </listitem> - - <listitem> - <para> - <xref linkend="StrutsFlowDiagram"/> - </para> - </listitem> - - - <listitem> - <para> - <xref linkend="tiles_diagram"/> - </para> - </listitem> - <listitem> - <para> - <xref linkend="Verification"/> - </para> - </listitem> - </itemizedlist> - - <para>The <property>Preferences</property> dialog <emphasis>( <property>Window &gt; - Preferences</property>) </emphasis> also allows to adjust settings for <xref - linkend="JBossServerPreferences"/> and <xref linkend="XDoclet"/> module.</para> - - <section id="ProjectArchives"> - <?dbhtml filename="ProjectArchives.html"?> - <title>Project Archives</title> - - <para>Click on the <emphasis> - <property>Project Archives</property> - </emphasis> to open the page for changing Project Archives preferences.</para> - <para>Here you can determine settings for Core Preferences, Project Archives View, - Project Explorer Preferences and Fileset Preferences.</para> - - <figure> - <title>Project Archives</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_2.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The next table lists all available preferences for Project Archives and their - description.</para> - - <table> - <title>Project Archives Preferences</title> - - <tgroup cols="3"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <colspec colnum="3" colwidth="2*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - <entry>Default</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Enable incremental builder</entry> - <entry>Uncheck this option if you don&apos;t want to enable incremental - builder for your resources</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show build error dialog</entry> - <entry>If on, the Project Archives will show an error dialog - in case of a build or incremental update fails.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show output path next to packages</entry> - <entry>This option allows you to show or hide an output path next to - packages - <!--(<link linkend="full_outputpath_for_packages">See the - figure</link>)-->.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show the root directory of filesets</entry> - <entry>If on, the root directory is displayed next to filesets. - Otherwise, it&apos;s hidden - <!--(<link - linkend="full_rootdir_for_filesets">See the figure</link>)-->.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show project at the root</entry> - <entry>This option allows you to choose whether to display a project name at - the root of the packages or not. When checked, &apos;Show all - projects that contain packages&apos; is enabled - <!--(<link - linkend="project_at_the_root">See the figure</link>)-->.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show all projects that contain packages</entry> - <entry>Selecting this setting enables the Projects Archiving view to show or - hide all projects that contain packages. The option is available when - the previous one is checked.</entry> - <entry>Off</entry> - </row> - - <row> - <entry>Show node in all projects</entry> - <entry>Selecting this setting enables the Projects Archiving view to show - node in all projects.</entry> - <entry>Off</entry> - </row> - - <row> - <entry>Enable Default Excludes</entry> - <entry>You can set the list of files which will be excluded by default. - Other files will be omitted.</entry> - <entry>On</entry> - </row> - - </tbody> - </tgroup> - </table> - <!-- + + <para> + The next table lists all available preferences for Project Archives and their description. + </para> + + <table> + <title>Project Archives Preferences</title> + <tgroup cols="3"> + <colspec colnum="1" align="left" colwidth="2*"/> + + <colspec colnum="2" colwidth="4*"/> + + <colspec colnum="3" colwidth="2*"/> + + <thead> + <row> + <entry> + Option + </entry> + + <entry> + Description + </entry> + + <entry> + Default + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + Enable incremental builder + </entry> + + <entry> + Uncheck this option if you don&apos;t want to enable incremental builder for your resources + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show build error dialog + </entry> + + <entry> + If on, the Project Archives will show an error dialog in case of a build or incremental update fails. + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show output path next to packages + </entry> + + <entry> + This option allows you to show or hide an output path next to packages +<!--(<link linkend="full_outputpath_for_packages">See the + figure</link>)--> + . + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show the root directory of filesets + </entry> + + <entry> + If on, the root directory is displayed next to filesets. Otherwise, it&apos;s hidden +<!--(<link + linkend="full_rootdir_for_filesets">See the figure</link>)--> + . + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show project at the root + </entry> + + <entry> + This option allows you to choose whether to display a project name at the root of the packages or not. When checked, &apos;Show all projects that contain packages&apos; is enabled +<!--(<link + linkend="project_at_the_root">See the figure</link>)--> + . + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show all projects that contain packages + </entry> + + <entry> + Selecting this setting enables the Projects Archiving view to show or hide all projects that contain packages. The option is available when the previous one is checked. + </entry> + + <entry> + Off + </entry> + </row> + + <row> + <entry> + Show node in all projects + </entry> + + <entry> + Selecting this setting enables the Projects Archiving view to show node in all projects. + </entry> + + <entry> + Off + </entry> + </row> + + <row> + <entry> + Enable Default Excludes + </entry> + + <entry> + You can set the list of files which will be excluded by default. Other files will be omitted. + </entry> + + <entry> + On + </entry> + </row> + </tbody> + </tgroup> + </table> +<!-- <figure id="full_outputpath_for_packages"> <title>Show Full Output Path next to Packages</title> <mediaobject> @@ -284,10 +351,8 @@ </mediaobject> </figure> --> - - </section> - - <!--section id="CodeAssist"> + </section> +<!--section id="CodeAssist"> <?dbhtml filename="CodeAssist.html"?> <title>CodeAssist</title> <para>Select <emphasis> @@ -303,317 +368,484 @@ </mediaobject> </figure> </section--> - - <section id="Editors"> - <?dbhtml filename="Editors.html"?> - <title>Editors</title> - <para>To adjust settings common for all editors supplied with <property>JBoss Developer - Studio</property> you should select <emphasis> - <property>JBoss Tools > Web > Editors</property>.</emphasis></para> - - <figure> - <title>Editors</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_6.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On the Editors page the following preferences are available:</para> - - <table> - - <title>Editors Preferences</title> - <tgroup cols="3"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <colspec colnum="3" colwidth="2*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - <entry>Default</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Always use JBoss Tools editors with Open option</entry> - <entry/> - <entry>On</entry> - </row> - - <row> - <entry>Show warning when project has no JBoss Tools capabilities</entry> - <entry>Check this option to be sure that any JBoss Tools editor is fully - available for a particular type of file. If no, you&apos;ll be - warned about this.</entry> - <entry>On</entry> - </row> - - <row> - <entry>Use Source tab as a default for multi-tab editors</entry> - <entry>If on, an editor will open the files in the Source view by - default</entry> - <entry>Off</entry> - </row> - </tbody> - </tgroup> - </table> - - </section> - - <section id="VisualPageEditor2"> - <?dbhtml filename="VisualPageEditor.html"?> - <title>Visual Page Editor</title> - <para><emphasis> - <property>JBoss Tools &gt; Web &gt; Editors &gt; Visual Page - Editor</property> - </emphasis> screen allows you to control some aspects of the behavior of the - <property>Visual Page Editor</property> (VPE) for JSF/HTML files.</para> - <figure> - <title>Visual Page Editor</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_7.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The next table lists the possible settings that you can adjust on the - <property>General tab</property> of the VPE Preferences page.</para> - - - <table> - - <title>VPE General Preferences</title> - <tgroup cols="3"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - <colspec colnum="3" colwidth="2*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - <entry>Default</entry> - </row> - </thead> - - <tbody> - <row> - <entry>Show border for unknown tags</entry> - <entry>The option allows to place the border around unknown tags or undo - this</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show non-visual tags</entry> - <entry>Check this box, if you want the editor shows non-visual elements on - the page you're editing</entry> - <entry>Off</entry> - </row> - - <row> - <entry>Show selection tag bar</entry> - <entry>The option allows to show/hide the Selection Bar</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show text formatting bar</entry> - <entry>Check this box in order to show/hide the Text Formatting bar</entry> - <entry>On</entry> - </row> - - <row> - <entry>Show resource bundles usage as EL expressions</entry> - <entry>If the option is checked, the editor will show EL expressions instead - of the resource values</entry> - <entry>Off</entry> - </row> - - <row> - <entry>Ask for tag attributes during tag insert </entry> - <entry>Having this option off, the dialog with possible attributes for - inserting tag won&apos;t appear if all its attributes are optional</entry> - <entry>On</entry> - </row> - - <row> - <entry>Ask for confirmation when closing the Selection Bar</entry> - <entry>Check this box if you don&apos;t want the confirmation window - appears when closing the Selection Bar</entry> - <entry>On</entry> - </row> - - <row> - <entry>Select the default active editor&apos;s tab</entry> - <entry>The option provides possibility to choose one of the following - views - Visual/Source, Source or Preview, as default when opening the - editor</entry> - <entry>Visual/Source</entry> - </row> - <row> - <entry>Visual/Source editors splitting</entry> - <entry>The option allows to choose one of the following - Visual,Source layouts - Vertical Source on top, Vertical Visual on top,Horizontal Source to the left or Horizontal Visual to the left, - as a default one when opening the Visual/Source view</entry> - <entry>Vertical splitting with Source Editor on the top</entry> - </row> - <row> - <entry>Size of the Visual Editor pane (0 – 100%)</entry> - <entry>With the help of this scroll bar you can adjust the percentage rating - between the Source and Visual modes of the Visual/Source view</entry> - <entry>50%</entry> - </row> - </tbody> - </tgroup> - </table> - - <para>On the <property>Visual Templates</property> tab you can add, edit or remove <xref - linkend="vpe_templating"/>.</para> - <figure> - <title>Visual Page Editor Templates</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_8.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Select a template for editing from the available list and press <emphasis> - <property>Edit</property> - </emphasis> button. It will pick up the <xref linkend="template_dialog"/> where you can adjust new settings.</para> - </section> - - <section id="vpe_code_templates"> - <title>Visual Page Editor Code Templates</title> - <para>On the <emphasis> - <property>JBoss Tools &gt; Web &gt; Editors &gt; Visual Page Editor &gt; Code Templates</property></emphasis> - preferences page you can create new and edit existing XHTML templates. Such a template allows you to - quickly insert an often used snippet of XHTML code. + <section id="Editors"> +<?dbhtml filename="Editors.html"?> + <title>Editors</title> + <para> + To adjust settings common for all editors supplied with <property>JBoss Developer Studio</property> you should select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem></menuchoice>. + </para> + + <figure> + <title>Editors</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_6.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + On the Editors page the following preferences are available: + </para> + + <table> + <title>Editors Preferences</title> + <tgroup cols="3"> + <colspec colnum="1" align="left" colwidth="2*"/> + + <colspec colnum="2" colwidth="4*"/> + + <colspec colnum="3" colwidth="2*"/> + + <thead> + <row> + <entry> + Option + </entry> + + <entry> + Description + </entry> + + <entry> + Default + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + Always use JBoss Tools editors with Open option + </entry> + + <entry/> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show warning when project has no JBoss Tools capabilities + </entry> + + <entry> + Check this option to be sure that any JBoss Tools editor is fully available for a particular type of file. If no, you&apos;ll be warned about this. + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Use Source tab as a default for multi-tab editors + </entry> + + <entry> + If on, an editor will open the files in the Source view by default + </entry> + + <entry> + Off + </entry> + </row> + </tbody> + </tgroup> + </table> + </section> + + <section id="VisualPageEditor2"> +<?dbhtml filename="VisualPageEditor.html"?> + <title>Visual Page Editor</title> + <para> + <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Visual Page Editor</guimenuitem></menuchoice> screen allows you to control some aspects of the behavior of the <property>Visual Page Editor</property> (VPE) for JSF/HTML files. + </para> + + <figure> + <title>Visual Page Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_7.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + The next table lists the possible settings that you can adjust on the <property>General tab</property> of the VPE Preferences page. + </para> + + <table> + <title>VPE General Preferences</title> + <tgroup cols="3"> + <colspec colnum="1" align="left" colwidth="2*"/> + + <colspec colnum="2" colwidth="4*"/> + + <colspec colnum="3" colwidth="2*"/> + + <thead> + <row> + <entry> + Option + </entry> + + <entry> + Description + </entry> + + <entry> + Default + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + Show border for unknown tags + </entry> + + <entry> + The option allows to place the border around unknown tags or undo this + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show non-visual tags + </entry> + + <entry> + Check this box, if you want the editor shows non-visual elements on the page you're editing + </entry> + + <entry> + Off + </entry> + </row> + + <row> + <entry> + Show selection tag bar + </entry> + + <entry> + The option allows to show/hide the Selection Bar + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show text formatting bar + </entry> + + <entry> + Check this box in order to show/hide the Text Formatting bar + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Show resource bundles usage as EL expressions + </entry> + + <entry> + If the option is checked, the editor will show EL expressions instead of the resource values + </entry> + + <entry> + Off + </entry> + </row> + + <row> + <entry> + Ask for tag attributes during tag insert + </entry> + + <entry> + Having this option off, the dialog with possible attributes for inserting tag won&apos;t appear if all its attributes are optional + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Ask for confirmation when closing the Selection Bar + </entry> + + <entry> + Check this box if you don&apos;t want the confirmation window appears when closing the Selection Bar + </entry> + + <entry> + On + </entry> + </row> + + <row> + <entry> + Select the default active editor&apos;s tab + </entry> + + <entry> + The option provides possibility to choose one of the following views - Visual/Source, Source or Preview, as default when opening the editor + </entry> + + <entry> + Visual/Source + </entry> + </row> + + <row> + <entry> + Visual/Source editors splitting + </entry> + + <entry> + The option allows to choose one of the following Visual,Source layouts - Vertical Source on top, Vertical Visual on top,Horizontal Source to the left or Horizontal Visual to the left, as a default one when opening the Visual/Source view + </entry> + + <entry> + Vertical splitting with Source Editor on the top + </entry> + </row> + + <row> + <entry> + Size of the Visual Editor pane (0 – 100%) + </entry> + + <entry> + With the help of this scroll bar you can adjust the percentage rating between the Source and Visual modes of the Visual/Source view + </entry> + + <entry> + 50% + </entry> + </row> + </tbody> + </tgroup> + </table> + + <para> + On the <property>Visual Templates</property> tab you can add, edit or remove <xref + linkend="vpe_templating"/>. + </para> + + <figure> + <title>Visual Page Editor Templates</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_8.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Select a template for editing from the available list and press <emphasis> <property>Edit</property> </emphasis> button. It will pick up the <xref linkend="template_dialog"/> where you can adjust new settings. + </para> + </section> + + <section id="vpe_code_templates"> + <title>Visual Page Editor Code Templates</title> + <para> + On the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Visual Page Editor</guimenuitem><guimenuitem>Code Templates</guimenuitem></menuchoice> preferences page you can create new and edit existing XHTML templates. Such a template allows you to quickly insert an often used snippet of XHTML code. + </para> + + <figure> + <title>Visual Page Editor Code Templates</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_8a.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + VPE provides four predefined templates: + </para> + + <itemizedlist> + <listitem> + <para> + XHTML blank facelet page template </para> - - <figure> - <title>Visual Page Editor Code Templates</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_8a.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>VPE provides four predefined templates:</para> - <itemizedlist> - <listitem><para>XHTML blank facelet page template</para></listitem> - <listitem><para>Common facelet page template</para></listitem> - <listitem><para>Form facelet page template</para></listitem> - <listitem><para>New JSF composite component template</para></listitem> - </itemizedlist> - - <para>The following table lists the configuration options for the code templates.</para> - <table> - - <title>VPE Code Templates Options</title> - <tgroup cols="2"> - - <colspec colnum="1" align="left" colwidth="2*"/> - <colspec colnum="2" colwidth="4*"/> - - <thead> - <row> - <entry>Option</entry> - <entry>Description</entry> - </row> - </thead> - - <tbody> - <row> - <entry>New</entry> - <entry>Opens the dialog to create a new template. </entry> - </row> - - <row> - <entry>Edit</entry> - <entry>Opens the dialog to edit the currently selected template. </entry> - </row> - - <row> - <entry>Remove</entry> - <entry>Removes all selected templates. </entry> - </row> - - <row> - <entry>Restore Removed</entry> - <entry>Restores the removed templates.</entry> - </row> - - <row> - <entry>Revert to Default</entry> - <entry>Reverts the code templates list to default.</entry> - </row> - - <row> - <entry>Import</entry> - <entry>Allows you to import templates from the file system. </entry> - </row> - - <row> - <entry>Export</entry> - <entry>Allows you to export all selected templates to the file system. </entry> - </row> - </tbody> - </tgroup> - </table> - - </section> - - - <section id="el_variables"> - <?dbhtml filename="el_variables.html"?> - <title>El Variables</title> - <para>To specify necessary EL variables globally, i. e. for all projects and resources in - your workspace, you should go to <emphasis> - <property>JBoss Tools > Web > El Variables</property>. </emphasis></para> - - <figure> - <title>El Variables</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_9.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Click <emphasis> - <property>Add...</property> - </emphasis> to set value for a new EL variable. In the appeared wizard you should - specify the global values and press <emphasis> - <property>Finish</property> - </emphasis>.</para> - - <figure> - <title>Adding a Global El Variable</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_10.png"/> - </imageobject> - </mediaobject> - </figure> - - <note> - <title>Tip:</title> - <para>If you specify an equal variable in <xref linkend="el_exp_para"/> and in Preference EL dialog, variable from preference dialog will - have priority.</para> - </note> - </section> - <!--section id="JBossServers"> + </listitem> + + <listitem> + <para> + Common facelet page template + </para> + </listitem> + + <listitem> + <para> + Form facelet page template + </para> + </listitem> + + <listitem> + <para> + New JSF composite component template + </para> + </listitem> + </itemizedlist> + + <para> + The following table lists the configuration options for the code templates. + </para> + + <table> + <title>VPE Code Templates Options</title> + <tgroup cols="2"> + <colspec colnum="1" align="left" colwidth="2*"/> + + <colspec colnum="2" colwidth="4*"/> + + <thead> + <row> + <entry> + Option + </entry> + + <entry> + Description + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + New + </entry> + + <entry> + Opens the dialog to create a new template. + </entry> + </row> + + <row> + <entry> + Edit + </entry> + + <entry> + Opens the dialog to edit the currently selected template. + </entry> + </row> + + <row> + <entry> + Remove + </entry> + + <entry> + Removes all selected templates. + </entry> + </row> + + <row> + <entry> + Restore Removed + </entry> + + <entry> + Restores the removed templates. + </entry> + </row> + + <row> + <entry> + Revert to Default + </entry> + + <entry> + Reverts the code templates list to default. + </entry> + </row> + + <row> + <entry> + Import + </entry> + + <entry> + Allows you to import templates from the file system. + </entry> + </row> + + <row> + <entry> + Export + </entry> + + <entry> + Allows you to export all selected templates to the file system. + </entry> + </row> + </tbody> + </tgroup> + </table> + </section> + + <section id="el_variables"> +<?dbhtml filename="el_variables.html"?> + <title>El Variables</title> + <para> + To specify necessary EL variables globally, i. e. for all projects and resources in your workspace, you should go to <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>El Variables</guimenuitem></menuchoice>. + </para> + + <figure> + <title>El Variables</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_9.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Click <guibutton>Add...</guibutton> to set value for a new EL variable. In the appeared wizard you should specify the global values and press <guibutton>Finish</guibutton>. + </para> + + <figure> + <title>Adding a Global El Variable</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_10.png"/> + </imageobject> + </mediaobject> + </figure> + + <note> + <title>Tip:</title> + <para> + If you specify an equal variable in <xref linkend="el_exp_para"/> and in Preference EL dialog, variable from preference dialog will have priority. + </para> + </note> + </section> +<!--section id="JBossServers"> <?dbhtml filename="JBossServers.html"?> <title>JBoss Servers</title> <para>The following preferences can be changed on the <emphasis> @@ -629,615 +861,621 @@ </mediaobject> </figure> </section--> - - <section id="JSF"> - <?dbhtml filename="JSF.html"?> - <title>JSF</title> - <para>Select <emphasis> - <property>JBoss Tools &gt; Web &gt; JSF</property> - </emphasis> to get to the JSF Project specific preferences.</para> - <figure> - <title>JSF</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_11.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFPage"> - <?dbhtml filename="JSF Page.html"?> - <title>JSF Pages</title> - <para>By selecting <emphasis> - <property>JBoss Tools &gt; Web &gt; JSF &gt; JSF Pages</property> - </emphasis> you can add jsf pages or remove existing ones.</para> - <figure> - <title>JSF Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_12.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFPropject"> - <?dbhtml filename="JSFPropject.html"?> - <title>JSF Project</title> - <para>Select <emphasis> - <property>JBoss Tools > Web > JSF > Project</property> - </emphasis> to see JSF Project preferences page.</para> - <para>On the <emphasis> - <property>New Project</property> - </emphasis> tab you can set default values for New JSF Project wizard:</para> - - <itemizedlist> - <listitem> - <para><emphasis> - <property>Version</property> - </emphasis> for setting the default JSF Environment</para> - </listitem> - - <listitem> - <para><emphasis> - <property>Project Template</property> - </emphasis> so as <property>New JSF Project wizard</property> shows this - template as default for the chosen JSF Environment</para> - </listitem> - - <listitem> - <para><emphasis> - <property>Project Root</property> - </emphasis> for specifying default location for a new JSF project</para> - <para>If you check <emphasis> - <property>Use Default Path</property> - </emphasis> here, this box will be also checked in the <property>New JSF Project - wizard</property>.</para> - </listitem> - - <listitem> - <para><emphasis> - <property>Servlet Version</property> - </emphasis> for setting the default Servlet version of a new JSF project</para> - <para>Here it&apos;s also possible to define whether to register Web Context in <emphasis> - <property>server.xml</property> - </emphasis> while organizing a new project or not. Check the proper box in order - to do that.</para> - </listitem> - </itemizedlist> - - <figure> - <title>New JSF Project Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_13.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On the <emphasis> - <property>Import Project</property> - </emphasis> tab in the JSF Project screen you can determine the default Servlet version - for the Import JSF Project - wizard and also whether to register Web Context in <emphasis> - <property>server.xml</property> - </emphasis> or not.</para> - - <figure> - <title>Import JSF Project Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_14.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFValidator"> - <?dbhtml filename="JSFValidator.html"?> - <title>JSF Validator</title> - <para>Select <property>JBoss Tools > Web > JSF > Validator</property> page to configure the validator behavior. On this page you can change the severity level for different jsf problems which are controlled by validator.</para> - <figure> - <title>JSF Validator</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_14a.png" /> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="JSFFlowDiagram"> - <?dbhtml filename="JSFFlowDiagram.html"?> - <title>JSF Flow Diagram</title> - <para>Selecting <emphasis> - <property>JBoss Tools > Web > Editors > JSF Flow Diagram</property> - </emphasis> allows you to specify some aspects of the Diagram mode of the JSF - configuration file editor.</para> - - <figure> - <title>JSF Flow Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_15.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> - - <para>The first two items control the background grid for the diagram. The next two items - allow you to control the appearance of the labels for views (pages) and the transitions - between views. For these two items clicking the <emphasis> - <property>Change... </property> - </emphasis>button allows you to assign a font with a dialog box.</para> - - <para>The first check box determines whether a view in the diagram that doesn't have a - transition connecting it to another view yet should be written to the source code as a - partial navigation rule. The next check box determines whether the diagram cursor - reverts immediately to the standard selection mode after it's used in the - transition-drawing mode to draw a transition. Finally the last two check boxes concern - shortcuts. A shortcut is a transition that is there but isn't actually displayed in the - diagram as going all the way to the target view it's connected to, in order to make the - diagram clearer. With the check boxes you can decide whether to display a small - shortcut icon as part of the shortcut and also whether to display the target view as a - label or not.</para> - <figure> - <title>Add View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_16.png" scale="75"/> - </imageobject> - </mediaobject> - </figure> - <para>Selecting the Add View tab in the JSF Flow Diagram screen allows you to determine the - default template and file extension for views (pages) you add directly into the diagram - using a context menu or the view-adding mode of the diagram cursor.</para> - </section> - - <section id="label_decorations"> - <title>Label Decorations</title> - - <para>The Label Decorations page is opened from <emphasis> - <property>JBoss Tools > Web > Label Decorations</property>. </emphasis></para> - - <figure> - <title>Label Decorations</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_17.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On this page you can determine the format for a text output near to the decoration label - for different Web resources. To change the value for selected element, click <emphasis> - <property>Add Variable...</property> - </emphasis> button next to <emphasis> - <property>Format</property> - </emphasis> field. Appeared wizard will prompt you to select one from the available - list.</para> - - <figure> - <title>Label Decoration for Validator</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_18.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section id="Seam"> - <?dbhtml filename="Seam.html"?> - <title>Seam</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Seam</property> - </emphasis> page.</para> - <para>On <emphasis> - <property>Seam</property> - </emphasis> screen you can add and remove Seam runtimes.</para> - <para>Here is what Seam preference page looks like:</para> - <figure> - <title>Seam preference page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_19.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="SeamValidator"> - <?dbhtml filename="SeamValidator.html"?> - <title>Seam Validator</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Seam > Validator</property> - </emphasis> page.</para> - <para>In <emphasis> - <property>Validator</property> - </emphasis> panel you configure seam problems that will be processed by - validator.</para> - <figure> - <title>Seam Validator</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_20.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="SeamPagesDiagram"> - <?dbhtml filename="SeamPagesDiagram.html"?> - <title>Seam Pages Diagram</title> - - - - <para>In order to customize the layout of the Diagram used for editing and composing <property>page.xml</property> file in <property>Graphical mode</property> of <property>Seam Pages Editor</property> you can go to - <property>Window > Preferences > JBoss Tools > Web > Editors > Seam Pages Diagram</property>. + <section id="JSF"> +<?dbhtml filename="JSF.html"?> + <title>JSF</title> + <para> + Select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>JSF</guimenuitem></menuchoice> to get to the JSF Project specific preferences. + </para> + + <figure> + <title>JSF</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_11.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPage"> +<?dbhtml filename="JSF Page.html"?> + <title>JSF Pages</title> + <para> + By selecting <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>JSF</guimenuitem><guimenuitem>JSF Pages</guimenuitem></menuchoice> you can add jsf pages or remove existing ones. + </para> + + <figure> + <title>JSF Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_12.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPropject"> +<?dbhtml filename="JSFPropject.html"?> + <title>JSF Project</title> + <para> + Select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>JSF</guimenuitem><guimenuitem>Project</guimenuitem></menuchoice> to see JSF Project preferences page. + </para> + + <para> + On the <emphasis> <property>New Project</property> </emphasis> tab you can set default values for New JSF Project wizard: + </para> + + <itemizedlist> + <listitem> + <para> + <emphasis> <property>Version</property> </emphasis> for setting the default JSF Environment </para> - - <figure> - <title>Preferences of Seam Pages Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_44.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - - - - - <section id="Struts"> - <?dbhtml filename="Struts.html"?> - <title>Struts</title> - <para>By selecting <emphasis> - <property>JBoss Tools &gt; Web &gt; Struts</property> - </emphasis> you can configure Struts projects specific preferences.</para> - <figure> - <title>Struts projects preferences Page.</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_21.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="struts_automation"> - <?dbhtml filename="struts_automation.html"?> - <title>Struts Automation</title> - <para>On <emphasis> - <property>Automation</property> - </emphasis> panel you can modify default text for the Title Struts plug-in element, the - Validator Struts plug-in element, and error message resource files.</para> - <figure> - <title>Struts Automatic</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_22.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="Plug-inInsets"> - <?dbhtml filename="Plug-inInsets.html"?> - <title>Plug-in Insets</title> - <para>By selecting <emphasis> - <property>Web &gt; Struts &gt; Automation &gt; Plug-in Insets</property> - </emphasis> on tab Tiles you can define a default text for tiles plugin.</para> - <figure> - <title>Plug-in Insets</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_23.png"/> - </imageobject> - </mediaobject> - </figure> - <para>The same is done but for validator plugin on the tab Validators.</para> - <figure> - <title>Plug-in Insets of Validators</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_24.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="ResourceInsets"> - <?dbhtml filename="ResourceInsets.html"?> - <title>Resource Insets</title> - <para>To see Resource Insets preference page select <emphasis> - <property>JBoss Tools > Web > Struts > Automation > Resource Insets</property> - </emphasis>.</para> - <para>On <emphasis> - <property>Resource Insets</property> - </emphasis> panel you determine default error messages for error resource files.</para> - <figure> - <title>Resource Insets</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_25.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsCustomization"> - <?dbhtml filename="StrutsCustomization"?> - <title>Struts Customization</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Struts > Customization</property> - </emphasis> page.</para> - <para>In the<emphasis> - <property>Customization</property> - </emphasis> screen you configure Link Recognizer for Struts tags.</para> - <figure> - <title>Struts Customization</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_26.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsProject"> - <?dbhtml filename="StrutsProject.html"?> - <title>Struts Project</title> - <para>You can change the following preferences on the <emphasis> - <property>JBoss Tools > Web > Struts > Project</property> - </emphasis> preference page:</para> - <para>On <emphasis> - <property>Project</property> - </emphasis> panel you define a template for a new Struts created project: servlet - version, page template and so on.</para> - <figure> - <title>Struts Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_27.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Selecting the Import Project tab in the Struts Project screen allows you to determine - the default servlet version and whether to register Web Context in server.xml.</para> - <figure> - <title>Import Struts Pages</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_28.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsSupport"> - <?dbhtml filename="StrutsSupport.html"?> - <title>Struts Support</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Struts > Project > Struts Support</property> - </emphasis> page.</para> - <para>Select <emphasis> - <property>Struts Support</property> - </emphasis> screen if you want to configure Struts versions support settings.</para> - <figure> - <title>Struts Support</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_29.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsPages"> - <?dbhtml filename="StrutsPages.html"?> - <title>Struts Pages</title> - <para>You can change the following preferences on the JBoss Tools > Web > Struts > Struts - Pages preference page.</para> - <para>On <emphasis> - <property>Struts Pages</property> - </emphasis> panel you can add or remove Struts pages.</para> - <figure> - <title>Struts Pages</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_30.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="StrutsFlowDiagram"> - <?dbhtml filename="StrutsFlowDiagram.html"?> - <title>Struts Flow Diagram</title> - <para>Similarly to the JSF Flow Diagram screen, selecting <emphasis> - <property>JBoss Tools > Web > Editor > Struts Flow Diagram</property> - </emphasis> page allows you to specify aspects of the Diagram mode of the Struts - configuration file editor. The Struts Flow Diagram screen adds an option to hide the - Diagram tab and labeling settings for additional artifacts. </para> - <figure> - <title>Struts Flow Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_31.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Selecting the Add Page tab in the Struts Flow Diagram screen allows you to determine - the default template and file extension for views (pages) you add directly into the - diagram using a context menu or the view-adding mode of the diagram cursor.</para> - <figure> - <title>Adding Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_32.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="tiles_diagram"> - <?dbhtml filename="titles_diagram.html"?> - <title>Tiles Diagram</title> - <para><emphasis> - <property>JBoss Tools > Web > Editors > Title Diagram</property> - </emphasis> screen allows you control some settings for the placement of Tiles - definitions in the Diagram mode of the JBoss Tools Tiles editor.</para> - <figure> - <title>Title Diagram</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_33.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="Verification"> - <?dbhtml filename="Verification.html"?> - <title>Verification</title> - <para>The following preferences can be changed on the <emphasis> - <property>JBoss Tools > Web > Verification</property> - </emphasis> page.</para> - <para>On Rules Configuration tab of <emphasis> - <property>Verification</property> - </emphasis> panel you can determine JSF and Struts rules.</para> - <figure> - <title>Verification</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_34.png"/> - </imageobject> - </mediaobject> - </figure> - <para>On Options tab you can define a limit for the reported errors number.</para> - <figure> - <title>Options of Verification</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_35.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section id="JBossServerPreferences"> - <?dbhtml filename="View.html"?> - <title>Server Preferences</title> - <para>Preferences for <property>JBoss Server</property> and other servers can be changed on - the <emphasis> - <property>Server</property> - </emphasis> page.</para> - - <figure> - <title>Server Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_36.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>On the <emphasis> - <property>Server > Runtime Environments</property> - </emphasis> page you can add new or modify already defined Server Runtime.</para> - - <figure> - <title>Runtime Environments</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_37.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Server Launching preferences can be configured on the <emphasis> - <property>Server > Launching</property> - </emphasis> page.</para> - - <figure> - <title>Server Launching Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_38.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Going to <emphasis> - <property>Server > Audio</property> - </emphasis> you can enable/disable the sound notification for different Server states - and actions and set the sound volume as well.</para> - - <figure> - <title>Sound Notification Adjustment</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_40.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="XDoclet"> - <?dbhtml filename="XDoclet.html"?> - <title>XDoclet</title> - <para>The preferences for XDoclet can be changed if you click <emphasis> - <property>XDoclet</property> - </emphasis> on the left navigation bar.</para> - <para>On the <emphasis> - <property>XDoclet</property> - </emphasis> screen it&apos;s possible to enable/disable XDoclet builder by checking - proper box, specify XDoclet home and determine XDoclet module version as well.</para> - - <figure> - <title>XDoclet Runtime Preferences Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_41.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Switch to <emphasis> - <property>XDoclet > ejbdoclet</property> - </emphasis> page in order to adjust settings for EJB-specific sub-tasks.</para> - - <figure> - <title>ejbdoclet</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_42.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>To configure settings for various web-specific XDoclet sub-tasks, follow to <emphasis> - <property>XDoclet > webdoclet</property> - </emphasis> page.</para> - - <figure> - <title>webdoclet</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/preferences/preferences_43.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <!--section id="XDocletTemplates"> + </listitem> + + <listitem> + <para> + <emphasis> <property>Project Template</property> </emphasis> so as <property>New JSF Project wizard</property> shows this template as default for the chosen JSF Environment + </para> + </listitem> + + <listitem> + <para> + <emphasis> <property>Project Root</property> </emphasis> for specifying default location for a new JSF project + </para> + + <para> + If you check <emphasis> <property>Use Default Path</property> </emphasis> here, this box will be also checked in the <property>New JSF Project wizard</property>. + </para> + </listitem> + + <listitem> + <para> + <emphasis> <property>Servlet Version</property> </emphasis> for setting the default Servlet version of a new JSF project + </para> + + <para> + Here it&apos;s also possible to define whether to register Web Context in <emphasis> <property>server.xml</property> </emphasis> while organizing a new project or not. Check the proper box in order to do that. + </para> + </listitem> + </itemizedlist> + + <figure> + <title>New JSF Project Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_13.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + On the <emphasis> <property>Import Project</property> </emphasis> tab in the JSF Project screen you can determine the default Servlet version for the Import JSF Project wizard and also whether to register Web Context in <emphasis> <property>server.xml</property> </emphasis> or not. + </para> + + <figure> + <title>Import JSF Project Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_14.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFValidator"> +<?dbhtml filename="JSFValidator.html"?> + <title>JSF Validator</title> + <para> + Select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>JSF</guimenuitem><guimenuitem>Validator</guimenuitem></menuchoice> page to configure the validator behavior. On this page you can change the severity level for different jsf problems which are controlled by validator. + </para> + + <figure> + <title>JSF Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_14a.png" /> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFFlowDiagram"> +<?dbhtml filename="JSFFlowDiagram.html"?> + <title>JSF Flow Diagram</title> + <para> + Selecting <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>JSF Flow Diagram</guimenuitem></menuchoice> allows you to specify some aspects of the Diagram mode of the JSF configuration file editor. + </para> + + <figure> + <title>JSF Flow Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_15.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + + <para> + The first two items control the background grid for the diagram. The next two items allow you to control the appearance of the labels for views (pages) and the transitions between views. For these two items clicking the <emphasis> <property>Change... </property> </emphasis>button allows you to assign a font with a dialog box. + </para> + + <para> + The first check box determines whether a view in the diagram that doesn't have a transition connecting it to another view yet should be written to the source code as a partial navigation rule. The next check box determines whether the diagram cursor reverts immediately to the standard selection mode after it's used in the transition-drawing mode to draw a transition. Finally the last two check boxes concern shortcuts. A shortcut is a transition that is there but isn't actually displayed in the diagram as going all the way to the target view it's connected to, in order to make the diagram clearer. With the check boxes you can decide whether to display a small shortcut icon as part of the shortcut and also whether to display the target view as a label or not. + </para> + + <figure> + <title>Add View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_16.png" scale="75"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Selecting the Add View tab in the JSF Flow Diagram screen allows you to determine the default template and file extension for views (pages) you add directly into the diagram using a context menu or the view-adding mode of the diagram cursor. + </para> + </section> + + <section id="label_decorations"> + <title>Label Decorations</title> + <para> + The Label Decorations page is opened from <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Label Decorations</guimenuitem></menuchoice>. + </para> + + <figure> + <title>Label Decorations</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_17.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + On this page you can determine the format for a text output near to the decoration label for different Web resources. To change the value for selected element, click <emphasis> <property>Add Variable...</property> </emphasis> button next to <emphasis> <property>Format</property> </emphasis> field. Appeared wizard will prompt you to select one from the available list. + </para> + + <figure> + <title>Label Decoration for Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_18.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Seam"> +<?dbhtml filename="Seam.html"?> + <title>Seam</title> + <para> + The following preferences can be changed on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Seam</guimenuitem></menuchoice> page. + </para> + + <para> + On <emphasis> <property>Seam</property> </emphasis> screen you can add and remove Seam runtimes. + </para> + + <para> + Here is what Seam preference page looks like: + </para> + + <figure> + <title>Seam preference page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_19.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="SeamValidator"> +<?dbhtml filename="SeamValidator.html"?> + <title>Seam Validator</title> + <para> + The following preferences can be changed on the <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem> </guimenuitem><guimenuitem>Seam</guimenuitem><guimenuitem>Validator</guimenuitem></menuchoice> page. + </para> + + <para> + In <emphasis> <property>Validator</property> </emphasis> panel you configure seam problems that will be processed by validator. + </para> + + <figure> + <title>Seam Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_20.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="SeamPagesDiagram"> +<?dbhtml filename="SeamPagesDiagram.html"?> + <title>Seam Pages Diagram</title> + <para> + In order to customize the layout of the Diagram used for editing and composing <filename>page.xml</filename> file in <property>Graphical mode</property> of <property>Seam Pages Editor</property> you can go to <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Preferences</guimenuitem><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Editors</guimenuitem><guimenuitem>Seam Pages Diagram</guimenuitem></menuchoice>. + </para> + + <figure> + <title>Preferences of Seam Pages Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_44.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Struts"> +<?dbhtml filename="Struts.html"?> + <title>Struts</title> + <para> + By selecting <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem></menuchoice> you can configure Struts projects specific preferences. + </para> + + <figure> + <title>Struts projects preferences Page.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_21.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="struts_automation"> +<?dbhtml filename="struts_automation.html"?> + <title>Struts Automation</title> + <para> + On <emphasis> <property>Automation</property> </emphasis> panel you can modify default text for the Title Struts plug-in element, the Validator Struts plug-in element, and error message resource files. + </para> + + <figure> + <title>Struts Automatic</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_22.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Plug-inInsets"> +<?dbhtml filename="Plug-inInsets.html"?> + <title>Plug-in Insets</title> + <para> + By selecting <menuchoice><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Automation</guimenuitem><guimenuitem>Plug-in Insets</guimenuitem></menuchoice> on tab Tiles you can define a default text for tiles plugin. + </para> + + <figure> + <title>Plug-in Insets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_23.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + The same is done but for validator plugin on the tab Validators. + </para> + + <figure> + <title>Plug-in Insets of Validators</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_24.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ResourceInsets"> +<?dbhtml filename="ResourceInsets.html"?> + <title>Resource Insets</title> + <para> + To see Resource Insets preference page select <menuchoice><guimenuitem>JBoss Tools</guimenuitem><guimenuitem>Web</guimenuitem><guimenuitem>Struts</guimenuitem><guimenuitem>Automation</guimenuitem><guimenuitem>Resource Insets</guimenuitem></menuchoice>. + </para> + + <para> + On <emphasis> <property>Resource Insets</property> </emphasis> panel you determine default error messages for error resource files. + </para> + + <figure> + <title>Resource Insets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_25.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsCustomization"> +<?dbhtml filename="StrutsCustomization"?> + <title>Struts Customization</title> + <para> + The following preferences can be changed on the <emphasis> <property>JBoss Tools > Web > Struts > Customization</property> </emphasis> page. + </para> + + <para> + In the<emphasis> <property>Customization</property> </emphasis> screen you configure Link Recognizer for Struts tags. + </para> + + <figure> + <title>Struts Customization</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_26.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsProject"> +<?dbhtml filename="StrutsProject.html"?> + <title>Struts Project</title> + <para> + You can change the following preferences on the <emphasis> <property>JBoss Tools > Web > Struts > Project</property> </emphasis> preference page: + </para> + + <para> + On <emphasis> <property>Project</property> </emphasis> panel you define a template for a new Struts created project: servlet version, page template and so on. + </para> + + <figure> + <title>Struts Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_27.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Selecting the Import Project tab in the Struts Project screen allows you to determine the default servlet version and whether to register Web Context in server.xml. + </para> + + <figure> + <title>Import Struts Pages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_28.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsSupport"> +<?dbhtml filename="StrutsSupport.html"?> + <title>Struts Support</title> + <para> + The following preferences can be changed on the <emphasis> <property>JBoss Tools > Web > Struts > Project > Struts Support</property> </emphasis> page. + </para> + + <para> + Select <emphasis> <property>Struts Support</property> </emphasis> screen if you want to configure Struts versions support settings. + </para> + + <figure> + <title>Struts Support</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_29.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsPages"> +<?dbhtml filename="StrutsPages.html"?> + <title>Struts Pages</title> + <para> + You can change the following preferences on the JBoss Tools > Web > Struts > Struts Pages preference page. + </para> + + <para> + On <emphasis> <property>Struts Pages</property> </emphasis> panel you can add or remove Struts pages. + </para> + + <figure> + <title>Struts Pages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_30.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="StrutsFlowDiagram"> +<?dbhtml filename="StrutsFlowDiagram.html"?> + <title>Struts Flow Diagram</title> + <para> + Similarly to the JSF Flow Diagram screen, selecting <emphasis> <property>JBoss Tools > Web > Editor > Struts Flow Diagram</property> </emphasis> page allows you to specify aspects of the Diagram mode of the Struts configuration file editor. The Struts Flow Diagram screen adds an option to hide the Diagram tab and labeling settings for additional artifacts. + </para> + + <figure> + <title>Struts Flow Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_31.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Selecting the Add Page tab in the Struts Flow Diagram screen allows you to determine the default template and file extension for views (pages) you add directly into the diagram using a context menu or the view-adding mode of the diagram cursor. + </para> + + <figure> + <title>Adding Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_32.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="tiles_diagram"> +<?dbhtml filename="titles_diagram.html"?> + <title>Tiles Diagram</title> + <para> + <emphasis> <property>JBoss Tools > Web > Editors > Title Diagram</property> </emphasis> screen allows you control some settings for the placement of Tiles definitions in the Diagram mode of the JBoss Tools Tiles editor. + </para> + + <figure> + <title>Title Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_33.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Verification"> +<?dbhtml filename="Verification.html"?> + <title>Verification</title> + <para> + The following preferences can be changed on the <emphasis> <property>JBoss Tools > Web > Verification</property> </emphasis> page. + </para> + + <para> + On Rules Configuration tab of <emphasis> <property>Verification</property> </emphasis> panel you can determine JSF and Struts rules. + </para> + + <figure> + <title>Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_34.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + On Options tab you can define a limit for the reported errors number. + </para> + + <figure> + <title>Options of Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_35.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JBossServerPreferences"> +<?dbhtml filename="View.html"?> + <title>Server Preferences</title> + <para> + Preferences for <property>JBoss Server</property> and other servers can be changed on the <emphasis> <property>Server</property> </emphasis> page. + </para> + + <figure> + <title>Server Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + On the <emphasis> <property>Server > Runtime Environments</property> </emphasis> page you can add new or modify already defined Server Runtime. + </para> + + <figure> + <title>Runtime Environments</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Server Launching preferences can be configured on the <emphasis> <property>Server > Launching</property> </emphasis> page. + </para> + + <figure> + <title>Server Launching Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_38.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Going to <emphasis> <property>Server > Audio</property> </emphasis> you can enable/disable the sound notification for different Server states and actions and set the sound volume as well. + </para> + + <figure> + <title>Sound Notification Adjustment</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_40.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="XDoclet"> +<?dbhtml filename="XDoclet.html"?> + <title>XDoclet</title> + <para> + The preferences for XDoclet can be changed if you click <emphasis> <property>XDoclet</property> </emphasis> on the left navigation bar. + </para> + + <para> + On the <emphasis> <property>XDoclet</property> </emphasis> screen it&apos;s possible to enable/disable XDoclet builder by checking proper box, specify XDoclet home and determine XDoclet module version as well. + </para> + + <figure> + <title>XDoclet Runtime Preferences Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_41.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Switch to <emphasis> <property>XDoclet > ejbdoclet</property> </emphasis> page in order to adjust settings for EJB-specific sub-tasks. + </para> + + <figure> + <title>ejbdoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_42.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + To configure settings for various web-specific XDoclet sub-tasks, follow to <emphasis> <property>XDoclet > webdoclet</property> </emphasis> page. + </para> + + <figure> + <title>webdoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_43.png"/> + </imageobject> + </mediaobject> + </figure> + </section> +<!--section id="XDocletTemplates"> <?dbhtml filename="XDocletTemplates.html"?> <title>XDoclet Templates</title> <para>To see what XDoclet tags templates available for completion select <emphasis> @@ -1372,4 +1610,4 @@ </figure> </section> --> -</chapter> \ No newline at end of file +</chapter> Modified: trunk/jsf/docs/userguide/en-US/richfaces_support.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/richfaces_support.xml 2011-03-15 22:27:53 UTC (rev 29806) +++ trunk/jsf/docs/userguide/en-US/richfaces_support.xml 2011-03-15 22:28:27 UTC (rev 29807) @@ -1,177 +1,198 @@ -<?xml version="1.0" encoding="UTF-8"?> -<chapter id="richfaces_support" role="new"> - <?dbhtml filename="richfaces_support.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>JBDS</keyword> - <keyword>RichFaces</keyword> - </keywordset> - </chapterinfo> - - <title>RichFaces Support</title> - - <para><property>JBoss Developer Studio</property> comes with a tight integration with <ulink - url="http://labs.jboss.com/jbossrichfaces/">RichFaces component framework</ulink>.</para> - - <note> - <title>Note:</title> - <para><ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces - 3.3.X</ulink> is fully supported in the current version of <property>JBoss Developer Studio</property> (i. e. 2.1.0.GA) and <property>JBoss Tools 3.0.1.GA</property>.</para> - </note> - - <para>The following features are implemented and fully supported for the current version of the RichFaces components:</para> - - <itemizedlist> - <listitem><para><xref linkend="ContentAssistForRF"/></para></listitem> - <listitem><para><xref linkend="RF_openOn"/></para></listitem> - <listitem><para><xref linkend="RF_in_palette"/></para></listitem> - </itemizedlist> - - <para>All you have to do is to <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">downloa... and install RichFaces libraries into your - project, i. e. just put <emphasis> - <property>richfaces-*.jar</property> - </emphasis> files into the <emphasis> - <property>/lib</property> - </emphasis> project folder. Also how to get started with <property>RichFaces</property> you can find in <ulink - url="http://jboss.org/file-access/default/members/jbossrichfaces/fre... - >RichFaces documentation</ulink>.</para> - - <section id="ContentAssistForRF"> - <title>Code Assist for RichFaces</title> - - <para><property>JBDS/JBoss Tools</property> indeed provide code completion for <ulink - url="http://www.jboss.org/jbossrichfaces">RichFaces</ulin... framework - components.</para> - - <note> - <title>Tip:</title> - - <para>RichFaces 3.3.X is now fully supported in code completion.</para> - </note> - - <figure> - <title>Content Assist for RichFaces Components</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/editors_features/editors_features_29.png" - scale="65"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section id="RF_openOn"> - <title>OpenOn for RichFaces</title> - - <para>Working with <emphasis> - <property>.jsp/.xhtml</property></emphasis> pages in <property>VPE</property> you can also take the advantage of <emphasis> - <property>OpenOn</property></emphasis> feature for the <property>RichFaces</property> components.</para> - - <para>For example, <property>Richfaces</property> tags - <code>&lt;rich:insert&gt;</code> - and <code> - &lt;a4j:include&gt;</code> - has <property>OpenOn</property> support.</para> - - <figure> - <title>OpenOn With Richfaces Tag</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/editors_features/editors_features_8a.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>OpenOn With A4j Tag</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/editors_features/editors_features_8b.png"/> - </imageobject> - </mediaobject> - </figure> - <para>OpenOn is also supported in <property>"ForID"</property>-like attributes - (the attributes, where the value should be <property>ID</property> or the list of <property>IDs</property>) in RichFaces.</para> - <figure> - <title>OpenOn With "ForID"-like attributes</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/editors_features/editors_features_8e.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section id="RF_in_palette"> - <title>RichFaces in the JBoss Tools Palette</title> - - <para>RichFaces and <xref linkend="palette"/>.</para> - - <figure> - <title>RichFaces Components</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/palette/palette_13.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>To insert a <property>RichFaces</property> component on a page:</para> - <itemizedlist> - <listitem> - <para>expand <emphasis> - <property>JBoss RichFaces</property> - </emphasis> group on the palette</para> - </listitem> - - <listitem> - <para>click on some component</para> - </listitem> - - <listitem> - <para>put the needed attributes in the <emphasis> - <property>Insert Tag</property> - </emphasis> dialog and click <emphasis> - <property>Finish</property> - </emphasis> button - </para> - </listitem> - </itemizedlist> - - <figure> - <title>Inserting Tag</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/editors_features/editors_features_30.png" - scale="75"/> - </imageobject> - </mediaobject> - </figure> - - <para>The <property>RichFaces</property> component will be inserted on your page and displayed in source and visual - modes:</para> - - <figure> - <title>RichFaces Component</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/editors_features/editors_features_31.png" - scale="75"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section> - <title>Relevant Resources Links</title> - - <para>To get more in-depth information on <property>RichFaces</property> framework refer to <ulink url="http://jboss.org/file-access/default/members/jbossrichfaces/fre... Developer Guide</ulink>.</para> - <para>It may be also helpful for you to look through the <ulink - url="http://docs.jboss.org/tools/movies/" - >movies</ulink> where there are ones that demonstrate the usage of RichFaces components.</para> - </section> -</chapter> \ No newline at end of file +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="richfaces_support" role="new"> +<?dbhtml filename="richfaces_support.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + + <keyword>JBDS</keyword> + + <keyword>RichFaces</keyword> + </keywordset> + </chapterinfo> + <title>RichFaces Support</title> + <para> + <property>JBoss Developer Studio</property> comes with a tight integration with <ulink + url="http://labs.jboss.com/jbossrichfaces/">RichFaces component framework</ulink>. + </para> + + <note> + <title>Note:</title> + <para> + <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.3.X</ulink> is fully supported in the current version of <property>JBoss Developer Studio</property> and <property>JBoss Tools 3.2.0.GA</property>. + </para> + </note> + + <para> + The following features are implemented and fully supported for the current version of the RichFaces components: + </para> + + <itemizedlist> + <listitem> + <para> + <xref linkend="ContentAssistForRF"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="RF_openOn"/> + </para> + </listitem> + + <listitem> + <para> + <xref linkend="RF_in_palette"/> + </para> + </listitem> + </itemizedlist> + + <para> + All you have to do is to <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">downloa... and install RichFaces libraries into your project, i. e. just put <filename>richfaces-*.jar</filename> files into the <filename>/lib</filename> project folder. Also how to get started with <property>RichFaces</property> you can find in <ulink url="http://jboss.org/file-access/default/members/jbossrichfaces/fre... documentation</ulink>. + </para> + + <section id="ContentAssistForRF"> + <title>Code Assist for RichFaces</title> + <para> + <property>JBDS/JBoss Tools</property> indeed provide code completion for <ulink + url="http://www.jboss.org/jbossrichfaces">RichFaces</ulin... framework components. + </para> + + <note> + <title>Tip:</title> + <para> + RichFaces 3.3.X is now fully supported in code completion. + </para> + </note> + + <figure> + <title>Content Assist for RichFaces Components</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_29.png" + scale="65"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="RF_openOn"> + <title>OpenOn for RichFaces</title> + <para> + Working with <filename>JSP</filename> and <filename>XHTML</filename> pages in <property>VPE</property> you can also take the advantage of <emphasis> <property>OpenOn</property></emphasis> feature for the <property>RichFaces</property> components. + </para> + + <para> + For example, <property>Richfaces</property> tags <code>&lt;rich:insert&gt;</code> and <code> &lt;a4j:include&gt;</code> has <property>OpenOn</property> support. + </para> + + <figure> + <title>OpenOn With Richfaces Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8a.png"/> + </imageobject> + </mediaobject> + </figure> + + <figure> + <title>OpenOn With A4j Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8b.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + OpenOn is also supported in <property>"ForID"</property>-like attributes (the attributes, where the value should be <property>ID</property> or the list of <property>IDs</property>) in RichFaces. + </para> + + <figure> + <title>OpenOn With "ForID"-like attributes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8e.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="RF_in_palette"> + <title>RichFaces in the JBoss Tools Palette</title> + <para> + RichFaces and <xref linkend="palette"/>. + </para> + + <figure> + <title>RichFaces Components</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_13.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + To insert a <property>RichFaces</property> component on a page: + </para> + + <itemizedlist> + <listitem> + <para> + expand <emphasis> <property>JBoss RichFaces</property> </emphasis> group on the palette + </para> + </listitem> + + <listitem> + <para> + click on some component + </para> + </listitem> + + <listitem> + <para> + put the needed attributes in the <emphasis> <property>Insert Tag</property> </emphasis> dialog and click <emphasis> <property>Finish</property> </emphasis> button + </para> + </listitem> + </itemizedlist> + + <figure> + <title>Inserting Tag</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/editors_features/editors_features_30.png" + scale="75"/> + </imageobject> + </mediaobject> + </figure> + + <para> + The <property>RichFaces</property> component will be inserted on your page and displayed in source and visual modes: + </para> + + <figure> + <title>RichFaces Component</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_31.png" + scale="75"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section> + <title>Relevant Resources Links</title> + <para> + To get more in-depth information on <property>RichFaces</property> framework refer to <ulink url="http://jboss.org/file-access/default/members/jbossrichfaces/fre... Developer Guide</ulink>. + </para> + + <para> + It may be also helpful for you to look through the <ulink + url="http://docs.jboss.org/tools/movies/" + >movies</ulink> where there are ones that demonstrate the usage of RichFaces components. + </para> + </section> +</chapter> Modified: trunk/jsf/docs/userguide/en-US/web_projects.xml =================================================================== --- trunk/jsf/docs/userguide/en-US/web_projects.xml 2011-03-15 22:27:53 UTC (rev 29806) +++ trunk/jsf/docs/userguide/en-US/web_projects.xml 2011-03-15 22:28:27 UTC (rev 29807) @@ -1,259 +1,400 @@ -<?xml version='1.0' encoding='UTF-8'?> -<chapter id="web_projects"> - <?dbhtml filename="web_projects.html"?> -<title>Web Projects View</title> -<para><property>Web Projects</property> is a special view that comes with JBoss Developer Studio.</para> -<para>If the Web Projects view&apos;s tab is not visible next to the Package Explorer tab, select <emphasis><property>Window &gt; Show View &gt; Other &gt; JBoss Tools Web &gt; Web Projects</property></emphasis> from the menu bar.</para> -<para>With the Web Projects view you can:</para> - -<itemizedlist> -<listitem><para>Visualize the project better because the project artifacts for JSF, Struts and Seam projects are organized and displayed by function.</para></listitem> -<listitem> - <para>Select these kinds of items to drag and drop into JSP pages:</para> - <itemizedlist> - <listitem><para>JSF managed bean attributes</para></listitem> -<listitem><para>JSF navigation rules outcomes</para></listitem> -<listitem><para>Property file values</para></listitem> -<listitem><para>Tag library files</para></listitem> -<listitem><para>Tags from tag libraries</para></listitem> -<listitem><para>JSP page links</para></listitem> -</itemizedlist> -</listitem> -<listitem><para>Use context menus to develop the application (all create and edit functions are available)</para></listitem> -<listitem><para>Use icon shortcuts to create and import JSF and Struts projects</para></listitem> -<listitem><para>Expand and inspect tag library files</para></listitem> -<listitem><para><xref linkend="AddingCustomJSFTagsToTheRedHatPalette7433"/></para></listitem> -</itemizedlist> - -<section id="ProjectOrganization"> - -<title>Project Organization</title> -<para>The Web Projects view organizes your project in a different way. The physical structure of course stays the same. The new organization combines common project artifacts together which makes it simpler to -locate what you are looking for and develop.</para> - -<para>The screen shot below shows a JSF project and a Struts project in Web Projects view.</para> -<figure> - <title>Web Projects View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_1.png" /> - </imageobject> - </mediaobject> - </figure> -</section> -<section id="DragAndDrop"> - -<title>Drag and Drop</title> - <para>Web Projects View has a drag and drop option that can be used for property, managed bean attributes, navigation rules, tag library file declaration and JSP Pages.</para> -<section id="ForAProperty"> - -<title>For a Property</title> - <para>Expand the <property>Resources Bundles</property> folder that holds all the Property files in your project. Select the file from which you want to add the property and then select the property.</para> -<para>We will be dragging and dropping a property file value inside the outputText tag for the <emphasis role="italic"><property>&quot;value&quot;</property></emphasis> attribute.</para> -<figure> -<title>OutputText Tag</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_2.png"/> - </imageobject> -</mediaobject> -</figure> -<para>Select the property:</para> -<figure> -<title>Selecting Property</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_3.png"/> - </imageobject> -</mediaobject> -</figure> - <para>Drag the property and drop it between the quotes for the value attribute in the JSP file. Notice that JBoss Developer Studio added the correctly formatted expression for referring to the property value <code>#{Message.header}</code> automatically.</para> - <figure> -<title>Inserted Property</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_4.png"/> - </imageobject> -</mediaobject> -</figure> -<para>You can actually place the tag anywhere in the page, not just inside an existing tag. In this case - JBoss Developer Studio will place the complete tag <code>&lt;h:outputText value="#{Message.header}"/&gt;</code> in the page.</para> - </section> -<section id="ForManagedBeanAttributes"> - -<title>For Managed Bean Attributes</title> - -<para>Select a <emphasis role="italic"><property>&quot;managed bean&quot;</property></emphasis> attribute and then drag and drop it onto the JSP page. We are going to place it inside the <emphasis role="italic"><property>&quot;value&quot;</property></emphasis> attribute of the inputText tag.</para> -<figure> -<title>Selecting Managed Bean Attribute</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_5.png"/> - </imageobject> -</mediaobject> -</figure> -<para>Once again, JBoss Developer Studio adds the correct expression, <code>#{user.name}</code>.</para> -<figure> -<title>Added Expression</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_6.png"/> - </imageobject> -</mediaobject> -</figure> -</section> -<section id="NavigationRules"> - -<title>Navigation Rules</title> - -<para>Select the navigation rule under <emphasis><property>Configuration > faces-config.xml > Navigation Rules</property></emphasis>:</para> -<figure> -<title>Selecting Navigation Rule</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_7.png"/> - </imageobject> -</mediaobject> -</figure> -<para>Drag and drop it inside the commandButton tag:</para> -<figure> -<title>Navigation Rule in CommandButton Tag</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_8.png"/> - </imageobject> -</mediaobject> -</figure> -<para>You could do the same if the navigation rule was defined inside an action method:</para> -<figure> -<title>Navigation Rule in Action Method</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_9.png"/> - </imageobject> -</mediaobject> -</figure> -<para>Here is how it would look after drag and drop:</para> -<figure> -<title>Inserted Navigation Rule</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_10.png"/> - </imageobject> -</mediaobject> -</figure> -</section> -<section id="ForATagLibraryFileDeclaration"> - -<title>For a Tag Library File Declaration</title> - -<para>Select a TLD file:</para> -<figure> -<title>Selecting TLD File</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_11.png"/> - </imageobject> -</mediaobject> -</figure> -<para>Then drag and drop it onto the JSP page to add a declaration at the top of the page:</para> -<figure> -<title>Inserted TLD File</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_12.png"/> - </imageobject> -</mediaobject> -</figure> -</section> -<section id="ForJSPPages"> - -<title>For JSP Pages</title> - -<para>You can also drag and drop a JSP page path to a JSP page to create a forward as shown:</para> -<figure> -<title>Creating JSP Forward</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_13.png" scale="80"/> - </imageobject> -</mediaobject> -</figure> -</section> -</section> -<section id="DevelopingTheApplication"> - -<title>Developing the Application</title> - -<para>It is also possible to develop your application right from the Web Projects view. -Simply right-click any node in the tree and select an appropriate action from the context menu. For instance, this screen capture shows creating a new navigation rule.</para> -<figure> -<title>Creating New Navigation Rule</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_14.png" scale="90"/> - </imageobject> -</mediaobject> -</figure> -</section> -<section id="ExpandingTagLibraryFiles"> - -<title>Expanding Tag Library Files</title> - -<para>You can easily expand any TLD file in the project. Browse to the Tag Libraries folder. Right-click a TLD file and select <emphasis><property>Expand</property></emphasis>:</para> - - <figure> - <title>Expanding Tag Library File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_15a.png"/> - </imageobject> - </mediaobject> - </figure> - - <para> The TLD file will now be expanded:</para> - - <figure> - <title>Expanded File</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_15b.png"/> - </imageobject> - </mediaobject> - </figure> - - -<para>You can then select any tag and drag it onto a JSP page.</para> - -</section> -<section id="DragAndDropTagLibrariesOnToRedHatPalette"> - -<title>Drag and Drop Tag Libraries on to JBoss Tools Palette</title> - - <para>Read <xref linkend="AddingCustomJSFTagsToTheRedHatPalette7433"/> to learn about this.</para> -</section> -<section id="CreateAndImportJSFAndStrutsProjects"> -<title>Create and Import JSF and Struts Projects</title> - -<para>You can also create and import JSF and Struts project from Web Projects view by selecting the -buttons below.</para> - -<para>From left to right:</para> - -<orderedlist> -<listitem><para>Create New JSF Project</para></listitem> -<listitem><para>Import JSF Project</para></listitem> -<listitem><para>Create New Struts Project</para></listitem> -<listitem><para>Import Struts Project</para></listitem> -</orderedlist> -<figure> -<title>Web Projects View Buttons</title> -<mediaobject> - <imageobject> - <imagedata fileref="images/web_projects/web_projects_16.png"/> - </imageobject> -</mediaobject> -</figure> -</section> - -</chapter> \ No newline at end of file +<?xml version='1.0' encoding='UTF-8'?> +<chapter id="web_projects"> +<?dbhtml filename="web_projects.html"?> + <title>Web Projects View</title> + <para> + <property>Web Projects</property> is a special view that comes with JBoss Developer Studio. + </para> + + <para> + If the Web Projects view&apos;s tab is not visible next to the Package Explorer tab, select <menuchoice><guimenuitem>Window</guimenuitem><guimenuitem>Show View</guimenuitem><guimenuitem>Other</guimenuitem><guimenuitem>JBoss Tools Web</guimenuitem><guimenuitem>Web Projects</guimenuitem></menuchoice> from the menu bar. + </para> + + <para> + With the Web Projects view you can: + </para> + + <itemizedlist> + <listitem> + <para> + Visualize the project better because the project artifacts for JSF, Struts and Seam projects are organized and displayed by function. + </para> + </listitem> + + <listitem> + <para> + Select these kinds of items to drag and drop into JSP pages: + </para> + + <itemizedlist> + <listitem> + <para> + JSF managed bean attributes + </para> + </listitem> + + <listitem> + <para> + JSF navigation rules outcomes + </para> + </listitem> + + <listitem> + <para> + Property file values + </para> + </listitem> + + <listitem> + <para> + Tag library files + </para> + </listitem> + + <listitem> + <para> + Tags from tag libraries + </para> + </listitem> + + <listitem> + <para> + JSP page links + </para> + </listitem> + </itemizedlist> + </listitem> + + <listitem> + <para> + Use context menus to develop the application (all create and edit functions are available) + </para> + </listitem> + + <listitem> + <para> + Use icon shortcuts to create and import JSF and Struts projects + </para> + </listitem> + + <listitem> + <para> + Expand and inspect tag library files + </para> + </listitem> + + <listitem> + <para> + <xref linkend="AddingCustomJSFTagsToTheRedHatPalette7433"/> + </para> + </listitem> + </itemizedlist> + + <section id="ProjectOrganization"> + <title>Project Organization</title> + <para> + The Web Projects view organizes your project in a different way. The physical structure of course stays the same. The new organization combines common project artifacts together which makes it simpler to locate what you are looking for and develop. + </para> + + <para> + The screen shot below shows a JSF project and a Struts project in Web Projects view. + </para> + + <figure> + <title>Web Projects View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_1.png" /> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="DragAndDrop"> + <title>Drag and Drop</title> + <para> + Web Projects View has a drag and drop option that can be used for property, managed bean attributes, navigation rules, tag library file declaration and JSP Pages. + </para> + + <section id="ForAProperty"> + <title>For a Property</title> + <para> + Expand the <property>Resources Bundles</property> folder that holds all the Property files in your project. Select the file from which you want to add the property and then select the property. + </para> + + <para> + We will be dragging and dropping a property file value inside the outputText tag for the <emphasis role="italic"><property>&quot;value&quot;</property></emphasis> attribute. + </para> + + <figure> + <title>OutputText Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Select the property: + </para> + + <figure> + <title>Selecting Property</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_3.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Drag the property and drop it between the quotes for the value attribute in the JSP file. Notice that JBoss Developer Studio added the correctly formatted expression for referring to the property value <code>#{Message.header}</code> automatically. + </para> + + <figure> + <title>Inserted Property</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_4.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + You can actually place the tag anywhere in the page, not just inside an existing tag. In this case JBoss Developer Studio will place the complete tag <code>&lt;h:outputText value="#{Message.header}"/&gt;</code> in the page. + </para> + </section> + + <section id="ForManagedBeanAttributes"> + <title>For Managed Bean Attributes</title> + <para> + Select a <emphasis role="italic"><property>&quot;managed bean&quot;</property></emphasis> attribute and then drag and drop it onto the JSP page. We are going to place it inside the <emphasis role="italic"><property>&quot;value&quot;</property></emphasis> attribute of the inputText tag. + </para> + + <figure> + <title>Selecting Managed Bean Attribute</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_5.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Once again, JBoss Developer Studio adds the correct expression, <code>#{user.name}</code>. + </para> + + <figure> + <title>Added Expression</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_6.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="NavigationRules"> + <title>Navigation Rules</title> + <para> + Select the navigation rule under <menuchoice><guimenuitem>Configuration</guimenuitem><guimenuitem>faces-config.xml</guimenuitem><guimenuitem>Navigation Rules</guimenuitem></menuchoice>: + </para> + + <figure> + <title>Selecting Navigation Rule</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_7.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Drag and drop it inside the commandButton tag: + </para> + + <figure> + <title>Navigation Rule in CommandButton Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_8.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + You could do the same if the navigation rule was defined inside an action method: + </para> + + <figure> + <title>Navigation Rule in Action Method</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_9.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Here is how it would look after drag and drop: + </para> + + <figure> + <title>Inserted Navigation Rule</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_10.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ForATagLibraryFileDeclaration"> + <title>For a Tag Library File Declaration</title> + <para> + Select a TLD file: + </para> + + <figure> + <title>Selecting TLD File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_11.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Then drag and drop it onto the JSP page to add a declaration at the top of the page: + </para> + + <figure> + <title>Inserted TLD File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_12.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ForJSPPages"> + <title>For JSP Pages</title> + <para> + You can also drag and drop a JSP page path to a JSP page to create a forward as shown: + </para> + + <figure> + <title>Creating JSP Forward</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_13.png" scale="80"/> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + + <section id="DevelopingTheApplication"> + <title>Developing the Application</title> + <para> + It is also possible to develop your application right from the Web Projects view. Simply right-click any node in the tree and select an appropriate action from the context menu. For instance, this screen capture shows creating a new navigation rule. + </para> + + <figure> + <title>Creating New Navigation Rule</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_14.png" scale="90"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ExpandingTagLibraryFiles"> + <title>Expanding Tag Library Files</title> + <para> + You can easily expand any TLD file in the project. Browse to the Tag Libraries folder. Right-click a TLD file and select <emphasis><property>Expand</property></emphasis>: + </para> + + <figure> + <title>Expanding Tag Library File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_15a.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + The TLD file will now be expanded: + </para> + + <figure> + <title>Expanded File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_15b.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + You can then select any tag and drag it onto a JSP page. + </para> + </section> + + <section id="DragAndDropTagLibrariesOnToRedHatPalette"> + <title>Drag and Drop Tag Libraries on to JBoss Tools Palette</title> + <para> + Read <xref linkend="AddingCustomJSFTagsToTheRedHatPalette7433"/> to learn about this. + </para> + </section> + + <section id="CreateAndImportJSFAndStrutsProjects"> + <title>Create and Import JSF and Struts Projects</title> + <para> + You can also create and import JSF and Struts project from Web Projects view by selecting the buttons below. + </para> + + <para> + From left to right: + </para> + + <orderedlist> + <listitem> + <para> + Create New JSF Project + </para> + </listitem> + + <listitem> + <para> + Import JSF Project + </para> + </listitem> + + <listitem> + <para> + Create New Struts Project + </para> + </listitem> + + <listitem> + <para> + Import Struts Project + </para> + </listitem> + </orderedlist> + + <figure> + <title>Web Projects View Buttons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_16.png"/> + </imageobject> + </mediaobject> + </figure> + </section> +</chapter>