[jbosstools-commits] JBoss Tools SVN: r11343 - in branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide: en and 1 other directory.

Author: smukhina Date: 2008-10-30 12:03:10 -0400 (Thu, 30 Oct 2008) New Revision: 11343 Added: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/master_output.xml Modified: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/pom.xml Log: https://jira.jboss.org/jira/browse/JBDS-463 markers for new and updated are added Added: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/master_output.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/master_output.xml (rev 0) +++ branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/en/master_output.xml 2008-10-30 16:03:10 UTC (rev 11343) @@ -0,0 +1,3986 @@ +<?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> + Version: 1.1.0.GA + </releaseinfo> +<abstract diffmk:change="added"> + <title diffmk:change="added"></title> + <para diffmk:change="added"> + <ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/en/jsf/pdf/Vi... diffmk:change="added">PDF version</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed">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.</diffmk:wrapper></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" revisionflag="added" 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" 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 click 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> + </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 diffmk:change="added"> + <para diffmk:change="added"> + <ulink diffmk:change="added" url="../../esb_ref_guide/html_single/index.html#ESBContentAssist"><diffmk:wrapper diffmk:change="added">ESB XML files</diffmk:wrapper></ulink> + </para> + </listitem> + </itemizedlist> + + + <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/ediors_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... framework + components. All you have to do is to install RichFaces libraries into your + project. See <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>Adds code assist for JSF pre-defined objects, such as <![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"> + + <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><diffmk:wrapper diffmk:change="changed">Current VPE version has three tabs: </diffmk:wrapper><property moreinfo="none">Visual/Source</property><diffmk:wrapper diffmk:change="added">, + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Source</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><property moreinfo="none">Preview</property><diffmk:wrapper diffmk:change="changed">. To switch between the + views you can use tabs at the bottom of the VPE or the shortcuts </diffmk:wrapper><emphasis> + <property moreinfo="none">Ctrl + PageUp/Ctrl + PageDown</property><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed">It should be pointed out that, no matter in what mode you are working, you get a + full integration with </diffmk:wrapper><property moreinfo="none">Properties</property> and <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Outline + views</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed"> to insert any tag from the list of tag libraries to the page you are + editing with just a click or drag-and-drop.</diffmk:wrapper></para> + <figure float="0"> + <title>Inserting Tag From the Palette</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_4.png" scale="80"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <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> + + <section diffmk:change="added" id="pages_styling"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Pages Styling</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Most web pages use the cascading style sheets (CSS) to control the way they look. + With </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual Page Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> you can easily stylise your pages. In + this section we are going to introduce you to a powerful mechanism that </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">VPE</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> provides for + a complete control over pages styling. </diffmk:wrapper></para> + + <section id="inline_styling"> + <title>Inline Style Editing</title> + + <para><diffmk:wrapper diffmk:change="added">In the Visual part of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">VPE</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> 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.</diffmk:wrapper></para> + + <figure float="0"> + <title>Text Formatting</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">For editing inline styles for DOM elements </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">VPE</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> also + provides </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">CSS Dialog</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed"> 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 </diffmk:wrapper><property moreinfo="none">CSS Dialog</property><diffmk:wrapper diffmk:change="changed"> + allows you to see the changes before you apply them.</diffmk:wrapper></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 diffmk:change="added" id="external_stylesheets"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">External Stylesheets</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The pages you are working with in </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">VPE</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> can use external + stylesheets. </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">VPE</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> allows you to create new style classes in + existing stylesheets and/or edit them as well. For these purposes </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">CSS + Style Class Dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> is provided.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Select the element for which you need to create or edit style class and press + button next to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">styleClass</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> field in </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Properties view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Calling the CSS Style Class Dialog</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">It'll pick up the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">CSS Style Class Dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> which + looks like on the figure below.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS Style Class Dialog</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_18.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">First, you should specify the CSS file where you are going to put your style + class. Do this by pressing button next to the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">CSS file</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> field.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">CSS File Selection</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_19.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To create new CSS class write its name in the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Style class</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> field and then configure style settings switching between the tabs: </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Text/Font</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper></emphasis> + <emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Background</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper></emphasis> + <emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Boxes</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper></emphasis> + <emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Property Sheet</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. </diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">To add existing styling to + the chosen element expand the list of the existed style classes and point to the + necessary one.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Style Class Selection</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_20.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><emphasis diffmk:change="added"> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Quick Edit</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> 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.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Quick Edit</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_21.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">Preview at the top of the </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">CSS Style Class Dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="changed"> + visualizes the result.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">The dialog for creating a new CSS class, which is called from </diffmk:wrapper><emphasis diffmk:change="added"> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">New &gt; Other... &gt; JBoss Tools Web &gt; CSS Class</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, + </diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> looks the same.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">New CSS Class Dialog</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_22.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + </section> + + <section diffmk:change="added" id="vpe_templating"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Templating</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The VPE also makes it possible to create templates for unknown tags.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To call the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Template dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> for a tag, right-click on it in + Visual mode and select </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Template</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> option.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Calling Template Dialog</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_7a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added" id="template_dialog"><diffmk:wrapper diffmk:change="added">Here is what the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Template dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> looks + like.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Template Dialog</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_7b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Tag for Display</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> field in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Template dialog</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> requires specifying a + type of tag. It can be SPAN, DIV, TABLE or any other html element. Here + it's also possible to mark weather the tag is children or not (by checking </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Children</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">), whether it contains an IMG tag (by checking </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Icon</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">) and specify a value for it.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="changed">What comes to the </diffmk:wrapper><emphasis> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Style</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> field, you can fill it out manually or make use of the button next to + the field to bring the </diffmk:wrapper><link diffmk:change="added" linkend="css_dialog"><diffmk:wrapper diffmk:change="added">CSS Dialog</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> for editing + styles.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can observe all defined templates in the </diffmk:wrapper><link diffmk:change="added" linkend="VisualPageEditor2"><diffmk:wrapper diffmk:change="added">VPE + Preferences</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> on the Templates tab which you can quickly access by pressing + </diffmk:wrapper><link diffmk:change="added" linkend="AdvancedSettings954"><diffmk:wrapper diffmk:change="added">Preferences button</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Templates Tab of the VPE Preferences Page</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_7c.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Here it's possible to edit or remove any listed in the table template.</diffmk:wrapper></para> + + </section> + + <section diffmk:change="added" id="AdvancedSettings954"> + + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Advanced Settings</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In the left vertical pane of the Visual part there are three buttons: </diffmk:wrapper><emphasis diffmk:change="added"> + <property moreinfo="none"><diffmk:wrapper diffmk:change="added">Preferences</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, </diffmk:wrapper></emphasis><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Refresh</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Page Design Options</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Buttons on the Visual Part of VPE</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added" id="vpe_preferences"> + <para><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Preferences</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button provides a quick access to </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual Page + Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> preferences.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual Page Editor Preferences Window</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + <listitem diffmk:change="added"> + <para><diffmk:wrapper diffmk:change="added">Clicking on </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Refresh</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button you refresh the displayed information.</diffmk:wrapper></para> + </listitem> + + <listitem diffmk:change="added"> + <para><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Page Design Options</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button leads to window which helps you to specify necessary + references to resources. Here is what this window looks like.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Page Design Options</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">This dialog lets you set resources which are usually only resolved in + runtime. Let's look at what functionality it proposes.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="changed">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.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Suppose you have the following project structure:</diffmk:wrapper></para> + + <programlisting format="linespecific" role="XML"><![CDATA[WebContent/ + pages/ + img/ + a.gif + header.jsp + main.jsp + ]]></programlisting> + + <para><diffmk:wrapper diffmk:change="added">The content of the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">header.jsp</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> is:</diffmk:wrapper></para> + <programlisting format="linespecific" role="XML"><![CDATA[My Header +<img src="img/a.gif"/> +]]></programlisting> + <para><diffmk:wrapper diffmk:change="added">and </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">main.jsp</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> content is:</diffmk:wrapper></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><diffmk:wrapper diffmk:change="added"> in </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual Page Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, 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 </diffmk:wrapper><emphasis> + <property moreinfo="none">Page Design Options</property> + </emphasis> button and set <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Actual Run-Time Relative Folder</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> to </diffmk:wrapper><emphasis><diffmk:wrapper diffmk:change="added">'projectName &gt; WebContent &gt; + pages'</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> and you will see the image appeared.</diffmk:wrapper></para> + <para diffmk:change="added"></para> + + <para diffmk:change="added" id="el_exp_para"><diffmk:wrapper diffmk:change="added">In the bottom part of the window you can set a path to + included css files, tag libs and substituted EL expressions.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Bottom Part of the Page Design Options</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Let&apos;s consider an example. For instance, the definition of your + CSS on the page is the next:</diffmk:wrapper></para> + + <programlisting diffmk:change="added" format="linespecific" role="XML"><diffmk:wrapper diffmk:change="added"><![CDATA[<link rel="stylesheet" type="text/css" + href="#{facesContext.externalContext.requestContextPath}/style.css"/> +]]></diffmk:wrapper></programlisting> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This will work fine in runtime, but the </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Visual Page + Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> doesn't know what + </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">requestContextPath</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> 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 </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">CSS File Path</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> section.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">The next </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">URI</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> section lets you add URI taglibs so that + the editor knows where to find the tag libraries.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="changed">And the last </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Substituted EL expressions</diffmk:wrapper></property><diffmk:wrapper diffmk:change="changed"> section is + provided to specify the values for specific EL variables. It can be useful + for a preview generation.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">As an example look at the figure below:</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">EL Expression</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Here bath in Source and Visual modes you see the EL expression + </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">#{user.name}</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">. When you switch to </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Preview + view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, you'll also see this expression. Now press </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Page Design Options</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button and set the value for the + </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">#{user.name}</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> as + </diffmk:wrapper><emphasis diffmk:change="added"><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">World</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Setting the Value for the EL Expression</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">As a result in Visual mode and Preview view the word </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">World</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> is displayed.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">The EL Expression Value</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </listitem> + + </itemizedlist> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can find useful one more functionality provided by VPE. At the bottom of the + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual/Source view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> there is a </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Selection Tag + Bar</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. It allows to see tags tree for a current component selected in + Visual or Source mode.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Selection Tag Bar</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/visual_page/visual_page_15.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If you want to hide the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Selection Tag Bar</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, 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 </diffmk:wrapper><link diffmk:change="added" linkend="vpe_preferences"><diffmk:wrapper diffmk:change="added">VPE + Preferences</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></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"> + <?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>By default the Palette is represented in Web Development Perspective with four groups. If + you can't see it, select <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><diffmk:wrapper diffmk:change="changed"> icon: </diffmk:wrapper><figure float="0"> + <title>Palette Editor Icon</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </para> + <para><diffmk:wrapper diffmk:change="changed">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. </diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed"> group consists of + </diffmk:wrapper><property moreinfo="none">Core</property>, <property moreinfo="none">Facelets</property><diffmk:wrapper diffmk:change="changed">, </diffmk:wrapper><property moreinfo="none">HTML</property><diffmk:wrapper diffmk:change="changed"> + tag libraries and the attributes as </diffmk:wrapper><property moreinfo="none">name</property><diffmk:wrapper diffmk:change="changed">, + </diffmk:wrapper><property moreinfo="none">description</property><diffmk:wrapper diffmk:change="changed"> and </diffmk:wrapper><property moreinfo="none">hidden</property><diffmk:wrapper diffmk:change="changed"> which are available + for editing: </diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed">The Palette Editor provides the following possibilities when working with existing + tags or icons:</diffmk:wrapper></para> + <itemizedlist> + <listitem> + <para>to work with a set of icons</para> + <para><emphasis> + <property moreinfo="none">Icons</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> is the root folder for the icon sets. The first step is creating + the icon set. Right click on the </diffmk:wrapper><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><diffmk:wrapper diffmk:change="changed">Also you can delete the set. Right click on the set of icons that you wish + to remove and chose the </diffmk:wrapper><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><diffmk:wrapper diffmk:change="changed">When the set of icons is created, new icons can be imported to it. Choose + the required set and select the option </diffmk:wrapper><emphasis> + <property moreinfo="none">Create &gt; Import Icon... </property> + </emphasis><diffmk:wrapper diffmk:change="changed"> from the pop-up menu that appears after you right-click on a + folder.</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed">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 </diffmk:wrapper><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><diffmk:wrapper diffmk:change="changed"> window and + click </diffmk:wrapper><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><diffmk:wrapper diffmk:change="changed">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 </diffmk:wrapper><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 chose 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><diffmk:wrapper diffmk:change="changed">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 </diffmk:wrapper><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><diffmk:wrapper diffmk:change="changed">If you do not choose an icon the default one will be assigned.</diffmk:wrapper></para> + </note> + <para><diffmk:wrapper diffmk:change="changed">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 </diffmk:wrapper><emphasis> + <property moreinfo="none">Edit...</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> option. In order to remove the tag library, right click on the + library that you wish to remove and chose 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><diffmk:wrapper diffmk:change="changed">The removal option is enabled only for custom tag libraries.</diffmk:wrapper></para> + </important> + </listitem> + <listitem> + <para>to work with a tag element</para> + <para><diffmk:wrapper diffmk:change="changed">When the library folder is created, new tags can be added to it. Choose + the required library and select the option </diffmk:wrapper><emphasis> + <property moreinfo="none">Create &gt; Create Macro…</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> from the pop-up menu that appears after you right-click on a + folder.</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed"> window, you can configure + the tag element. Attribute </diffmk:wrapper><emphasis> + <property moreinfo="none">Name</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> 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 </diffmk:wrapper><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><diffmk:wrapper diffmk:change="changed"> there is a possibility to control the cursor position by using + "|" symbol.</diffmk:wrapper></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><diffmk:wrapper diffmk:change="changed">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 </diffmk:wrapper><emphasis> + <property moreinfo="none">Edit...</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> 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 </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><diffmk:wrapper diffmk:change="changed">The removal option is enabled only for custom tags. JBoss Palette tags + can not be removed but can be modified.</diffmk:wrapper></para> + </important> + </listitem> + + </itemizedlist> + </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" role="updated"> + <?dbhtml filename="RichFacesSupport.html"?> + <title>RichFaces Support</title> + <para><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Developer Studio</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> comes with a tight integration with </diffmk:wrapper><ulink url="http://labs.jboss.com/jbossrichfaces/"><diffmk:wrapper diffmk:change="changed">RichFaces component framework</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. + RichFaces and Ajax4jsf tag libraries in </diffmk:wrapper><link diffmk:change="added" linkend="palette"><diffmk:wrapper diffmk:change="added">JBoss Tools + Palette</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> always exist.</diffmk:wrapper></para> + + <figure float="0"> + <title>RichFaces Components</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/palette/palette_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To start using </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">RichFaces</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> components as well as + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ajax4jsf</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> ones in JBDS you should first put </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">richfaces-*.jar</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> files into the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">/lib</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> folder of your project.</diffmk:wrapper></para> + <!-- this palette is not dynamic and is not changed from file to file. --> + + <note diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Currant version of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> (i. e. 1.1.0GA) + includes </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.org/jbossrichfaces/downloads/"><dif... diffmk:change="added">RichFaces + 3.2.2</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. The JBoss Tools 3.0.0.beta1 comes with </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.org/jbossrichfaces/downloads/"><dif... diffmk:change="added">RichFaces 3.1.3</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> 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 </diffmk:wrapper><link diffmk:change="added" linkend="AddingCustomJSFTagsToTheRedHatPalette7433"><diffmk:wrapper diffmk:change="added">custom tag + library</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </note> + + <section diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Relevant Resources Links</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It may be helpful for you to look through the </diffmk:wrapper><ulink diffmk:change="added" url="http://docs.jboss.org/tools/movies/demos/rich_faces_demo/rich_f... diffmk:change="added">movie</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> which covers a creation of a jsf application with simple content + using the RichFaces components.</diffmk:wrapper></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> + + + + + + <section diffmk:change="added" id="Plug-inInsets"> + <?dbhtml filename="Plug-inInsets.html"?> + <title><diffmk:wrapper diffmk:change="changed">Plug-in Insets</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">By selecting </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Web &gt; Struts &gt; Automation &gt; Plug-in Insets</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> on tab Tiles you can define a default text for tiles plugin.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Plug-in Insets</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_23.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para><diffmk:wrapper diffmk:change="added">The same is done but for validator plugin on the tab Validators.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Plug-in Insets of Validators</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_24.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="ResourceInsets"> + <?dbhtml filename="ResourceInsets.html"?> + <title><diffmk:wrapper diffmk:change="changed">Resource Insets</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">To see Resource Insets preference page select </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Strats &gt; Automation &gt; Resource Insets</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed">.</diffmk:wrapper></para> + <para>On <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Resource Insets</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> panel you determine default error messages for error resource files.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Resource Insets</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_25.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="StrutsCustomization"> + <?dbhtml filename="StrutsCustomization"?> + <title><diffmk:wrapper diffmk:change="changed">Struts Customization</diffmk:wrapper></title> + <para>The following preferences can be changed on the <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Struts &gt; Customization</diffmk:wrapper></property> + </emphasis> page.</para> + <para><diffmk:wrapper diffmk:change="changed">In the</diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Customization</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> screen you configure Link Recognizer for Struts tags.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Struts Customization</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_26.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="StrutsProject"> + <?dbhtml filename="StrutsProject.html"?> + <title><diffmk:wrapper diffmk:change="changed">Struts Project</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">You can change the following preferences on the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Struts &gt; Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> preference page:</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">On </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> panel you define a template for a new Struts created project: servlet + version, page template and so on.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Struts Project</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_27.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para><diffmk:wrapper diffmk:change="changed">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.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Import Struts Pages</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_28.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="StrutsSupport"> + <?dbhtml filename="StrutsSupport.html"?> + <title><diffmk:wrapper diffmk:change="changed">Struts Support</diffmk:wrapper></title> + <para>The following preferences can be changed on the <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Struts &gt; Project &gt; Struts Support</diffmk:wrapper></property> + </emphasis> page.</para> + <para><diffmk:wrapper diffmk:change="changed">Select </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Struts Support</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> screen if you want to configure Struts versions support settings.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Struts Support</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_29.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="StrutsPages"> + <?dbhtml filename="StrutsPages.html"?> + <title><diffmk:wrapper diffmk:change="changed">Struts Pages</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="added">You can change the following preferences on the JBoss Tools &gt; Web &gt; Struts &gt; Struts + Pages preference page.</diffmk:wrapper></para> + <para>On <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Struts Pages</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> panel you can add or remove Struts pages.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Struts Pages</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_30.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="StrutsFlowDiagram"> + <?dbhtml filename="StrutsFlowDiagram.html"?> + <title><diffmk:wrapper diffmk:change="changed">Struts Flow Diagram</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">Similarly to the JSF Flow Diagram screen, selecting </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Editor &gt; Struts Flow Diagram</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> 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. </diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Struts Flow Diagram</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_31.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para><diffmk:wrapper diffmk:change="changed">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.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Adding Page</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_32.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="tiles_diagram"> + <?dbhtml filename="titles_diagram.html"?> + <title><diffmk:wrapper diffmk:change="changed">Tiles Diagram</diffmk:wrapper></title> + <para><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Editors &gt; Title Diagram</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> screen allows you control some settings for the placement of Tiles + definitions in the Diagram mode of the JBoss Tools Tiles editor.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Title Diagram</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_33.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="Verification"> + <?dbhtml filename="Verification.html"?> + <title><diffmk:wrapper diffmk:change="changed">Verification</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">The following preferences can be changed on the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Verification</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> page.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="added">On Rules Configuration tab of </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Verifcation</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> panel you can determine JSF and Struts rules.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Verification</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_34.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para><diffmk:wrapper diffmk:change="changed">On Options tab you can define a limit for the reported errors number.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Options of Verification</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_35.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In summary, this document should guide you to those parts of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss + Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> which you specifically need to develop Web Applications. It coves different + aspects of visual components such as editors, views, etc. for browsing, representing and + editing web resources you are working with.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If there's anything we didn't cover or you can't figure out, + please feel free to visit our </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&amp;op=viewforum&... diffmk:change="added">JBoss + Developer Studio Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> to ask questions. There we are also looking for your + suggestions and comments.</diffmk:wrapper></para> + </section> + + <!--section id="View"> + <?dbhtml filename="View.html"?> + <title>View</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > JBoss Servers > View</property> + </emphasis> page.</para> + <para>The <emphasis> + <property>View</property> + </emphasis> shows you preferences for JBoss Servers view.</para> + <figure> + <title>View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_28.png" scale="70"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="XDoclet"> + <?dbhtml filename="XDoclet.html"?> + <title>XDoclet</title> + <para>The following preferences can be changed on the <emphasis> + <property>JBoss Tools > XDoclet</property> + </emphasis> page.</para> + <para>On <emphasis> + <property>XDoclet</property> + </emphasis> screen you determine XDoclet module versions.</para> + <figure> + <title>XDoclet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_31.png"/> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="XDocletTemplates"> + <?dbhtml filename="XDocletTemplates.html"?> + <title>XDoclet Templates</title> + <para>To see what XDoclet tags templates available for completion select <emphasis> + <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><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><diffmk:wrapper diffmk:change="changed">Configuring the various </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Developer Studio</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> features is done via + the </diffmk:wrapper><property diffmk:change="added" moreinfo="none">Preferences</property><diffmk:wrapper diffmk:change="changed"> screen by selecting </diffmk:wrapper><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"><diffmk:wrapper diffmk:change="changed">JBoss Tools + preferences</diffmk:wrapper></property>:</para> + + <itemizedlist> + <listitem> + <para> + <link diffmk:change="added" linkend="PackagingArchives"><diffmk:wrapper diffmk:change="added">Packaging Archives</diffmk:wrapper></link> + </para> + </listitem> + + <listitem> + <para> + <link linkend="Editors">Editors</link> + </para> + </listitem> + + <listitem> + <para> + <link diffmk:change="added" linkend="VisualPageEditor2"><diffmk:wrapper diffmk:change="added">Visual Page Editor</diffmk:wrapper></link> + </para> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"> + <link diffmk:change="added" linkend="el_variables"><diffmk:wrapper diffmk:change="added">El Variables</diffmk:wrapper></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 diffmk:change="added" linkend="JSFFlowDiagram"><diffmk:wrapper diffmk:change="added">JSF Flow Diagram</diffmk:wrapper></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 diffmk:change="added" linkend="struts_automation">Struts Automatic</link> + </para> + </listitem> + + <listitem> + <para> + <link diffmk:change="added" linkend="Plug-inInsets"><diffmk:wrapper diffmk:change="added">Plug-in Insets</diffmk:wrapper></link> + </para> + </listitem> + <listitem> + <para> + <link diffmk:change="added" linkend="ResourceInsets"><diffmk:wrapper diffmk:change="added">Resource Insets</diffmk:wrapper></link> + </para> + </listitem> + + <listitem> + <para> + <link diffmk:change="added" linkend="StrutsCustomization"><diffmk:wrapper diffmk:change="added">Struts Customization</diffmk:wrapper></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 diffmk:change="added" linkend="StrutsPages"><diffmk:wrapper diffmk:change="added">Struts Pages</diffmk:wrapper></link> + </para> + </listitem> + + <listitem> + <para> + <link diffmk:change="added" linkend="StrutsFlowDiagram"><diffmk:wrapper diffmk:change="added">Struts Flow Diagram</diffmk:wrapper></link> + </para> + </listitem> + + + <listitem> + <para> + <link diffmk:change="added" linkend="tiles_diagram"><diffmk:wrapper diffmk:change="added">Tiles Diagram</diffmk:wrapper></link> + </para> + </listitem> + <listitem> + <para> + <link diffmk:change="added" linkend="Verification"><diffmk:wrapper diffmk:change="added">Verification</diffmk:wrapper></link> + </para> + </listitem> + </itemizedlist> + + <section id="PackagingArchives"> + + <title><diffmk:wrapper diffmk:change="changed">Packaging Archives</diffmk:wrapper></title> + + <para><diffmk:wrapper diffmk:change="changed">Fallow to </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Packaging Archives</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> to open the page for changing Packaging Archives preferences.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="changed">Here you can determine settings for Project Packages view and core preferences.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Packaging Archives</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/preferences/preferences_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The next table lists all available preferences for Packaging Archives and their + description.</diffmk:wrapper></para> + + <table diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Packaging Archives Preferences</diffmk:wrapper></title> + + <tgroup cols="3" diffmk:change="added"> + + <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec> + <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec> + <colspec colnum="3" colwidth="2*" diffmk:change="added"></colspec> + + <thead diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Option</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Description</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Default</diffmk:wrapper></entry> + </row> + </thead> + + <tbody diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Enable incremental builder</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Uncheck this option if you don't want to enable incremental + builder for your resources</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show full output path next to packages</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">This option allows you to show or hide an output path next to + packages + </diffmk:wrapper><!--(<link linkend="full_outputpath_for_packages">See the + figure</link>)--><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show the full root directory of filesets</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">If on, the full root directory is displayed next to filesets. + Otherwise, it's hidden + </diffmk:wrapper><!--(<link + linkend="full_rootdir_for_filesets">See the figure</link>)--><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show project at the root</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">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 + </diffmk:wrapper><!--(<link + linkend="project_at_the_root">See the figure</link>)--><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show all projects that contain packages</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">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.</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Off</diffmk:wrapper></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 diffmk:change="added" id="Editors"> + <?dbhtml filename="Editors.html"?> + <title>Editors</title> + <para><diffmk:wrapper diffmk:change="added">To adjust settings common for all editors supplied with </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Developer + Studio</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> you should select </diffmk:wrapper><emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; Editors</property>.</emphasis></para> + + <figure float="0"> + <title>Editors</title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">On the Editors page the following preferences are available:</diffmk:wrapper></para> + + <table diffmk:change="added"> + + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Editors Preferences</diffmk:wrapper></title> + <tgroup cols="3" diffmk:change="added"> + + <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec> + <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec> + <colspec colnum="3" colwidth="2*" diffmk:change="added"></colspec> + + <thead diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Option</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Description</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Default</diffmk:wrapper></entry> + </row> + </thead> + + <tbody diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Always use JBoss Tools editors with Open option</diffmk:wrapper></entry> + <entry diffmk:change="added"></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show warning when project has no JBoss Tools capabilities</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">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.</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Use Source tab as a default for multi-tab editors</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">If on, an editor will open the files in the Source view by default</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Off</diffmk:wrapper></entry> + </row> + </tbody> + </tgroup> + </table> + + </section> + + <section diffmk:change="added" id="VisualPageEditor2"> + <?dbhtml filename="VisualPageEditor.html"?> + <title><diffmk:wrapper diffmk:change="changed">Visual Page Editor</diffmk:wrapper></title> + <para><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Editors &gt; Visual Page + Editor</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> screen allows you to control some aspects of the behavior of the + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Visual Page Editor</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> (VPE) for JSF/HTML files.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Visual Page Editor</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The next table lists the possible settings that you can adjust on the + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">General tab</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> of the VPE Preferences page.</diffmk:wrapper></para> + + + <table diffmk:change="added"> + + <title><diffmk:wrapper diffmk:change="changed">VPE Preferences</diffmk:wrapper></title> + <tgroup cols="3" diffmk:change="added"> + + <colspec align="left" colnum="1" colwidth="2*" diffmk:change="added"></colspec> + <colspec colnum="2" colwidth="4*" diffmk:change="added"></colspec> + <colspec colnum="3" colwidth="2*" diffmk:change="added"></colspec> + + <thead diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Option</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Description</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Default</diffmk:wrapper></entry> + </row> + </thead> + + <tbody diffmk:change="added"> + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Border for Unknown Tags</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">The option allows to place the border around unknown tags or undo + this</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Non-Visual Tags</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Check this box, if you want the editor shows non-visual elements on + the page you're editing</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Off</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Resource Bundles Usage as EL Expressions </diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">If the option is checked, the editor will show EL expressions instead + of the resource values</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Off</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Always Prompts for Tag Attributes During Tag Insert </diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Having this option off, the dialog with possible attributes for + inserting tag won't appear if all its attributes are optional</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Show Selection Tag Bar</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">This option allows to show or hide the Selection Bar</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">On</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Always Hide Selection Bar Without Prompt</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Check this box if you don't want the confirmation window + appears when closing the Selection Bar</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Off</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Default Editor Tab</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">The option provides with a possibility to choose one of the following + views - Visual/Source, Source or Preview, as default when opening the + editor</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Visual/Source</diffmk:wrapper></entry> + </row> + + <row diffmk:change="added"> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">Size of Visual Editor Pane 0 – 100% </diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">With the help of this scroll bar you can adjust the percentage rating + between the Source and Visual modes of the Visual/Source view</diffmk:wrapper></entry> + <entry diffmk:change="added"><diffmk:wrapper diffmk:change="added">50%</diffmk:wrapper></entry> + </row> + </tbody> + </tgroup> + </table> + + <para><diffmk:wrapper diffmk:change="added">On the </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Templates tab</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> you can edit or remove </diffmk:wrapper><link diffmk:change="added" linkend="vpe_templating"><diffmk:wrapper diffmk:change="added">VPE templates</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Visual Page Editor Templates</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Select a template for editing from the available list and press </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Edit</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button. It will pick up the </diffmk:wrapper><link diffmk:change="added" linkend="template_dialog"><diffmk:wrapper diffmk:change="added">Template + dialog</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> where you can adjust new settings.</diffmk:wrapper></para> + </section> + + <section diffmk:change="added" id="el_variables"> + <?dbhtml filename="el_variables.html"?> + <title><diffmk:wrapper diffmk:change="changed">El Variables</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">To specify necessary EL variables globally, i. e. for all projects and resources in + your workspace, you should go to </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; El Variables</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. </diffmk:wrapper></emphasis></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">El Variables</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_9.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">Click </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Add...</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> to set value for a new EL variable. In the appeared wizard you should + specify the global values and press </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Adding a Global El Variable</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_10.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <tip diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="added">If you specify an equal variable in </diffmk:wrapper><link diffmk:change="added" linkend="el_exp_para"><diffmk:wrapper diffmk:change="added">VPE EL + dialog</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added"> and in Preference EL dialog, variable from preference dialog will have + priority.</diffmk:wrapper></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 diffmk:change="added" id="JSF"> + <?dbhtml filename="JSF.html"?> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">JSF</diffmk:wrapper></title> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Select </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools &gt; Web &gt; JSF</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> to get to the JSF Project specific preferences.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">JSF</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="JSFPage"> + <?dbhtml filename="JSF Page.html"?> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">JSF Pages</diffmk:wrapper></title> + <para>By selecting <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; JSF &gt; JSF Pages</diffmk:wrapper></property> + </emphasis> you can add jsf pages or remove existing ones.</para> + <figure float="0"> + <title>JSF Page</title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="JSFPropject"> + + <title><diffmk:wrapper diffmk:change="changed">JSF Project</diffmk:wrapper></title> + <para>Select <emphasis> + <property moreinfo="none">JBoss Tools &gt; Web &gt; JSF &gt; Project</property> + </emphasis><diffmk:wrapper diffmk:change="added"> to see JSF Project preferences page.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">On the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> tab you can set default values for </diffmk:wrapper><ulink diffmk:change="added" url=" ../../jsf_tools_ref_guide/html_single/index.html#new_jsf_project"><diffmk:wrapper diffmk:change="added">New JSF Project</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> wizard:</diffmk:wrapper></para> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Version</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> for setting the default JSF Environment</diffmk:wrapper></para> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Project Template</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> so as </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New JSF Project wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> shows this + template as default for the chosen JSF Environment</diffmk:wrapper></para> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Project Root</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> for specifying default location for a new JSF project</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="added">If you check </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Use Default Path</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> here, this box will be also checked in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New JSF Project + wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </listitem> + + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Servlet Version</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> for setting the default Servlet version of a new JSF project</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Here it's also possible to define whether to register Web Context in </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">server.xml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> while organizing a new project or not. Check the proper box in order + to do that.</diffmk:wrapper></para> + </listitem> + </itemizedlist> + + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">New JSF Propject Preferences</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_13.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">On the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Import Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> tab in the JSF Project screen you can determine the default Servlet version + for the </diffmk:wrapper><ulink diffmk:change="added" url=" ../../Exadel-migration/html_single/index.html#import_jsf_screen"><diffmk:wrapper diffmk:change="added">Import JSF Project</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> + wizard and also whether to register Web Context in </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">server.xml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> or not.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Import JSF Propject Preferences</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section diffmk:change="added" id="JSFFlowDiagram"> + <?dbhtml filename="JSFFlowDiagram.html"?> + <title><diffmk:wrapper diffmk:change="changed">JSF Flow Diagram</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="changed">Selecting </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Editors &gt; JSF Flow Diagram</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> allows you to specify some aspects of the Diagram mode of the JSF + configuration file editor.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">JSF Flow Diagram</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_15.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">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 </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Change... </diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added">button allows you to assign a font with a dialog box.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="changed">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.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Add View</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_16.png" scale="75"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">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.</diffmk:wrapper></para> + </section> + + <section diffmk:change="added" id="label_decorations"> + <title><diffmk:wrapper diffmk:change="changed">Label Decorations</diffmk:wrapper></title> + + <para><diffmk:wrapper diffmk:change="changed">The Label Decorations page is opened from </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss Tools &gt; Web &gt; Label Decorations</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. </diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Label Decorations</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">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 </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Add Variable...</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button next to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Format</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> field. Appeared wizard will prompt you to select one from the available + list.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Label Decoration for Validator</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_18.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + + <section id="Seam"> + + <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 diffmk:change="added" fileref="images/preferences/preferences_19.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="SeamValidator"> + + <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 diffmk:change="added" fileref="images/preferences/preferences_20.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="Struts"> + + <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 diffmk:change="added" fileref="images/preferences/preferences_21.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + + + <title><diffmk:wrapper diffmk:change="changed">Struts Automation</diffmk:wrapper></title> + <para>On <emphasis> + <property moreinfo="none">Automation</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> panel you can modify default text for the Tilel Struts plug-in element, the + Validator Struts plug-in element, and error message resource files.</diffmk:wrapper></para> + <figure float="0"> + <title>Struts Automatic</title> + <mediaobject> + <imageobject> + <imagedata diffmk:change="added" fileref="images/preferences/preferences_22.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </chapter> + +</book> Modified: branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/pom.xml =================================================================== --- branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/pom.xml 2008-10-30 16:03:06 UTC (rev 11342) +++ branches/jbosstools-3.0.0.Beta1/jsf/docs/userguide/pom.xml 2008-10-30 16:03:10 UTC (rev 11343) @@ -39,7 +39,7 @@ </dependencies> <configuration> - <sourceDocumentName>master.xml</sourceDocumentName> + <sourceDocumentName>master_output.xml</sourceDocumentName> <sourceDirectory>${pom.basedir}/en</sourceDirectory> <imageResource> <directory>${pom.basedir}/en</directory>