[jbosstools-commits] JBoss Tools SVN: r13345 - branches/jbosstools-3.0.0.CR2/jsf/docs/userguide/en.

Author: ochikvina Date: 2009-01-29 12:36:23 -0500 (Thu, 29 Jan 2009) New Revision: 13345 Added: branches/jbosstools-3.0.0.CR2/jsf/docs/userguide/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-571- adding the master_output.xml; Added: branches/jbosstools-3.0.0.CR2/jsf/docs/userguide/en/master_output.xml =================================================================== --- branches/jbosstools-3.0.0.CR2/jsf/docs/userguide/en/master_output.xml (rev 0) +++ branches/jbosstools-3.0.0.CR2/jsf/docs/userguide/en/master_output.xml 2009-01-29 17:36:23 UTC (rev 13345) @@ -0,0 +1,4212 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xml/4.3/docbookx.dtd" + +[ +<!ENTITY Visual_Web_Tools SYSTEM "modules/Visual_Web_Tools.xml"> +<!ENTITY springTools SYSTEM "modules/spring_tools.xml"> +<!ENTITY editors SYSTEM "modules/editors.xml"> +<!ENTITY palette SYSTEM "modules/palette.xml"> +<!ENTITY web_projects SYSTEM "modules/web_projects.xml"> +<!ENTITY preferences SYSTEM "modules/preferences.xml"> + +<!ENTITY seamlink "../../seam/html_single/index.html"> +<!ENTITY aslink "../../as/html_single/index.html"> +<!ENTITY esblink "../../esb_ref_guide/html_single/index.html"> +<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html"> +<!ENTITY hibernatelink "../../hibernatetools/html_single/index.html"> +<!ENTITY jbpmlink "../../jbpm/html_single/index.html"> +<!ENTITY jsflink "../../jsf/html_single/index.html"> +<!ENTITY jsfreflink "../../jsf_tools_ref_guide/html_single/index.html"> +<!ENTITY jsftutoriallink "../../jsf_tools_tutorial/html_single/index.html"> +<!ENTITY strutsreflink "../../struts_tools_ref_guide/html_single/index.html"> +<!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html"> +<!ENTITY migrationlink "../../Exadel-migration/html_single/index.html"> + +]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> + <bookinfo> + <title>Visual Web Tools Reference Guide</title> + + <pubdate>April 2008</pubdate> + <copyright> + <year>2007</year> + <year>2008</year> + <holder>JBoss, a division of Red Hat Inc.</holder> + </copyright> + <releaseinfo><diffmk:wrapper diffmk:change="changed"> + Version: 2.0.0.CR2 + </diffmk:wrapper></releaseinfo> +<abstract> + <title></title> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jsf/pdf/Vi... version</ulink> + </para> +</abstract> + + + </bookinfo> +<toc></toc> + + +<chapter id="Visual_Web_Tools" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/Visual_Web_Tools.xml" xreflabel="Visual_Web_Tools"> + <?dbhtml filename="Visual_Web_Tools.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>JBDS</keyword> + <keyword>Java</keyword> + <keyword>Web Tools</keyword> + </keywordset> + </chapterinfo> + + <title>Visual Web Tools</title> + + <para>This guide covers the usage of Visual Web Tools in <property moreinfo="none">JBoss Developer + Studio</property> and <property moreinfo="none">JBoss Tools</property>. The difference between these products is + that JBoss Tools are just a set of Eclipse plugins where JBoss Developer Studio adds the following functionality:</para> + <itemizedlist> + <listitem> + <para>an installer</para> + </listitem> + <listitem> + <para>Eclipse and Web Tools preconfigured</para> + </listitem> + <listitem> + <para>JBoss EAP with JBoss AS and Seam preconfigured</para> + </listitem> + <listitem> + <para>3rd party plugins bundled and configured</para> + </listitem> + <listitem> + <para>access to RHEL and Red Hat Network</para> + </listitem> + <listitem> + <para>access to the JBoss/Red Hat supported software</para> + </listitem> + </itemizedlist> + + <para>For additional information, please visit the JBoss Developer Studio home page at: <ulink url="http://www.jboss.com/products/devstudio">http://www.jbo... + + <para>In JBoss Tools there is an extensive collection of specialized wizards, editors and views + that can be used in various scenarios while developing Web applications. The following chapters + walk through these features.</para> + + <section id="key_features"> + <title>Key Features of Visual Web Tools</title> + <para>Here is the table of the main features of Visual Web Tools:</para> + + <table> + + <title>Key Functionality for Visual Web Tools</title> + <tgroup cols="3"> + + <colspec align="left" colnum="1" colwidth="2*"></colspec> + <colspec colnum="2" colwidth="4*"></colspec> + <colspec align="left" colnum="3" colwidth="2*"></colspec> + + <thead> + <row> + <entry>Feature</entry> + <entry>Benefit</entry> + <entry>Chapter</entry> + </row> + </thead> + <tbody> + <row> + <entry>Visual Page Editor</entry> + <entry>Powerful and customizable visual page editor. Possibility to develop an application + using any web technology: jsf, seam, struts, jsp, html and others. Developing using four + tabs: visual/source, visual, source and preview. Fast and easy switching between these tabs. + Split screen design of visual and source views. Full and instant synchronization between + source and visual views. Integration with properties and outline views. Graphical toolbar to + add inline styling to any tag.</entry> + <entry> + <link linkend="visual_page">visual page editor</link> + </entry> + </row> + + <row> + <entry>JBoss Tools Palette</entry> + <entry>Organizing various tags by groups, inserting tags into a jsp or xhtml page with one + click, adding custom or 3rd party tag libraries into the palette, easy controling the number + of tag groups shown on the palette.</entry> + <entry> + <link linkend="palette">jboss tools palette</link> + </entry> + </row> + + <row> + <entry>Web Projects View</entry> + <entry>Visualizing and displaying projects by function. Easy selecting of different kinds of + items and dropping them into jsp pages. Using context menus to develop the application. Using + icon shortcuts to create and import JSF and Struts projects. Expanding and inspecting tag + library files. Selecting custom and third-party tag libraries to drag and drop onto the JBoss + Tools Palette.</entry> + <entry> + <link linkend="web_projects">web projects view</link> + </entry> + </row> + + <row> + <entry>OpenOn</entry> + <entry>Easy navigation between views and other parts of your projects.</entry> + <entry> + <link linkend="OpenOnSelection4Hyperlinknavigation">openOn</link> + </entry> + </row> + + <row> + <entry>Content Assist</entry> + <entry>Code completion proposals while working with html, java, JavaScript , xml, jsp, xhtml, xhtml, seam project + and jsf configuration files. Content assist based on project data (dynamic code assist); with + graphical editor. Code completion for values from property files, beans attributes and + methods, navigation rule outcomes and jsf variables.</entry> + <entry> + <link linkend="CodeAssistAndDynamicCodeAssist42BasedOnProjectData">content assist</link> + </entry> + </row> + + <row> + <entry>Drag-and-Drop</entry> + <entry>Possibility of inserting any tag onto the page you are editing by just drag-and-droping + it from the palette to this page. Adding any properties, managed bean attributes, navigation + rules, tag library file declarations, jsp files from web projects view by clicking them and + draging to source code.</entry> + <entry> + <link linkend="visual_page">visual page editor</link> + <link linkend="DragAndDrop">drag-and-drop</link> + </entry> + </row> + + <row> + <entry>RichFaces Support</entry> + <entry>Tight integration between JBDS and <ulink url="http://www.jboss.org/jbossrichfaces">RichFaces</ulin... frameworks. Easy managing RichFaces + components in any web application. Support for RichFaces and Ajax4jsf libraries in JBoss + Tools Palette. Rendering RichFaces components in Visual Page Editor.</entry> + <entry> + <link linkend="RichFacesSupport">RichFaces support</link> + </entry> + </row> + </tbody> + </tgroup> + </table> + </section> + +<section> + <title>Other relevant resources on the topic</title> + <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://www.jboss.com/products/devstudio/docs">here</... + <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">her... +</section> + +</chapter> + + +<chapter id="springTools" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/spring_tools.xml"> + <?dbhtml filename="springTools.html"?> + <title>Spring Tools</title> + + <para>JBoss Developer Studio is bundled with <ulink url="http://springide.org/project">Spring IDE</ulink> for Eclipse. + Visit Spring IDE site for the latest versions and documentation.</para> + + + <section> + <title><ulink url="http://springide.org/project/wiki/SpringideGuide">Spring IDE guide</ulink></title> + + <para><ulink url="http://springide.org/project">Spring IDE</ulink> is a graphical user interface for the configuration files used by the <ulink url="http://www.springframework.org/">Spring Framework</ulink>. It's built as a set of plugins for the Eclipse platform.</para> + + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#AddProjectNatu... Spring Project Nature</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#CreateNewProje... New Spring Project</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#AddProjectRefe... References To Other Spring Projects</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#AddBeansConfig... Spring Beans Config Files</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#CreateBeansCon... Spring Beans Config Sets</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#OpenSpringExpl... Spring Explorer</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#ValidateBeansC... Spring Beans Config</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#OpenBeansGraph... Spring Beans Graph</ulink></title><para></para></section> + <section><title><ulink url="http://springide.org/project/wiki/SpringideGuide#SearchBeans&qu... Spring Beans</ulink></title><para></para></section> + + </section> + + </chapter> + + +<chapter id="jbds_editors" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/editors.xml" xreflabel="jbds_editors"> + <?dbhtml filename="editors.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>JBDS</keyword> + <keyword>Editor</keyword> + </keywordset> + </chapterinfo> + + <title>Editors</title> + + <para>In the <ulink url="../../jsf_tools_ref_guide/html_single/index.html">JSF Tools Reference Guide</ulink> and <ulink url="../../struts_tools_ref_guide/html_single/index.html">Struts Tools Reference Guide</ulink> you had possibility to + read about Graphical Editor for <ulink url="../../jsf_tools_ref_guide/html_single/index.html#jsf_config_file">JSF</ulink> + and <ulink url="../../struts_tools_ref_guide/html_single/index.html#struts_config_editor">Struts</ulink> configuration + files, <ulink url="../../struts_tools_ref_guide/html_single/index.html#GraphicalEditorForTilesFiles132">Graphical Editor for + Tiles Files</ulink>, <ulink url="../../struts_tools_ref_guide/html_single/index.html#GraphicalEditorForStrutsValidationFiles86">Graphical Editor for + Struts Validation Files</ulink>. All these editors have <link linkend="OpenOnSelection4Hyperlinknavigation"> + <property moreinfo="none">OpenOn</property> + </link> and <link linkend="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"> + <property moreinfo="none">Content Assist</property> + </link> features, which are described in more details in this document. In addition you get + to know a <link linkend="visual_page">Visual Page Editor</link> for combined visual and + source editing of Web pages and many <link linkend="more_editors">other editors</link> for + different types of files.</para> + + <section id="editors_features"> + + <title>Editors Features</title> + <para>JBoss Developer Studio has powerful editor features that help you easily navigate + within your application and make use of content and code assist no matter what project + file (jsp, xhtml, xml, css, etc...) you are working on.</para> + + <section id="OpenOnSelection4Hyperlinknavigation"> + + <title>OpenOn</title> + + <para><property moreinfo="none">OpenOn</property> lets you easily link directly from one resource to + another in your project without using the Package Explorer view (project tree). With + OpenOn, you can simply use <emphasis> + <property moreinfo="none">F3</property> + </emphasis> or <emphasis> + <property moreinfo="none">Ctrl+Click</property> + </emphasis> on a reference to another file and the file will be opened.</para> + + <para>OpenOn is available for the following files:</para> + <itemizedlist> + <listitem> + <para> + <link linkend="XMLFiles232">XML files</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="JSPPages223">JSP/XHTML Pages</link> + </para> + </listitem> + <listitem> + <para>Java files</para> + </listitem> + </itemizedlist> + <section id="XMLFiles232"> + + <title>XML Files</title> + + <para>Press and hold down the Ctrl key. As you move the mouse cursor over different + file references in the file, they display an underline. When you hover the name + of the file you want to open, click and the file will open in its own editor. In + this example the managed bean NameBean will open.</para> + <figure float="0"> + <title>NameBean Managed Bean</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>This is the result of using OpenOn.</para> + <figure float="0"> + <title>NameBean Java Class</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>You can also use OpenOn with defined attributes.</para> + <figure float="0"> + <title>OpenOn With Defined Attributes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>You can also open any JSP pages.</para> + <figure float="0"> + <title>JSP Page OpenOn</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="JSPPages223"> + + <title>JSP Pages</title> + + <para><property moreinfo="none">OpenOn</property> is also very useful in JSP pages. It will allow + you to quickly jump to the reference instead of having to hunt around in the + project structure.</para> + + <para>You can easily open the imported property files.</para> + <figure float="0"> + <title>OpenOn With Imported Property Files</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Use OpenOn to open a CSS file used with a JSP page:</para> + <figure float="0"> + <title>OpenOn With CSS File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Open managed beans:</para> + <figure float="0"> + <title>OpenOn With Managed Beans</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>For JSP files in a JSF project, you can also easily open the navigation rules + by applying <property moreinfo="none">OpenOn</property> to the JSF tag for the navigation + outcome:</para> + <figure float="0"> + <title>OpenOn With JSF Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Richfaces tags <emphasis> + <property moreinfo="none">&lt;rich:insert&gt;</property> + </emphasis> and <emphasis> + <property moreinfo="none">&lt;a4j:include&gt;</property> + </emphasis> has also <property moreinfo="none">OpenOn</property> support.</para> + + <figure float="0"> + <title>OpenOn With Richfaces Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <figure float="0"> + <title>OpenOn With A4j Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + </section> + + <section id="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"> + + <title>Content Assist</title> + <para><property moreinfo="none">Content assist</property> is available when working with</para> + + <itemizedlist> + <listitem> + <para> + <ulink url="../../seam/html_single/index.html#ContentAssist">Seam project files</ulink> + </para> + + </listitem> + <listitem> + <para> + <link linkend="JSFProjectFiles3087">JSF project files</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="StrutsProjectFile46s3">Struts project files</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="JSPPages434">JSP files</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="ContentAssistForRF">RichFaces components</link> + </para> + </listitem> + <listitem> + <para> + <ulink url="../../esb_ref_guide/html_single/index.html#ESBContentAssist">ESB XML files</ulink> + </para> + </listitem> + </itemizedlist> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Notice, that code completion for EL variables has icons illustrating what they are from. + Currently it's performed for resource bundles, JSF and Seam components.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">JSF Content Assist</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/editors_features/editors_features_8d.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam Content Assist</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/editors_features/editors_features_8c.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Also, as you can see, the ranking and sorting are available in EL code completions.</diffmk:wrapper></para> + + <section id="JSFProjectFiles3087"> + + <title>JSF Project Files</title> + + <para>When working with JSF project in JBoss Developer Studio, you can use various + <property moreinfo="none">Content Assist features</property> while developing:</para> + <itemizedlist> + <listitem> + <para>Content Assist for XML, JSP and JSF configuration files</para> + </listitem> + <listitem> + <para>Content Assist based on project data</para> + </listitem> + <listitem> + <para>Content Assist with graphical JSF editor</para> + </listitem> + </itemizedlist> + <section id="ContentAssistForXMLJSPAndJSFConfigurationFiles865"> + + <title>Content Assist for XML, JSP and JSF configuration files</title> + + <para>At any point when working with any XML, JSP and JSF configuration files + Content Assist is available to help you. Simply type <emphasis> + <property moreinfo="none">Ctrl-Space</property> + </emphasis> to see what is available.</para> + + <para>Content Assist for JSF configuration file:</para> + <figure float="0"> + <title>Content Assist in JSF Configuration File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_9.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Content Assist for JSF JSP file:</para> + <figure float="0"> + <title>Content Assist in JSP File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_10.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Content Assist for other JSF XML project files (web.xml shown):</para> + <figure float="0"> + <title>Content Assist in web.xml File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_11.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ContentAssistBasedOnProjectData86"> + + <title>Content Assist Based on Project Data</title> + + <para>JBoss Developer Studio takes Content Assist to the next level. Studio will + constantly scan your project and you will be able to insert code into the + JSP page from your project that includes:</para> + <itemizedlist> + <listitem> + <para>Values from Property files</para> + </listitem> + <listitem> + <para><emphasis role="italic"> + <property moreinfo="none">"Managed beans"</property> + </emphasis> attributes and methods</para> + </listitem> + <listitem> + <para>Navigation Rule Outcomes</para> + </listitem> + <listitem> + <para>JSF variables (context, request etc...)</para> + </listitem> + </itemizedlist> + <para>The figure below shows how to insert message from a Properties files. You + simply put the cursor inside the <emphasis role="italic"> + <property moreinfo="none">"value"</property> + </emphasis> attribute and press <emphasis> + <property moreinfo="none">Ctrl-Space</property>. </emphasis> JBoss Developer Studio will + scan your project and show a list of possible values to insert.</para> + <figure float="0"> + <title>Inserting Message</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>In the following screenshot we are inserting a <emphasis role="italic"> + <property moreinfo="none">"Managed bean"</property> + </emphasis> attribute value. Again, by simply clicking + <emphasis><property moreinfo="none">Ctrl-Space</property>,</emphasis> JBoss + Developer Studio will show a list of all possible values that you can + insert.</para> + + <para>Once you select a Managed bean, it will show you a list of all available + attributes for the selected Managed bean (userBean).</para> + <figure float="0"> + <title>Attributes List</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Code Assist based on project data will also prompt you for navigation + rules that exist in your JSF configuration file.</para> + <figure float="0"> + <title>Code Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ContentAssistWithinJSFGraphicalEditor44"> + + <title>Content Assist within Tree JSF Editor</title> + + <para>JBoss Developer Studio also provides Content Assist when working within + the Tree JSF configuration editor. Just click <emphasis> + <property moreinfo="none">Ctrl-Space</property>. </emphasis></para> + <figure float="0"> + <title>Content Assist in Tree JSF Configuration Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_15.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <!-- + + <para>If a field contains right class name and you click a link near the + field you will come to the file with this class otherwise a new Java + Class dialog will be shown:</para> + <figure> + <title>New Java Class</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/editors_features/editors_features_16.png"/> + </imageobject> + </mediaobject> + </figure> + <para>If you entered an incorrect name in the field error markers will be + shown for field labels and tree items:</para> + <figure> + <title>Error Markers</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/editors_features/editors_features_17.png"/> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>To add a new property to a managed bean expand <emphasis> + <property>Managed Beans</property> + </emphasis> and select <emphasis role="bold"> + <property>&lt;name_of_bean&gt;</property> + </emphasis></para> + </listitem> + <listitem> + <para>Click <emphasis> + <property>Add</property> + </emphasis> button in the Properties panel</para> + </listitem> + <listitem> + <para>In the dialog Add Property define a new property. From here + also you can generate setters and getters methods:</para> + </listitem> + </itemizedlist> + <figure> + <title>Create New Property</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/editors_features/editors_features_18.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Here you can also add an additional navigation rule to the + faces-config.xml file.</para> + <itemizedlist> + <listitem> + <para>Select <emphasis> + <property>Navigation Rules</property> + </emphasis></para> + </listitem> + <listitem> + <para>Click <emphasis> + <property>Add</property> + </emphasis> button</para> + </listitem> + <listitem> + <para>In the dialog <emphasis> + <property>Add Rule</property> + </emphasis> define a view and give a name to the rule. Click + Finish:</para> + </listitem> + </itemizedlist> + <figure> + <title>Add New Navigation Rule</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/editors_features/editors_features_19.png"/> + </imageobject> + </mediaobject> + </figure> + + --> + </section> + </section> + + <section id="StrutsProjectFile46s3"> + <title>Struts Project Files</title> + <para>Content Assist features are available when you work with Struts + projects.</para> + + + <section id="ContentAssistForStrutsConfigurationFile75"> + + + <title>Content Assist for Struts Configuration File</title> + + <para>Content Assist helps you in Struts Configuration file.</para> + + <figure float="0"> + <title>Struts Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_20.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ContentAssistForStrutsJSPFile07"> + + <title>Content Assist for Struts JSP File</title> + + <para>Using Code Assist in Struts JSP file is shown below.</para> + + <figure float="0"> + <title>Struts JSP Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_21.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + <section id="JSPPages434"> + + <title>JSP Pages</title> + + + <section id="ContentAssistForJSFTags96"> + + <title>Content Assist for JSF Tags</title> + <para>JBDS provides full code completion for JSF tags:</para> + + <figure float="0"> + <title>JSF Tags Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_22.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>When the tag is selected the required attributes, if there any, are + already inserted and the cursor is located to the first attribute. At this + point you can ask for attribute proposals.</para> + <figure float="0"> + <title>Attributes Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_23.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + <section id="ContentAssistForJSTLTags6332"> + + <title>Content Assist for JSTL Tags</title> + <figure float="0"> + <title>JSTL Tags Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_24.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ContentAssistForHTMLTags7454"> + + <title>Content Assist for HTML Tags</title> + <para>Content assist for HTML tags has the same mechanism as for JSF + tags:</para> + <figure float="0"> + <title>HTML Tags Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_25.png" scale="60"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>You can use as well attributes proposals for HTML tags:</para> + <figure float="0"> + <title>HTML Tags Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_26.png" scale="60"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ContentAssistForJavaScriptTags67433"> + + <title>Content Assist for JavaScript Tags</title> + <figure float="0"> + <title>JavaScript Tags Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_27.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + + </section> + <section id="ContentAssistForRF"> + + <title>RichFaces components</title> + <para>JBDS indeed provides code completion for <ulink url="http://www.jboss.org/jbossrichfaces">RichFaces</ulin... diffmk:change="added"> framework + components.</diffmk:wrapper></para> + + <tip diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">RichFaces 3.2 is now fully supported in code completion.</diffmk:wrapper></para> + </tip> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">All you have to do is to install RichFaces libraries into your + project. See </diffmk:wrapper><ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface... how to install it.</para> + <figure float="0"> + <title>Content Assist for RichFaces Components</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_29.png" scale="65"></imagedata> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>To insert a RichFaces component on a page expand <emphasis> + <property moreinfo="none">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 moreinfo="none">Insert Tag</property> + </emphasis> dialog and click <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> button <figure float="0"> + <title>Insert Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_30.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + </para> + </listitem> + </itemizedlist> + <para>The RichFaces tag will be inserted on your page displayed in source and visual + modes: </para> + <figure float="0"> + <title>RichFaces Component</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_31.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + + <section id="AddingDynamicCodeAssistToCustomComponents8745"> + + <title>Adding dynamic code assist to custom components that were added to JBoss + Tools Palette</title> + <para>Here is what you need to do to add project based code assist to a custom + component added in <property moreinfo="none">JBoss Developer Studio</property>:</para> + <orderedlist continuation="restarts" inheritnum="ignore"> + <listitem> + <para>Create a new xml file in <emphasis> + <property moreinfo="none">&lt;JBDS_home&gt;studio/eclipse/plugins/org.jboss.tools.common.kb_***/schemas/tld/</property>. + </emphasis>For example call it <emphasis> + <property moreinfo="none"> JeniaFaces.xml</property> + </emphasis>. The file should be written according to <emphasis> + <property moreinfo="none">&lt;JBDS_home&gt;/studio/eclipse/plugins/org.jboss.tools.common.kb/kb.jar/org/jboss/tools/common/kb/kb-schema_1.0.dtd</property> + </emphasis></para> + </listitem> + </orderedlist> + <para>Follow these steps to set what is available for code assist:</para> + <itemizedlist> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">Adds code assist for JSF pre-defined objects, such as + </diffmk:wrapper><![CDATA[value=]]><emphasis role="italic"> + <property moreinfo="none">"#{param}"</property> + </emphasis>:</para> + </listitem> + </itemizedlist> + <programlisting format="linespecific" role="XML"><![CDATA[<AttributeType ...> + <proposal type="jsfVariables"/> +</AttributeType> +]]></programlisting> + <itemizedlist> + <listitem> + <para>Add bundle resource (property file) <property moreinfo="none">code + assist</property>:</para> + </listitem> + </itemizedlist> + <programlisting format="linespecific" role="XML"><![CDATA[<AttributeType ...> + <proposal type="bundleProperty"/> +</AttributeType> +]]></programlisting> + <itemizedlist> + <listitem> + <para>Add managed bean property <property moreinfo="none">code assist</property>:</para> + </listitem> + </itemizedlist> + <programlisting format="linespecific" role="XML"><![CDATA[<AttributeType ...> + <proposal type="beanProperty"/> +</AttributeType> +]]></programlisting> + <itemizedlist> + <listitem> + <para>Add managed bean property but of a specified type:</para> + </listitem> + </itemizedlist> + <programlisting format="linespecific" role="XML"><![CDATA[<AttributeType ...> + <proposal type="beanProperty"> + <param name="type" value="java.lang.Boolean"/> + </proposal> +</AttributeType> +]]></programlisting> + <itemizedlist> + <listitem> + <para>Add managed bean method with a signature:</para> + </listitem> + </itemizedlist> + <programlisting format="linespecific" role="XML"><![CDATA[<AttributeType ...> + <proposal type="beanMethodBySignature"> + <param name="paramType" value="javax.faces.context.FacesContext"/> + <param name="paramType" value="javax.faces.component.UIComponent"/> + <param name="paramType" value="java.lang.Object"/> + <param name="returnType" value="void"/> + </proposal> +</AttributeType> +]]></programlisting> + <orderedlist continuation="restarts" inheritnum="ignore"> + <listitem> + <para>Add information on your xml file in <emphasis> + <property moreinfo="none">&lt;JBDS_home&gt;/studio/eclipse/plugins/org.jboss.common.kb_***/plugin.xml</property> + </emphasis></para> + <programlisting format="linespecific" role="XML"><![CDATA[ + <tld + jsf="true" + name="Jenia Faces" + schema-location="schemas/tld/myJSF.xml" + uri="http://www.jenia.org/jsf/dataTools"/>]]> + </programlisting> + </listitem> + + <listitem> + <para>Restart Eclipse. You should now have code assist for the + component.</para> + </listitem> + </orderedlist> + + </section> + </section> + <section id="FullControlOverSourceFiles-SynchronizedSourcAndVisualEditing74"> + + <title>Synchronized Source and Visual Editing</title> + + <para><property moreinfo="none">JBoss Developer Studio</property> offers the flexibility to edit any + files in either source or extra visual modes at the same time.</para> + + <para>The project is yours and so is the source. <property moreinfo="none">JBoss Developer + Studio</property> provides you many different graphical editors to speed your + application development. At the same time, you always have a full control over all + project source files. Any changes you make in the source view immediately appear in + the graphical view.</para> + + <para>The JSF configuration file editor has three views: <property moreinfo="none">Diagram</property>, + <property moreinfo="none">Tree</property> and <property moreinfo="none">Source</property>. All views are + synchronized, you can edit the file in any view.</para> + <figure float="0"> + <title>Three Views are Synchronized</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_32.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The same is relevant to all other <property moreinfo="none">JBoss Developer Studio</property> + editors.</para> + + <para>Web XML editor is shown. Web XML editor has a graphical view (Tree) and source + (Source).</para> + + <figure float="0"> + <title>Two Views are Synchronized</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_35.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><property moreinfo="none">JBoss Developer Studio</property> TLD file editor is shown in Tree view. + At any point you can edit the source by switching to Source view.</para> + <figure float="0"> + <title>Two Views are Synchronized</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_37.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + </section> + <section id="visual_page" role="updated"> + + <title>Visual Page Editor</title> + + <para><property moreinfo="none">JBoss Developer Studio</property> comes with a powerful and customizable + <property moreinfo="none">Visual Page Editor</property> (VPE). You can use the Visual Page Editor to + develop an application using any technology: JSF, Struts, JSP, HTML and others.</para> + + <para>Current VPE version has three tabs: <property moreinfo="none">Visual/Source</property>, + <property moreinfo="none">Source</property> and <property moreinfo="none">Preview</property>. To switch between the + views you can use tabs at the bottom of the VPE or the shortcuts <emphasis> + <property moreinfo="none">Ctrl + PageUp/Ctrl + PageDown</property>.</emphasis></para> + + <figure float="0"> + <title>Visual Page Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_1.png" scale="95"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <section id="visual_source"> + <title>Visual/Source View</title> + + <para>Using the <property moreinfo="none">Visual/Source view</property> you can edit your pages in the + Source and Visual modes simultaneously having an instant synchronization between + them:</para> + <figure float="0"> + <title>Visual/Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_2.png" scale="95"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The view is designed in the form of a split pane with toggle buttons for quickly + moving between Source, Visual or Source/Visual modes as shown on the figure + above.</para> + + <para>One more way to toggle between the various states of the split pane is using the + shortcuts <emphasis> + <property moreinfo="none">Shift + F6</property> + </emphasis> for maximizing/restoring the Source part and <emphasis> + <property moreinfo="none">Shift + Alt + F6</property> + </emphasis> for maximizing/restoring the Visual part.</para> + <tip> + <title>Tip:</title> + <para>When editing large documents hiding the Visual part will speed up the + editing.</para> + </tip> + + <para>It should be pointed out that, no matter in what mode you are working, you get a + full integration with <property moreinfo="none">Properties</property> and <property moreinfo="none">Outline + views</property>:</para> + <figure float="0"> + <title>Integration with Properties and Outline Views</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_3.png" scale="55"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>It's also possible to use the <link linkend="palette">JBoss Tools + Palette</link> to insert any tag from the list of tag libraries to the page you + are editing with just a click or drag-and-drop.</para> + <figure float="0"> + <title>Inserting Tag From the Palette</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><property moreinfo="none">Visual Page Editor</property> provides the option for displaying + non-visual tags in Visual mode of the editor. To enable this option expand the + submenu in the top left corner of the Visual part and select <emphasis> + <property moreinfo="none">Show Non-visual tags</property>.</emphasis></para> + + <figure float="0"> + <title>Enabling the Option for Showing Non-visual Tags</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_4a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On the figure you can see non-visual elements with gray dashed borders.</para> + + <figure float="0"> + <title>Non-visual Tag in the VPE</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_4b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To disable this option again expand the same submenu and select <emphasis> + <property moreinfo="none">Hide Non-visual tags</property>.</emphasis></para> + + <figure float="0"> + <title>Non-visual Tag in the VPE</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_4c.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <section id="comments"> + <title>Commenting out Code</title> + + <para><property moreinfo="none">VPE</property> supports possibility to add comments in files you are + working with (JSP, XHTML, etc.):</para> + + <itemizedlist> + <listitem> + <para>HTML comments (<emphasis> + <property moreinfo="none">&lt;!-- --&gt;</property> + </emphasis>) which are output to the client </para> + </listitem> + <listitem> + <para>JSP comments (<emphasis> + <property moreinfo="none">&lt;%-- --%&gt;</property> + </emphasis>) which are not output to the client as part of the JSP page + output</para> + </listitem> + </itemizedlist> + </section> + + <section id="JSPsyntaxvalidation84"> + + <title>JSP Syntax Validation</title> + <para>When working in JBoss Tools JSP editor you are constantly provided with + feedback and contextual error checking as you type.</para> + </section> + + <section id="taglib_versions_support"> + <title>Support for Taglib versions</title> + + <para><diffmk:wrapper diffmk:change="changed">VPE templates now support various versions of tag libraries. It means that the + </diffmk:wrapper><property moreinfo="none">VPE</property><diffmk:wrapper diffmk:change="changed"> takes control under those components which have + different parameters or preview according to the framework version (like seam + 1.2 and seam 2.0, or JSF 1.1 and JSF 1.2).</diffmk:wrapper></para> + + <para>For example, <emphasis> + <property moreinfo="none">&lt;s:decorate&gt;</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> element in seam has different parameters in versions 1.2 and 2.0 as + well as </diffmk:wrapper><emphasis> + <property moreinfo="none">&lt;h:outputLink&gt;</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> JSF element has different preview in versions 1.1 and 1.2.</diffmk:wrapper></para> + </section> + </section> + + <section id="pages_styling"> + <title>Pages Styling</title> + + <para>Most web pages use the cascading style sheets (CSS) to control the way they look. + With <property moreinfo="none">Visual Page Editor</property> you can easily stylise your pages. In + this section we are going to introduce you to a powerful mechanism that + <property moreinfo="none">VPE</property> provides for a complete control over pages styling. </para> + + <section id="inline_styling"> + <title>Inline Style Editing</title> + + <para>In the Visual part of the <property moreinfo="none">VPE</property> there is a graphical + toolbar, use it to add inline styling to JSF and Struts tags on your page. The + toolbar can be hidden by clicking on arrow sign in the upper left corner.</para> + + <figure float="0"> + <title>Text Formatting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>For editing inline styles for DOM elements <property moreinfo="none">VPE</property> also + provides <property moreinfo="none">CSS Dialog</property>. It can be called from <emphasis> + <property moreinfo="none">style</property> + </emphasis> line in the <property moreinfo="none">Properties view</property> for a currently + selected element.</para> + + <figure float="0"> + <title>Call the CSS Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="css_dialog"><property moreinfo="none">CSS Dialog</property> has four tabs where css + properties for text, background, borders and others can be specified. A simple + preview which is generated at the top of the <property moreinfo="none">CSS Dialog</property> + allows you to see the changes before you apply them.</para> + + <figure float="0"> + <title>CSS Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="external_stylesheets"> + <title>External Stylesheets</title> + <para>The pages you are working with in <property moreinfo="none">VPE</property> can use external + stylesheets. <property moreinfo="none">VPE</property> allows you to create new style classes in + existing stylesheets and/or edit them as well. For these purposes <property moreinfo="none">CSS + Style Class Dialog</property> is provided (hot keys - CTRL+SHIT+C).</para> + <para>Select the element for which you need to create or edit style class and press + button next to <emphasis> + <property moreinfo="none">styleClass</property> + </emphasis> field in <property moreinfo="none">Properties view</property>.</para> + + <figure float="0"> + <title>Calling the CSS Style Class Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>It'll pick up the <property moreinfo="none">CSS Style Class Dialog</property> which + looks like on the figure below.</para> + <figure float="0"> + <title>CSS Style Class Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_18.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>First, you should specify the CSS file where you are going to put your style + class. Do this by pressing button next to the <emphasis> + <property moreinfo="none">CSS file</property> + </emphasis> field.</para> + <figure float="0"> + <title>CSS File Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_19.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To create new CSS class write its name in the <emphasis> + <property moreinfo="none">Style class</property> + </emphasis> field and then configure style settings switching between the tabs: <emphasis> + <property moreinfo="none">Text/Font</property>, </emphasis> + <emphasis> + <property moreinfo="none">Background</property>, </emphasis> + <emphasis> + <property moreinfo="none">Boxes</property>, </emphasis> + <emphasis> + <property moreinfo="none">Property Sheet</property>. </emphasis>To add existing styling to + the chosen element expand the list of the existed style classes and point to the + necessary one.</para> + + <figure float="0"> + <title>Style Class Selection</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_20.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><emphasis> + <property moreinfo="none">Quick Edit</property> + </emphasis> gives a preview of the properties which are set for the existing + style class. You can easily modify them with the help of this wizard.</para> + + <figure float="0"> + <title>Quick Edit</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_21.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Preview at the top of the <property moreinfo="none">CSS Style Class Dialog</property> + visualizes the result.</para> + + <para>The dialog for creating a new CSS class, which is called from <emphasis> + <property moreinfo="none">New &gt; Other... &gt; JBoss Tools Web &gt; CSS Class</property>, + </emphasis> looks the same.</para> + + <figure float="0"> + <title>New CSS Class Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_22.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + + <section id="vpe_templating"> + <title>Templating</title> + + <para>The VPE also makes it possible to create templates for unknown tags.</para> + + <para>To call the <property moreinfo="none">Template dialog</property> for a tag, right-click on it in + Visual mode and select <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Setup Template for &lt;tag name&gt;</diffmk:wrapper></property> + </emphasis> option.</para> + + <figure float="0"> + <title>Calling Template Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para id="template_dialog">Here is what the <property moreinfo="none">Template dialog</property> looks + like.</para> + + <figure float="0"> + <title>Template Dialog</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><emphasis> + <property moreinfo="none">Tag for Display</property> + </emphasis> field in the <property moreinfo="none">Template dialog</property> requires specifying a + type of tag. It can be SPAN, DIV, TABLE or any other html element. Check <emphasis> + <property moreinfo="none">Children</property> + </emphasis>, if you want to mark a tag as a child element.</para> + + <para>The <emphasis> + <property moreinfo="none">Value</property> + </emphasis> field is for setting a tag value.</para> + <para>As for the <emphasis> + <property moreinfo="none">Style</property> + </emphasis> field, you can fill it out manually or make use of the button next to + the field to bring the <link linkend="css_dialog">CSS Dialog</link> for editing + styles.</para> + + <para>You can observe all defined templates in the <link linkend="VisualPageEditor2">VPE + Preferences</link> on the Templates tab which you can quickly access by pressing + <link linkend="AdvancedSettings954">Preferences button</link>.</para> + + <figure float="0"> + <title>Templates Tab of the VPE Preferences Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7c.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Here it's possible to edit or remove any listed in the table + template.</para> + + </section> + + <section id="AdvancedSettings954"> + + <title>Advanced Settings</title> + + <para>In the left vertical pane of the Visual part there are three buttons: <emphasis> + <property moreinfo="none">Preferences</property>, </emphasis><emphasis> + <property moreinfo="none">Refresh</property> + </emphasis> and <emphasis> + <property moreinfo="none">Page Design Options</property>.</emphasis></para> + + <figure float="0"> + <title>Buttons on the Visual Part of VPE</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <itemizedlist> + <listitem id="vpe_preferences"> + <para><emphasis> + <property moreinfo="none">Preferences</property> + </emphasis> button provides a quick access to <property moreinfo="none">Visual Page + Editor</property> preferences.</para> + + <figure float="0"> + <title>Visual Page Editor Preferences Window</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem> + <para>Clicking on <emphasis> + <property moreinfo="none">Refresh</property> + </emphasis> button you refresh the displayed information.</para> + </listitem> + + <listitem> + <para><emphasis> + <property moreinfo="none">Page Design Options</property> + </emphasis> button leads to window which helps you to specify necessary + references to resources. Here is what this window looks like.</para> + <figure float="0"> + <title>Page Design Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>This dialog lets you set resources which are usually only resolved in + runtime. Let's look at what functionality it proposes.</para> + + <para>The first two sections of the window let you define actual runtime + folders. The example below will help you to clarify how this can be + used.</para> + + <para>Suppose you have the following project structure:</para> + + <programlisting format="linespecific" role="XML"><![CDATA[WebContent/ + pages/ + img/ + a.gif + header.jsp + main.jsp + ]]></programlisting> + + <para>The content of the <emphasis> + <property moreinfo="none">header.jsp</property> + </emphasis> is:</para> + <programlisting format="linespecific" role="XML"><![CDATA[My Header +<img src="img/a.gif"/> +]]></programlisting> + <para>and <emphasis> + <property moreinfo="none">main.jsp</property> + </emphasis> content is:</para> + <programlisting format="linespecific" role="XML"><![CDATA[<jsp:include page="pages/header.jsp" /> +]]></programlisting> + <para> When you open <emphasis> + <property moreinfo="none">main.jsp</property> + </emphasis> in <property moreinfo="none">Visual Page Editor</property>, it will not be able + to resolve the image from the header, however, it will work fine in runtime. + To fix this in design time, click the <emphasis> + <property moreinfo="none">Page Design Options</property> + </emphasis> button and set <emphasis> + <property moreinfo="none">Actual Run-Time Relative Folder</property> + </emphasis> to <emphasis>'projectName &gt; WebContent &gt; + pages'</emphasis> and you will see the image appeared.</para> + <para></para> + + <para id="el_exp_para">In the bottom part of the window you can set a path to + included css files, tag libs and substituted EL expressions.</para> + <figure float="0"> + <title>Bottom Part of the Page Design Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Let' consider an example. For instance, the definition of your + CSS on the page is the next:</para> + + <programlisting format="linespecific" role="XML"><![CDATA[<link rel="stylesheet" type="text/css" + href="#{facesContext.externalContext.requestContextPath}/style.css"/> +]]></programlisting> + + <para>This will work fine in runtime, but the <property moreinfo="none">Visual Page + Editor</property> doesn't know what + <emphasis>requestContextPath</emphasis> in design time is. In order to + see the necessary styles applied in design time your should add a path to + your stylesheet in the <property moreinfo="none">CSS File Path</property> section.</para> + + <para>The next <property moreinfo="none">URI</property> section lets you add URI taglibs so that + the editor knows where to find the tag libraries.</para> + + <para>And the last <property moreinfo="none">Substituted EL expressions</property> section is + provided to specify the values for specific EL variables. It can be useful + for a preview generation.</para> + <para>As an example look at the figure below:</para> + <figure float="0"> + <title>EL Expression</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Here bath in Source and Visual modes you see the EL expression + <emphasis>#{user.name}</emphasis>. When you switch to <property moreinfo="none">Preview + view</property>, you'll also see this expression. Now press <emphasis> + <property moreinfo="none">Page Design Options</property> + </emphasis> button and set the value for the + <emphasis>"user.name"</emphasis> as + <emphasis><property moreinfo="none">World</property>.</emphasis></para> + + <figure float="0"> + <title>Setting the Value for the EL Expression</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>As a result in Visual mode and Preview view the word <emphasis> + <property moreinfo="none">World</property> + </emphasis> is displayed.</para> + <figure float="0"> + <title>The EL Expression Value</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + </itemizedlist> + + <para>You can find useful one more functionality provided by VPE. At the bottom of the + <property moreinfo="none">Visual/Source view</property> there is a <property moreinfo="none">Selection Tag + Bar</property>. It allows to see tags tree for a current component selected in + Visual or Source mode.</para> + + <figure float="0"> + <title>Selection Tag Bar</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_15.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>If you want to hide the <property moreinfo="none">Selection Tag Bar</property>, use the button in + the form of a red cross on the lower right side. To reset it again you should check + the proper option in the <link linkend="vpe_preferences">VPE + Preferences</link>.</para> + </section> + + <section id="page_preview"> + <title>Page Preview</title> + + <para><property moreinfo="none">VPE</property> comes with design-time preview feature which is available + for:</para> + + <itemizedlist> + <listitem> + <para>Struts Pages</para> + </listitem> + <listitem> + <para>JSF Pages</para> + </listitem> + </itemizedlist> + + <para><property moreinfo="none">Preview view</property> is read-only, it shows how the page will look + like in a browser.</para> + <figure float="0"> + <title>Preview View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_16.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <!--para>You can even + attach your stylesheet to the preview.</para--> + </section> + + <section id="SetupnotesforLinu895x"> + + <title>Setup notes for Linux</title> + + <para>Linux users may need to do the following to get the <property moreinfo="none">Visual Page + Editor</property> to work correctly on their machines.</para> + + <para> The Visual Page Editor requires the library libstdc++.so.5. This library is + contained in the compat-libstdc++-33.i386 package.</para> + + <itemizedlist> + <listitem> + <para>To install this package on Fedora Core or Red Hat Enterprise Linux run the + following command:</para> + <programlisting format="linespecific" role="JAVA"><![CDATA[yum install compat-libstdc++-33.i386 +]]></programlisting> + </listitem> + + + <listitem> + <para>On any other rpm based distributions download libstdc++.so.5 and run the + following command:</para> + <programlisting format="linespecific" role="JAVA"><![CDATA[rpm -Uvh compat-libstdc++-33.i386 +]]></programlisting> + </listitem> + + + <listitem> + <para>On Debian based distributives run the following command: </para> + <programlisting format="linespecific" role="JAVA"><![CDATA[apt-get install compat-libstdc++-33.i386 +]]></programlisting> + </listitem> + + </itemizedlist> + + <para> In case you have the library installed and you still have issue with starting the + visual page editor then close all browser views/editors and leave one visual page + editor open and restart eclipse. This should force a load of the right XULRunner + viewer.</para> + + </section> + + <!-- <section id="CreateLookAndFeel(Design-timeMetadate)ForAnyCustomJSFComponents41"> +<?dbhtml filename="CreateLookAndFeel(Design-timeMetadate)ForAnyCustomJSFComponents.html"?> +<title>JSP Visual Page Editor - Design Time Look and Feel for Custom Components</title> + +<itemizedlist> +<listitem><ulink url="http://www.jboss.org/404.html">Template definition for design-time representation of custom tags</ulink> (pdf) +<para></para> + <note> + <title>Note:</title> + <para>The templates files are now saved in <emphasis>&lt;RedHatDeveloperStudio&gt;\eclipse\plugins\com.exadel.vpe_1.1.1\plugin.xml</emphasis>. The PDF files show the old location.</para> + </note> +<para></para></listitem> + +<listitem><ulink url="http://www.jboss.org/404.html">Steps to Create Plug-in</ulink> (pdf)</listitem> +<listitem><ulink url="index.html">How to use create(..) method</ulink> (pdf)</listitem> +<listitem>API +<itemizedlist> +<listitem><ulink url="http://www.jboss.org/404.html">VpeAbstractTemplate</... +<listitem><ulink url="http://www.jboss.org/404.html">VpeTemplate</ulink>... +<listitem><ulink url="http://www.jboss.org/404.html">Download</ulink> examples. The examples.zip file contains two + applications. The first application transforms the JSP source tag into visual tag (HTML). This application + is an Eclipse plug-in. Import as an Eclipse project. The second application is a Web applications which + uses the custom component (project with JSF Nature).</listitem> +</itemizedlist> +<para>Please send us an email to <ulink url="mailto:support@exadel.com">support@exadel.com</ulink> if you have + questions about this feature.</para> +</section> + + +<section id="HTML401Suppor421t"> +<?dbhtml filename="HTML4.01Support.html"?> +<title>HTML 4.01 Support</title> +</section> + +<section id="JSP2.0JSTL1.0And1.1Suppor52t"> +<?dbhtml filename="JSP2.0JSTL1.0And1.1Support.html"?> +<title>JSP 2.0, JSTL 1.0/1.1 support</title> +</section> +--> + + </section> + + <section id="more_editors"> + + <title>More Editors</title> + + <para>Besides Visual Page Editor JBDS is supplied with a huge range of various editors for + different file types: properties, TLD, web.xml, tiles, and so on.</para> + <section id="GraphicalPropertiesEditor"> + + <title>Graphical Properties Editor</title> + + <para><property moreinfo="none">The Properties editor</property> allows you to work in two different + modes and also supports unicode characters.</para> + + <para>To create a new properties file, in the Package Explorer view, select<emphasis> + <property moreinfo="none"> New &gt; Properties File</property> + </emphasis> from the right-click context menu on the folder where you want to create + the file.</para> + <figure float="0"> + <title>Selecting Properties File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can edit the file using a table-oriented "Properties" + viewer:</para> + + <figure float="0"> + <title>"Properties" Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also use a Source viewer for editing the file:</para> + <figure float="0"> + <title>Source Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="GraphicalTLDEditor"> + + <title>Graphical TLD Editor</title> + + <para><property moreinfo="none">The TLD editor</property> comes with same features you will find in all + other JBoss Developer Studio editors:</para> + + <itemizedlist> + <listitem> + <para>Graphical and source edit modes</para> + </listitem> + <listitem> + <para>Validation and error checking</para> + </listitem> + </itemizedlist> + <section id="TreeView2"> + + <title>Tree view</title> + + <figure float="0"> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="SourceView1"> + + <title>Source view</title> + + <para>You can easily switch from Tree to Source by selecting the Source tab at the + bottom of the editor.</para> + + <figure float="0"> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can easily add a <property moreinfo="none">new tag</property>:</para> + + <figure float="0"> + <title>Adding a New Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_6.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also easily add a <property moreinfo="none">new attribute</property> to an existing + tag:</para> + <figure float="0"> + <title>Adding a New Attribute</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_7.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Content assist is available when editing the file using the Source + viewer:</para> + + <figure float="0"> + <title>Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_8.png" scale="65"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>In the Source viewer, if at any point a tag is incorrect or incomplete, an + error will be indicated next to the line and also in the Problems view + below.</para> + + <figure float="0"> + <title>Error Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + + + <section id="GraphicalWebApplicationFileEditor"> + + <title>Graphical Web Application File (web.xml) Editor</title> + + <para>The Web Application File editor comes with the same features you will find in all + other JBoss Developer Studio editors:</para> + + <itemizedlist> + <listitem> + <para>Graphical and source edit modes</para> + </listitem> + <listitem> + <para>Validation and error checking</para> + </listitem> + </itemizedlist> + <section id="TreeView1"> + <title>Tree View</title> + + <figure float="0"> + <title>Tree View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can add any new elements right in the <property moreinfo="none">Tree + viewer</property>:</para> + + <figure float="0"> + <title>Adding New Elements</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="SourceView2"> + + <title>Source View</title> + + <para>Switch to the <property moreinfo="none">Source viewer </property>to edit the web.xml file by + hand at any time:</para> + + <figure float="0"> + <title>Source View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ContentAssist"> + + <title>Content Assist</title> + + <para>Content assist is available in the Source viewer. Simply click <emphasis> + <property moreinfo="none">CTRL-Space</property> + </emphasis> anywhere in the file.</para> + + <figure float="0"> + <title>Content Assist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_13.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ErrorCheckingAndValidation"> + + <title>Errors Checking and Validation</title> + + <para>If errors occur anywhere in the file, small red dots will appear next to the + lines where the errors occurred. Also, note that the file is marked by a small x + in the Package Explorer view.</para> + + <figure float="0"> + <title>Errors Reporting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + + <section id="CSSEditor"> + + <title>CSS Editor</title> + + <para>The <property moreinfo="none">CSS editor</property> comes with the same features you will find in + all other JBoss Developer Studio editors.</para> + + <itemizedlist> + <listitem> + <para>Content assist</para> + </listitem> + <listitem> + <para>Validation and error checking</para> + </listitem> + </itemizedlist> + + <para>With the CSS (Cascading Style Sheet) editor, you can take advantage of code + prompting:</para> + + <figure float="0"> + <title>CSS Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_41.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <!-- <para>You can also use the Outline view next to the editor to navigate through the CSS + file:</para> + + <figure> + <title>Outline View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_42.png"/> + </imageobject> + </mediaobject> + </figure> + --> + + <para>And you can also use the Properties view next to the editor to edit existing + stylesheet declaration properties:</para> + + <figure float="0"> + <title>Properties View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_43.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + <section id="JavaScriptEditor"> + + <title>JavaScript Editor</title> + + <para>The <property moreinfo="none">JavaScript editor</property> includes a Preview viewer and a Source + viewer. In the Source viewer, you can use code assist:</para> + + <figure float="0"> + <title>JavaScript Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_44.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also use the Source viewer with the Outline view to navigate around the + file:</para> + + <figure float="0"> + <title>Source Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_45.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + <!-- <section id="ImageViewer"> + + <title>Image Viewer</title> + <para>This simple image viewer allows you to view GIF and JPEG files individually in a + separate window:</para> + + <figure> + <title>Image Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_46.png"/> + </imageobject> + </mediaobject> + </figure> + + </section> --> + <section id="XSDEditor"> + + <title>XSD Editor</title> + + <para>JBoss Developer Studio comes with an <property moreinfo="none">XSD Editor</property> for XML + Schema files. This editor comes from the Web Tools Project (WTP) (see <ulink url="http://www.eclipse.org/webtools/testtutorials/gettingstarted/Ge... Getting Started</ulink>).</para> + + <para>To create a new XSD file, right-click a folder in the Package Explorer view, + select <emphasis> + <property moreinfo="none">New &gt; Other...</property> + </emphasis> from the context menu and then select <emphasis> + <property moreinfo="none">XML &gt; XML Schema</property> + </emphasis> in the dialog box.</para> + + <figure float="0"> + <title>Creating New XSD file</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_47.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The XSD Editor includes two viewers for working on the file, a Design viewer and a + Source viewer:</para> + + <figure float="0"> + <title>Source Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_48.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>In the Design viewer, you can drill down on an element by double-clicking on + it:</para> + + <figure float="0"> + <title>Design Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_49.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Various edit options are available when you right-click an element in the + diagram:</para> + + <figure float="0"> + <title>Edit Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_50.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also use the Properties view to edit a selected element:</para> + + <figure float="0"> + <title>Properties View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_51.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can also use a Source viewer for the file. In this viewer, along with direct + editing of the source code, you can also edit the file by using the Properties view + on the right:</para> + + <figure float="0"> + <title>Source Viewer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_52.png" scale="85"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + <section id="SupportforXMLSchema"> + + <title>Support for XML Schema</title> + + <para>JBoss Developer Studio fully supports XML files based on schemas as well as + DTDs:</para> + <figure float="0"> + <title>XML File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_53.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + </section> + +</chapter> + + +<chapter id="palette" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/palette.xml" xreflabel="palette"> + <?dbhtml filename="palette.html"?> + <chapterinfo> + <keywordset> + <keyword>Jboss Tools palette</keyword> + <keyword>tags</keyword> + <keyword>JSP page</keyword> + </keywordset> + </chapterinfo> + <title>JBoss Tools Palette</title> + <para>This chapter will introduce you to the functionality provided by <property moreinfo="none">JBoss Tools + Palette</property>. The Palette allows you to quickly and easily create your JSP or JSF + pages. Now you can do it more faster without additional knowledge.</para> + <para>The <property moreinfo="none">JBoss Tools Palette</property> allows you to:</para> + <itemizedlist> + <listitem> + <para>Insert tags into a JSP or JSF page with one click</para> + </listitem> + <listitem> + <para>Add custom and 3rd party tags</para> + </listitem> + </itemizedlist> + <para>The JBoss Tools Palette contains a developer's project tag libraries and provides + possibility to add any tag libraries to it. Also you can choose a necessary one from the + list of already existed tag libraries:</para> + <itemizedlist> + <listitem> + <para>HTML</para> + </listitem> + <listitem> + <para>JBoss</para> + </listitem> + <listitem> + <para>JSF</para> + </listitem> + <listitem> + <para>JSTL</para> + </listitem> + <listitem> + <para>MyFaces</para> + </listitem> + <listitem> + <para>Oracle ADF Faces</para> + </listitem> + <listitem> + <para>Struts</para> + </listitem> + <listitem> + <para>XHTML</para> + </listitem> + </itemizedlist> + <figure float="0"> + <title>Default View of The JBoss Tools Palette</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para><diffmk:wrapper diffmk:change="changed">By default the Palette is represented in Web Development Perspective with five groups. If + you can't see it, select </diffmk:wrapper><emphasis> + <property moreinfo="none">Window &gt; Show View Other... &gt; JBoss Tools Web &gt; JBoss + Tools Palette</property> + </emphasis> from the menu bar.</para> + + <section id="PaletteOptions"> + <?dbhtml filename="PaletteOptions.html"?> + <title>Palette Options</title> + <para>To facilitate your work, you can configure the Palette in your own way, by selecting + the corresponding icon on the Palette toolbar.</para> + <para>There is a possibility to configure the JBoss Tools Palette:</para> + <itemizedlist> + <listitem> + <para> to <property moreinfo="none">edit the palette</property> content by adding, removing or + changing the palette elements</para> + </listitem> + <listitem> + <para> to <property moreinfo="none">show/hide groups</property>, subgroups</para> + </listitem> + <listitem> + <para>to <property moreinfo="none">import groups</property>, subgroups</para> + </listitem> + </itemizedlist> + <figure float="0"> + <title>Palette Buttons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <section id="PaletteEditor"> + <?dbhtml filename="PaletteEditor.html"?> + <title>Palette Editor</title> + <para>JBoss Tools Palette contains existing libraries of tags, thus the + <property moreinfo="none">Palette editor</property> is intended to work with them or create your + new one, as well.</para> + <para>To open the editor, click on the <emphasis> + <property moreinfo="none">Palette Editor</property> + </emphasis> icon: <figure float="0"> + <title>Palette Editor Icon</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </para> + <para>The window has two parts. There is a reflected grouped list of components on the + left side of the palette editor. Each group is divided into multiple groups, every + of which is a tag library. The right side of the palette editor is an editing window + where it's possible to change values of group or tag library attributes + that you've chosen on the left part of the window. </para> + <para>It can also be done by right click and using <emphasis> + <property moreinfo="none">Edit…</property> + </emphasis> option.</para> + <literallayout class="normal" format="linespecific"></literallayout> + <para> For example, <property moreinfo="none">JSF</property> group consists of + <property moreinfo="none">Core</property>, <property moreinfo="none">Facelets</property>, <property moreinfo="none">HTML</property> + tag libraries and the attributes as <property moreinfo="none">name</property>, + <property moreinfo="none">description</property> and <property moreinfo="none">hidden</property> which are available + for editing: </para> + <figure float="0"> + <title>Tag Libraries of the JSF Group</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_24.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The Palette Editor provides the following possibilities when working with existing + tags or icons:</para> + <itemizedlist> + <listitem> + <para>to work with a set of icons</para> + <para><emphasis> + <property moreinfo="none">Icons</property> + </emphasis> is the root folder for the icon sets. The first step is creating + the icon set. Right click on the <emphasis> + <property moreinfo="none">Icons</property> + </emphasis> folder and select <emphasis> + <property moreinfo="none">Create &gt; Create Set...</property> + </emphasis></para> + <para>Set the value of the name in the <emphasis> + <property moreinfo="none">Add Icons</property> + </emphasis> window and click <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> button. A new element will appear in the list.</para> + <figure float="0"> + <title>Creating a Set of Icons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Also you can delete the set. Right click on the set of icons that you wish + to remove and chose the <emphasis> + <property moreinfo="none">Delete Set</property> + </emphasis> option from the pop-up menu or click the <emphasis> + <property moreinfo="none">Delete</property> + </emphasis> keyboard button.</para> + </listitem> + <listitem> + <para>to edit icons in the chosen set</para> + <para>When the set of icons is created, new icons can be imported to it. Choose + the required set and select the option <emphasis> + <property moreinfo="none">Create &gt; Import Icon... </property> + </emphasis> from the pop-up menu that appears after you right-click on a + folder.</para> + <figure float="0"> + <title>Creating Icons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_18.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Set the name of the icon and the path and click <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> button.</para> + </listitem> + <listitem> + <para>to work with a group of tag libraries</para> + <para>The first step in work with the editor is creating a group of libraries. + It's very easy to do, right mouse button click on the <emphasis> + <property moreinfo="none">Palette</property> + </emphasis> folder and select <emphasis> + <property moreinfo="none">Create &gt; Create Group…</property> + </emphasis></para> + <para>Set a name of a group in the <property moreinfo="none">Create Group</property> window and + click <emphasis> + <property moreinfo="none">OK</property> + </emphasis> button. A new element will appear at the end of the list.</para> + <figure float="0"> + <title>Creating a Group of Tag Libraries</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_19.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>You are allowed to edit or delete a group, as well. If you'd like + to change attributes of a group, use the right editing window of the palette + editor or the <emphasis> + <property moreinfo="none">Edit...</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> option, like it was mentioned before. In order to remove the + group, right click on the group that you wish to remove and choose the </diffmk:wrapper><emphasis> + <property moreinfo="none">Delete</property> + </emphasis> option or click the <emphasis> + <property moreinfo="none">Delete</property> + </emphasis> keyboard button.</para> + <important> + <title>Important:</title> + <para>The removal option is enabled only for custom folders.</para> + </important> + </listitem> + <listitem> + <para>to work with a tag library</para> + <para>The group maintains a list of tag libraries. If you'd like to + create your own library, click right mouse button on the group and choose <emphasis> + <property moreinfo="none">Create Group…</property> + </emphasis> option.</para> + <figure float="0"> + <title>Creating a tag library</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_20.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>After setting the attribute name and the path of the icon, click <emphasis> + <property moreinfo="none">Ok</property> + </emphasis> button.</para> + <note> + <title>Note:</title> + <para>If you do not choose an icon the default one will be assigned.</para> + </note> + <para>You are allowed to edit or delete the tag library, as well. If + you'd like to change attributes of the library or choose another + icon, use the right editing window of the palette editor or the <emphasis> + <property moreinfo="none">Edit...</property> + </emphasis> option. In order to remove the tag library, right click on the + library that you wish to remove and chose the <emphasis> + <property moreinfo="none">Delete</property> + </emphasis> option or click the <emphasis> + <property moreinfo="none">Delete</property> + </emphasis> keyboard button.</para> + <important> + <title>Important:</title> + <para>The removal option is enabled only for custom tag libraries.</para> + </important> + </listitem> + <listitem> + <para>to work with a tag element</para> + <para>When the library folder is created, new tags can be added to it. Choose + the required library and select the option <emphasis> + <property moreinfo="none">Create &gt; Create Macro…</property> + </emphasis> from the pop-up menu that appears after you right-click on a + folder.</para> + <figure float="0"> + <title>Creating a tag element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_21.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>In the <property moreinfo="none">Add Palette Macro</property> window, you can configure + the tag element. Attribute <emphasis> + <property moreinfo="none">Name</property> + </emphasis> is mandatory to fill and it will be the name of the tag element. + Other settings are optional. You can choose the icon and set the <emphasis> + <property moreinfo="none">Start Text</property> + </emphasis> and the <emphasis> + <property moreinfo="none">End Text</property> + </emphasis> for your tag element. If your tag text is too long, use the <emphasis> + <property moreinfo="none">Change...</property> + </emphasis> button to see it all. For <emphasis> + <property moreinfo="none">start text</property> + </emphasis> and <emphasis> + <property moreinfo="none">end text</property> + </emphasis> there is a possibility to control the cursor position by using + "|" symbol.</para> + <figure float="0"> + <title>Parameters of the Palette element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_23.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>After all the attributes are set, click <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> button.</para> + <note> + <title>Note:</title> + <para>If you do not choose an icon the default one will be assigned.</para> + </note> + <para>You are also allowed to edit or delete the tag. If you'd like to + change the attributes of the tag or choose another icon for it, use the + right editing window of the palette editor or the <emphasis> + <property moreinfo="none">Edit...</property> + </emphasis> option from the pop-up menu. In order to remove the tag, right + click on the tag that you wish to remove and chose the <emphasis> + <property moreinfo="none">Delete</property> + </emphasis> option or click the <emphasis> + <property moreinfo="none">Delete</property> + </emphasis> keyboard button.</para> + <important> + <title>Important:</title> + <para>The removal option is enabled only for custom tags. JBoss Palette tags + can not be removed but can be modified.</para> + </important> + </listitem> + + </itemizedlist> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If you have changed any abject in the tree view and you don't like the final result you can always use the </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Restore Defaults</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> button. Click on it will restore defaults for the object selected and for its children elements. Please remember that the button will only restore data for objects defined in the default palette. If selected object is created by you, the button will be disabled. Child objects added by you will not be removed.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">When updating JBoss Tools the palette content is not updated.</diffmk:wrapper></para> + </section> + <section id="show_hide"> + <?dbhtml filename="Show/Hide.html"?> + <title>Show/Hide</title> + <para><emphasis> + <property moreinfo="none">Show/Hide</property> + </emphasis> is a very useful feature that allows you to control the number of tag + groups that are shown on the palette.</para> + <itemizedlist> + <listitem> + <para>Click <emphasis> + <property moreinfo="none">Show/Hide</property> + </emphasis> button, at the top right side of the JBoss Tools Palette.</para> + </listitem> + </itemizedlist> + <figure float="0"> + <title>Show/Hide Button</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem> + <para>In the dialog Show/Hide Drawers check the groups the libraries of which + you want to be shown on the palette:</para> + </listitem> + </itemizedlist> + <figure float="0"> + <title>Show/Hide Drawers</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>If libraries are not displayed in the palette, check whether they are selected. + Click the plus sign to expand the libraries of the group and make sure that a tick + is put next to the wanted libraries.</para> + <!-- <para>(When you deactivate the group(s), the JBoss Palette remembers your last chose. + The libraries… )</para> + --> + <itemizedlist> + <listitem> + <para>Click <emphasis><property moreinfo="none">OK</property>.</emphasis> The new groups will + now be shown on the palette:</para> + </listitem> + </itemizedlist> + <figure float="0"> + <title>New Added Groups</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The names of the elements are compound. The first part is the group name and the + second is the library name.</para> + </section> + <section id="Import"> + <?dbhtml filename="Import.html"?> + <title>Import</title> + <para>The Import button lets you add a custom or 3rd party tag library to JBoss Tools + Palette. Find out more information on how to add particular tags see the <link linkend="ImportButton521">Adding Custom JSF Tags</link> section. + <!--<link linkend="CreatingAndWorkingCustomCapability">Learn how to import</link>. --></para> + </section> + </section> + <section id="UsingThePaletteIncludingOneClickTagInsertion"> + <?dbhtml filename="UsingThePaletteIncludingOneClickTagInsertion.html"?> + <title>Using the Palette</title> + <section id="InsertingTagsIntoAJSPFile"> + <?dbhtml filename="InsertingTagsIntoAJSPFile.html"?> + <title>Inserting Tags into a JSP File</title> + <para>A new tag can be added into any text file including jsp, htm, html and xhtml.</para> + <para>Let's do it. Open your JSP file and place the cursor in a place where + you'd like to add a tag and then click that tag in the palette. In the + <property moreinfo="none">Insert Tag</property> window, that appears, you can set the value of<emphasis> + <property moreinfo="none">general</property> + </emphasis> and <emphasis> + <property moreinfo="none">advanced</property> + </emphasis> attributes of the tag that you chose.</para> + <figure float="0"> + <title>Inserting Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_25.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>In the example below, the <emphasis> + <property moreinfo="none">commandButton</property> + </emphasis> tag has been inserted.</para> + <figure float="0"> + <title>Inserting Tag</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_2.png" scale="80"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <tip> + <title>Tip:</title> + <para>if you place the cursor over any tag, a balloon hint is shown with all the + <emphasis role="italic"> + <property moreinfo="none">"tag"</property> + </emphasis> attributes.</para> + </tip> + <para>The cursor position after adding a tag into a file is specified by + "|" symbol in the tag template on the right in the Palette Editor + window. </para> + <figure float="0"> + <title>Palette Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_15.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para> Above you can see where the cursor position for <emphasis> + <property moreinfo="none">HTML &gt; Form &gt; input</property> + </emphasis> is set. Thus, after adding this tag into your file the cursor will be in + the attribute "type". Then, you can straight use the combination + of buttons <property moreinfo="none">Ctrl + Space</property> to inquire about a prompting. </para> + <figure float="0"> + <title>Cursor position</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_16.png" scale="50"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="AddingCustomJSFTagsToTheRedHatPalette7433"> + <?dbhtml filename="AddingCustomJSFTagsToTheJBossToolsPalette.html"?> + <title>Adding Custom JSF Tags to the JBoss Tools Palette</title> + + <para>There are two ways to add any custom or 3rd party tag library to the + <property moreinfo="none">JBoss Tools Palette</property>:</para> + <itemizedlist> + <listitem> + <para>Drag-and-drop from the Web Projects view</para> + </listitem> + <listitem> + <para>The Import button on the JBoss Tools Palette</para> + </listitem> + </itemizedlist> + <para>Before you can add your custom component library, you need to make sure it is + included in your project. Either place the <emphasis role="italic"> + <property moreinfo="none">".tld"</property> + </emphasis> file or the <emphasis role="italic"> + <property moreinfo="none">".jar"</property> + </emphasis> that includes your tag library under the lib folder in your project. </para> + <section id="Drag_and_Drop65332"> + <?dbhtml filename="DragAndDrop.html"?> + <title>Drag-and-Drop</title> + <para>Switch to the Web Projects view and expand the Tag Libraries folder. If the + view is not active, select <emphasis> + <property moreinfo="none">Window &gt; Show View &gt; Web Projects</property> + </emphasis> from the menu bar.</para> + <figure float="0"> + <title>Web Projects View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Also make sure that the JBoss Tools Palette is open. Select the tag library + that you want to add and simply drag-and-drop it on to the JBoss Tools Palette.</para> + <para>You will see the following dialog window. As you can see JBoss Developer + Studio takes care of all the details. Chosen <emphasis> + <property moreinfo="none">TLD file</property> + </emphasis>, <emphasis> + <property moreinfo="none">name</property> + </emphasis> and <emphasis> + <property moreinfo="none">prefix</property> + </emphasis> of the library and <emphasis> + <property moreinfo="none">Library URL</property> + </emphasis> are detected, thus just need to set the <emphasis> + <property moreinfo="none">Group</property> + </emphasis> name to which you wish to place this tag library. You can either add + this tag library to an existing Group or just create a new one.</para> + <figure float="0"> + <title>Import Tags From TLD File Form</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Once you are finished, you will see the new tag library added to the JBoss + Tools Palette.</para> + <figure float="0"> + <title>JBoss Tools Palette with New Tag Library</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + <section id="ImportButton521"> + <?dbhtml filename="ImportButton.html"?> + <title>Import Button</title> + <para>The same you can do with <emphasis> + <property moreinfo="none">Import</property> + </emphasis> button. You can see this button at the top right side of the JBoss + Tools Palette.</para> + <figure float="0"> + <title>Import Button</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>By clicking on the <emphasis> + <property moreinfo="none">Import button</property> + </emphasis> you will see the Import Tag window a similar like in the <link linkend="Drag_and_Drop65332"> Drag-and-Drop</link> method. Set the name and + prefix of the library and Library URL. Also you need to set the Group name to + which you'd like to add your tag library. And like in the previous + method you can add it to an existing Group or create a new one. On this Import + Tag form you can use <emphasis> + <property moreinfo="none">Browse...</property> + </emphasis>button to locate the tag library that you want to add:</para> + <figure float="0"> + <title>Select TLD File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + </section> + <section id="RichFacesSupport"> + <?dbhtml filename="RichFacesSupport.html"?> + <title>RichFaces Support</title> + <para><property moreinfo="none">JBoss Developer Studio</property> comes with a tight integration with <ulink url="http://labs.jboss.com/jbossrichfaces/">RichFaces component framework</ulink>. + RichFaces and Ajax4jsf tag libraries in <link linkend="palette">JBoss Tools + Palette</link> always exist.</para> + + <figure float="0"> + <title>RichFaces Components</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To start using <property moreinfo="none">RichFaces</property> components as well as + <property moreinfo="none">Ajax4jsf</property> ones in JBDS you should first put <emphasis> + <property moreinfo="none">richfaces-*.jar</property> + </emphasis> files into the <emphasis> + <property moreinfo="none">/lib</property> + </emphasis> folder of your project.</para> + <!-- this palette is not dynamic and is not changed from file to file. --> + + <note> + <title>Note:</title> + + <para>Currant version of <property moreinfo="none">JBoss Developer Studio</property> (i. e. 1.1.0GA) + includes <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces + 3.2.2</ulink>. The JBoss Tools 3.0.0.beta1 comes with <ulink url="http://www.jboss.org/jbossrichfaces/downloads/">RichFaces 3.1.3</ulink> and + partly support 3.2 version of the component framework. If you need to use the latest + version of the component framework you should import it into the Palette like any + other <link linkend="AddingCustomJSFTagsToTheRedHatPalette7433">custom tag + library</link>.</para> + </note> + + <section> + <title>Relevant Resources Links</title> + <para>It may be helpful for you to look through the <ulink url="http://docs.jboss.org/tools/movies/demos/rich_faces_demo/rich_f... which covers a creation of a jsf application with simple content + using the RichFaces components.</para> + </section> + + </section> +</chapter> + + +<chapter id="web_projects" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/web_projects.xml" xreflabel="web_projects"> + <?dbhtml filename="web_projects.html"?> +<title>Web Projects View</title> +<para><property moreinfo="none">Web Projects</property> is a special view that comes with JBoss Developer Studio.</para> +<para>If the Web Projects view's tab is not visible next to the Package Explorer tab, select <emphasis><property moreinfo="none">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 and Struts 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><link linkend="AddingCustomJSFTagsToTheRedHatPalette7433">Select custom and third-party tag libraries to drag and drop onto +the JBoss Tools Palette</link></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 float="0"> + <title>Web Projects View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_1.png"></imagedata> + </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 moreinfo="none">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 moreinfo="none">"value"</property></emphasis> attribute.</para> +<figure float="0"> +<title>OutputText Tag</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_2.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +<para>Select the property:</para> +<figure float="0"> +<title>Selecting Property</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_3.png"></imagedata> + </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 <emphasis><property moreinfo="none">#{Message.header}</property></emphasis> automatically.</para> + <figure float="0"> +<title>Inserted Property</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_4.png"></imagedata> + </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 <emphasis><property moreinfo="none">&lt;h:outputText value="#{Message.header}"/&gt;</property></emphasis> in the page.</para> + </section> +<section id="ForManagedBeanAttributes"> + +<title>For Managed Bean Attributes</title> + +<para>Select a <emphasis role="italic"><property moreinfo="none">"managed bean"</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 moreinfo="none">"value"</property></emphasis> attribute of the inputText tag.</para> +<figure float="0"> +<title>Selecting Managed Bean Attribute</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_5.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +<para>Once again, JBoss Developer Studio adds the correct expression, <emphasis>#{user.name}</emphasis>.</para> +<figure float="0"> +<title>Added Expression</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_6.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="NavigationRules"> + +<title>Navigation Rules</title> + +<para>Select the navigation rule under <emphasis><property moreinfo="none">Configuration &gt; faces-config.xml &gt; Navigation Rules</property></emphasis>:</para> +<figure float="0"> +<title>Selecting Navigation Rule</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_7.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +<para>Drag and drop it inside the commandButton tag:</para> +<figure float="0"> +<title>Naviagation Rule in CommandButton Tag</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_8.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +<para>You could do the same if the navigation rule was defined inside an action method:</para> +<figure float="0"> +<title>Navigation Rule in Action Method</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_9.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +<para>Here is how it would look after drag and drop:</para> +<figure float="0"> +<title>Inserted Navigation Rule</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_10.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ForATagLibraryFileDeclaration"> + +<title>For a Tag Library File Declaration</title> + +<para>Select a TLD file:</para> +<figure float="0"> +<title>Selecting TLD File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_11.png"></imagedata> + </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 float="0"> +<title>Inserted TLD File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_12.png"></imagedata> + </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 float="0"> +<title>Creating JSP Forward</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_13.png" scale="80"></imagedata> + </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 float="0"> +<title>Creating New Navigation Rule</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_14.png" scale="90"></imagedata> + </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 moreinfo="none">Expand</property></emphasis>. The TLD file will now be expanded.</para> + +<para>You can then select any tag and drag it onto a JSP page.</para> +<figure float="0"> +<title>Expanding Tag Library File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_15.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="DragAndDropTagLibrariesOnToRedHatPalette"> + +<title>Drag and Drop Tag Libraries on to JBoss Tools Palette</title> + + <para>Read <link linkend="AddingCustomJSFTagsToTheRedHatPalette7433">Adding Tag Libraries</link> 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 continuation="restarts" inheritnum="ignore"> +<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 float="0"> +<title>Web Projects View Buttons</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/web_projects/web_projects_16.png"></imagedata> + </imageobject> +</mediaobject> +</figure> +</section> + +</chapter> + +<chapter id="preferences" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/userguide/en/modules/preferences.xml" xreflabel="preferences"> + <?dbhtml filename="preferences.html"?> + <title>JBoss Tools Preferences</title> + + <para>Configuring the various <property moreinfo="none">JBoss Developer Studio</property> features is done via + the <property moreinfo="none">Preferences</property> screen by selecting <emphasis> + <property moreinfo="none">Window &gt; Preferences &gt; JBoss Tools</property> + </emphasis> from the menu bar.</para> + <figure float="0"> + <title>Preferences are included in this dialog.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>From this screen, you can select these more specific sets of <property moreinfo="none">JBoss Tools + preferences</property>:</para> + + <itemizedlist> + <listitem> + <para> + <link linkend="PackagingArchives">Packaging Archives</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Editors">Editors</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="VisualPageEditor2">Visual Page Editor</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="el_variables">El Variables</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSF">JSF</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSFPage">JSF Page</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSFPropject">JSF Propject</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="JSFFlowDiagram">JSF Flow Diagram</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Seam">Seam</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="SeamValidator">Seam Validator</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Struts">Struts</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="struts_automation">Struts Automatic</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Plug-inInsets">Plug-in Insets</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="ResourceInsets">Resource Insets</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsCustomization">Struts Customization</link> + </para> + </listitem> + + + <listitem> + <para> + <link linkend="StrutsProject">Struts Project</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsSupport">Struts Support</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsPages">Struts Pages</link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="StrutsFlowDiagram">Struts Flow Diagram</link> + </para> + </listitem> + + + <listitem> + <para> + <link linkend="tiles_diagram">Tiles Diagram</link> + </para> + </listitem> + <listitem> + <para> + <link linkend="Verification">Verification</link> + </para> + </listitem> + </itemizedlist> + + <para>The <property moreinfo="none">Preferences</property> dialog <emphasis>( <property moreinfo="none">Window &gt; + Preferences</property>) </emphasis> also allows to adjust settings for <link linkend="JBossServerPreferences">JBoss Server</link> and <link linkend="XDoclet">XDoclet</link> module.</para> + + <section id="PackagingArchives"> + <?dbhtml filename="PackagingArchives.html"?> + <title>Packaging Archives</title> + + <para>Fallow to <emphasis> + <property moreinfo="none">JBoss Tools &gt; Packaging Archives</property> + </emphasis> to open the page for changing Packaging Archives preferences.</para> + <para>Here you can determine settings for Project Packages view and core preferences.</para> + + <figure float="0"> + <title>Packaging Archives</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The next table lists all available preferences for Packaging Archives and their + description.</para> + + <table> + <title>Packaging Archives Preferences</title> + + <tgroup cols="3"> + + <colspec align="left" colnum="1" colwidth="2*"></colspec> + <colspec colnum="2" colwidth="4*"></colspec> + <colspec colnum="3" colwidth="2*"></colspec> + + <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't want to enable incremental + builder for your resources</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show full 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 full root directory of filesets</entry> + <entry>If on, the full root directory is displayed next to filesets. + Otherwise, it'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, 'Show all + projects that contain packages' 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> + </tbody> + </tgroup> + </table> + <!-- + <figure id="full_outputpath_for_packages"> + <title>Show Full Output Path next to Packages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_3.png"/> + </imageobject> + </mediaobject> + </figure> + + <figure id="full_rootdir_for_filesets"> + <title>Show the Full Root Directory of Filesets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_4.png"/> + </imageobject> + </mediaobject> + </figure> + + <figure id="project_at_the_root"> + <title>Show Project at the root</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_5.png"/> + </imageobject> + </mediaobject> + </figure> +--> + + </section> + + <!--section id="CodeAssist"> + <?dbhtml filename="CodeAssist.html"?> + <title>CodeAssist</title> + <para>Select <emphasis> + <property>JBoss Tools > XDoclet > Code Assist</property> + </emphasis> to see Code Assist preference page.</para> + <para>Here is what the Code Assist preference page looks like: </para> + <figure> + <title>CodeAssist</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_2.png"/> + </imageobject> + </mediaobject> + </figure> + </section--> + + <section id="Editors"> + <?dbhtml filename="Editors.html"?> + <title>Editors</title> + <para>To adjust settings common for all editors supplied with <property moreinfo="none">JBoss Developer + Studio</property> you should select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Editors</property>.</emphasis></para> + + <figure float="0"> + <title>Editors</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On the Editors page the following preferences are available:</para> + + <table> + + <title>Editors Preferences</title> + <tgroup cols="3"> + + <colspec align="left" colnum="1" colwidth="2*"></colspec> + <colspec colnum="2" colwidth="4*"></colspec> + <colspec colnum="3" colwidth="2*"></colspec> + + <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> + <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 fully + available for a particular type of file. If no, you'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 moreinfo="none">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 moreinfo="none">Visual Page Editor</property> (VPE) for JSF/HTML files.</para> + <figure float="0"> + <title>Visual Page Editor</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The next table lists the possible settings that you can adjust on the + <property moreinfo="none">General tab</property> of the VPE Preferences page.</para> + + + <table> + + <title>VPE Preferences</title> + <tgroup cols="3"> + + <colspec align="left" colnum="1" colwidth="2*"></colspec> + <colspec colnum="2" colwidth="4*"></colspec> + <colspec colnum="3" colwidth="2*"></colspec> + + <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 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>Always Prompts for Tag Attributes During Tag Insert </entry> + <entry>Having this option off, the dialog with possible attributes for + inserting tag won't appear if all its attributes are optional</entry> + <entry>On</entry> + </row> + + <row> + <entry>Show Selection Tag Bar</entry> + <entry>This option allows to show or hide the Selection Bar</entry> + <entry>On</entry> + </row> + + <row> + <entry>Always Hide Selection Bar Without Prompt</entry> + <entry>Check this box if you don't want the confirmation window + appears when closing the Selection Bar</entry> + <entry>Off</entry> + </row> + + <row> + <entry>Default Editor Tab</entry> + <entry>The option provides with a 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>Size of 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 moreinfo="none">Templates tab</property> you can edit or remove <link linkend="vpe_templating">VPE templates</link>.</para> + <figure float="0"> + <title>Visual Page Editor Templates</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Select a template for editing from the available list and press <emphasis> + <property moreinfo="none">Edit</property> + </emphasis> button. It will pick up the <link linkend="template_dialog">Template + dialog</link> where you can adjust new settings.</para> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; El Variables</property>. </emphasis></para> + + <figure float="0"> + <title>El Variables</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Click <emphasis> + <property moreinfo="none">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 moreinfo="none">Finish</property> + </emphasis>.</para> + + <figure float="0"> + <title>Adding a Global El Variable</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <tip> + <title>Tip:</title> + <para>If you specify an equal variable in <link linkend="el_exp_para">VPE EL + dialog</link> and in Preference EL dialog, variable from preference dialog will + have priority.</para> + </tip> + </section> + <!--section id="JBossServers"> + <?dbhtml filename="JBossServers.html"?> + <title>JBoss Servers</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > JBoss Servers</property> + </emphasis> preference page.</para> + <para>Here is what the JBoss Servers preference page looks like:</para> + <figure> + <title>JBoss Servers</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_4.png"/> + </imageobject> + </mediaobject> + </figure> + </section--> + + <section id="JSF"> + <?dbhtml filename="JSF.html"?> + <title>JSF</title> + <para>Select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; JSF</property> + </emphasis> to get to the JSF Project specific preferences.</para> + <figure float="0"> + <title>JSF</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPage"> + <?dbhtml filename="JSF Page.html"?> + <title>JSF Pages</title> + <para>By selecting <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; JSF &gt; JSF Pages</property> + </emphasis> you can add jsf pages or remove existing ones.</para> + <figure float="0"> + <title>JSF Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPropject"> + <?dbhtml filename="JSFPropject.html"?> + <title>JSF Project</title> + <para>Select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; JSF &gt; Project</property> + </emphasis> to see JSF Project preferences page.</para> + <para>On the <emphasis> + <property moreinfo="none">New Project</property> + </emphasis> tab you can set default values for <ulink url=" ../../jsf_tools_ref_guide/html_single/index.html#new_jsf_project">New JSF Project</ulink> wizard:</para> + + <itemizedlist> + <listitem> + <para><emphasis> + <property moreinfo="none">Version</property> + </emphasis> for setting the default JSF Environment</para> + </listitem> + + <listitem> + <para><emphasis> + <property moreinfo="none">Project Template</property> + </emphasis> so as <property moreinfo="none">New JSF Project wizard</property> shows this + template as default for the chosen JSF Environment</para> + </listitem> + + <listitem> + <para><emphasis> + <property moreinfo="none">Project Root</property> + </emphasis> for specifying default location for a new JSF project</para> + <para>If you check <emphasis> + <property moreinfo="none">Use Default Path</property> + </emphasis> here, this box will be also checked in the <property moreinfo="none">New JSF Project + wizard</property>.</para> + </listitem> + + <listitem> + <para><emphasis> + <property moreinfo="none">Servlet Version</property> + </emphasis> for setting the default Servlet version of a new JSF project</para> + <para>Here it's also possible to define whether to register Web Context in <emphasis> + <property moreinfo="none">server.xml</property> + </emphasis> while organizing a new project or not. Check the proper box in order + to do that.</para> + </listitem> + </itemizedlist> + + <figure float="0"> + <title>New JSF Propject Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On the <emphasis> + <property moreinfo="none">Import Project</property> + </emphasis> tab in the JSF Project screen you can determine the default Servlet version + for the <ulink url=" ../../Exadel-migration/html_single/index.html#import_jsf_screen">Import JSF Project</ulink> + wizard and also whether to register Web Context in <emphasis> + <property moreinfo="none">server.xml</property> + </emphasis> or not.</para> + + <figure float="0"> + <title>Import JSF Propject Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFFlowDiagram"> + <?dbhtml filename="JSFFlowDiagram.html"?> + <title>JSF Flow Diagram</title> + <para>Selecting <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Editors &gt; JSF Flow Diagram</property> + </emphasis> allows you to specify some aspects of the Diagram mode of the JSF + configuration file editor.</para> + + <figure float="0"> + <title>JSF Flow Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_15.png" scale="75"></imagedata> + </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 moreinfo="none">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 float="0"> + <title>Add View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_16.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Selecting the Add Page 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 moreinfo="none">JBoss Tools &gt; Web &gt; Label Decorations</property>. </emphasis></para> + + <figure float="0"> + <title>Label Decorations</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On this page you can determine the format for a text output near the decoration label + for different Web resources. To change the value for selected element, click <emphasis> + <property moreinfo="none">Add Variable...</property> + </emphasis> button next to <emphasis> + <property moreinfo="none">Format</property> + </emphasis> field. Appeared wizard will prompt you to select one from the available + list.</para> + + <figure float="0"> + <title>Label Decoration for Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_18.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Seam</property> + </emphasis> page.</para> + <para>On <emphasis> + <property moreinfo="none">Seam</property> + </emphasis> screen you can add and remove Seam runtimes.</para> + <para>Here is what Seam preference page looks like:</para> + <figure float="0"> + <title>Seam</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_19.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Seam &gt; Validator</property> + </emphasis> page.</para> + <para>In <emphasis> + <property moreinfo="none">Validator</property> + </emphasis> panel you configure seam problems that will be processed by + validator.</para> + <figure float="0"> + <title>Seam Validator</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_20.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Struts"> + <?dbhtml filename="Struts.html"?> + <title>Struts</title> + <para>By selecting <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Struts</property> + </emphasis> you can configure Struts projects specific preferences.</para> + <figure float="0"> + <title>Struts</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_21.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="struts_automation"> + <?dbhtml filename="struts_automation.html"?> + <title>Struts Automation</title> + <para>On <emphasis> + <property moreinfo="none">Automation</property> + </emphasis> panel you can modify default text for the Tilel Struts plug-in element, the + Validator Struts plug-in element, and error message resource files.</para> + <figure float="0"> + <title>Struts Automatic</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_22.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Plug-inInsets"> + <?dbhtml filename="Plug-inInsets.html"?> + <title>Plug-in Insets</title> + <para>By selecting <emphasis> + <property moreinfo="none">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 float="0"> + <title>Plug-in Insets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_23.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The same is done but for validator plugin on the tab Validators.</para> + <figure float="0"> + <title>Plug-in Insets of Validators</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_24.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Strats &gt; Automation &gt; Resource Insets</property> + </emphasis>.</para> + <para>On <emphasis> + <property moreinfo="none">Resource Insets</property> + </emphasis> panel you determine default error messages for error resource files.</para> + <figure float="0"> + <title>Resource Insets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_25.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Struts &gt; Customization</property> + </emphasis> page.</para> + <para>In the<emphasis> + <property moreinfo="none">Customization</property> + </emphasis> screen you configure Link Recognizer for Struts tags.</para> + <figure float="0"> + <title>Struts Customization</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_26.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Struts &gt; Project</property> + </emphasis> preference page:</para> + <para>On <emphasis> + <property moreinfo="none">Project</property> + </emphasis> panel you define a template for a new Struts created project: servlet + version, page template and so on.</para> + <figure float="0"> + <title>Struts Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_27.png"></imagedata> + </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 float="0"> + <title>Import Struts Pages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_28.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Struts &gt; Project &gt; Struts Support</property> + </emphasis> page.</para> + <para>Select <emphasis> + <property moreinfo="none">Struts Support</property> + </emphasis> screen if you want to configure Struts versions support settings.</para> + <figure float="0"> + <title>Struts Support</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_29.png"></imagedata> + </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 &gt; Web &gt; Struts &gt; Struts + Pages preference page.</para> + <para>On <emphasis> + <property moreinfo="none">Struts Pages</property> + </emphasis> panel you can add or remove Struts pages.</para> + <figure float="0"> + <title>Struts Pages</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_30.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Editor &gt; 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 float="0"> + <title>Struts Flow Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_31.png"></imagedata> + </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 float="0"> + <title>Adding Page</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_32.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="tiles_diagram"> + <?dbhtml filename="titles_diagram.html"?> + <title>Tiles Diagram</title> + <para><emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Editors &gt; 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 float="0"> + <title>Title Diagram</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_33.png"></imagedata> + </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 moreinfo="none">JBoss Tools &gt; Web &gt; Verification</property> + </emphasis> page.</para> + <para>On Rules Configuration tab of <emphasis> + <property moreinfo="none">Verifcation</property> + </emphasis> panel you can determine JSF and Struts rules.</para> + <figure float="0"> + <title>Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_34.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>On Options tab you can define a limit for the reported errors number.</para> + <figure float="0"> + <title>Options of Verification</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_35.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + + <section id="JBossServerPreferences"> + <?dbhtml filename="View.html"?> + <title>Server Preferences</title> + <para>Preferences for <property moreinfo="none">JBoss Server</property> and other servers can be changed on + the <emphasis> + <property moreinfo="none">Server</property> + </emphasis> page.</para> + + <figure float="0"> + <title>Server Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On the <emphasis> + <property moreinfo="none">Server &gt; Runtime Environments</property> + </emphasis> page you can add new or modify already defined Server Runtime.</para> + + <figure float="0"> + <title>Runtime Environments</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Server Launching preferences can be configured on the <emphasis> + <property moreinfo="none">Server &gt; Launching</property> + </emphasis> page.</para> + + <figure float="0"> + <title>Server Launching Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_38.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Going to <emphasis> + <property moreinfo="none">Server &gt; 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 float="0"> + <title>Sound Notification Adjustment</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_40.png"></imagedata> + </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 moreinfo="none">XDoclet</property> + </emphasis> on the left navigation bar.</para> + <para>On the <emphasis> + <property moreinfo="none">XDoclet</property> + </emphasis> screen it's possible to enable/disable XDoclet builder by checking + proper box, specify XDoclet home and determine XDoclet module version as well.</para> + + <figure float="0"> + <title>XDoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_41.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Switch to <emphasis> + <property moreinfo="none">XDoclet &gt; ejbdoclet</property> + </emphasis> page in order to adjust settings for EJB-specific sub-tasks.</para> + + <figure float="0"> + <title>ejbdoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_42.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To configure settings for various web-specific XDoclet sub-tasks, follow to <emphasis> + <property moreinfo="none">XDoclet &gt; webdoclet</property> + </emphasis> page.</para> + + <figure float="0"> + <title>webdoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_43.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>On the whole, this document should guide you to those parts of <property moreinfo="none">JBoss + Tools</property> which you specifically need to develop Web Applications. It covers + different aspects of visual components such as editors, views, etc. for browsing, + representing and editing web resources you are working with.</para> + + <para>If there's anything we didn't cover or you can't figure + out, please feel free to visit our <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... Developer Studio Users Forum</ulink> or <ulink url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... Tools Users Forum</ulink> to ask questions. There we are also looking for + your suggestions and comments.</para> + </section> + + <!--section id="XDocletTemplates"> + <?dbhtml filename="XDocletTemplates.html"?> + <title>XDoclet Templates</title> + <para>To see what XDoclet tags templates available for completion select <emphasis> + <property>JBoss Tools > XDoclet > Code Assist > Templates</property> + </emphasis>.</para> + <figure> + <title>XDoclet Templates</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_32.png"/> + </imageobject> + </mediaobject> + </figure> + <para>By right clicking on any tree element you can add a new template, remove or rename it + and also add a new tree.</para> + <para>Select, for example, <emphasis> + <property>Add</property> + </emphasis> and you&apos;ll be prompted by a list of available elements to + add.</para> + <figure> + <title>Add New XDoclet Template</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_33.png"/> + </imageobject> + </mediaobject> + </figure> + <para>By double-clicking some element a new list will be shown: now for available + methods.</para> + <figure> + <title>Select New Element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_34.png"/> + </imageobject> + </mediaobject> + </figure> + <para>Choose any element from the list, then select an attribute.</para> + <figure> + <title>Select New Element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_35.png"/> + </imageobject> + </mediaobject> + </figure> + <para>It will be added to the available templates.</para> + <figure> + <title>Select New Element</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="XDocletsVariables"> + <?dbhtml filename="XDocletsVariables.html"?> + <title>XDoclets Variables</title> + <para>By selecting <emphasis> + <property>JBoss Tools &gt; XDoclet &gt; Variables</property> + </emphasis> you define variables used in templates.</para> + <figure> + <title>XDoclets Variables</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ChangingDefaultEnvironmentDuringProjectCreation"> + <?dbhtml filename="ChangingDefaultEnvironmentDuringProjectCreation.html"?> + <title>Changing Default Environment During Project Creation</title> + + <para>To change the default environment and project template for either JSF or Struts new + project creation:</para> + + <orderedlist> + <listitem> + <para>Select<emphasis> + <property> Window &gt; Preferences &gt; JBoss Tools &gt; Web + &gt; {JSF or Struts} &gt; Project</property> + </emphasis></para> + </listitem> + <listitem> + <para>For Version set the environment you want to be the default one</para> + </listitem> + <listitem> + <para>For Project Template set the template you want to be the default one</para> + </listitem> + </orderedlist> + + <figure> + <title>Changing Enviroment Template</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_36.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="ChangingDefaultProjectTemplateDuringProjectCreatio8n"> + <?dbhtml filename="ChangingDefaultEnvironmentDuringProjectCreation.html"?> + <title>Changing Default Project Template During Project Creation</title> + + <para>To change the default project template for either JSF or Struts new project + creation:</para> + + <orderedlist> + <listitem> + <para>Select<emphasis> + <property> Window > Preferences > JBoss Tools > Web > {JSF or Struts} > + Project</property> + </emphasis></para> + </listitem> + <listitem> + <para>For Project Template set the template you want to be the default one</para> + </listitem> + </orderedlist> + + <figure> + <title>Changing Project Template</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_37.png"/> + </imageobject> + </mediaobject> + </figure> + </section> +--> +</chapter> + +</book>