Author: smukhina Date: 2007-11-20 11:29:12 -0500 (Tue, 20 Nov 2007) New Revision: 4987 Added: trunk/jsf/docs/userguide/en/modules/editors.xml trunk/jsf/docs/userguide/en/modules/jboss_tools.xml Log: chapters on editors are placed into one chapter name of the guide is changed, as it is mostly of RHDS and not JBossTools http://jira.jboss.com/jira/browse/RHDS-175 Added: trunk/jsf/docs/userguide/en/modules/editors.xml =================================================================== --- trunk/jsf/docs/userguide/en/modules/editors.xml (rev 0) +++ trunk/jsf/docs/userguide/en/modules/editors.xml 2007-11-20 16:29:12 UTC (rev 4987) @@ -0,0 +1,1617 @@ +<?xml version='1.0' encoding='UTF-8'?> + <chapter id="rhds_editors" xreflabel="rhds_editors"> + <?dbhtml filename="rhds_editors"?> + <chapterinfo> + <keywordset> + <keyword>Red Hat Developer Studio</keyword> + <keyword>RHDS</keyword> + <keyword>Editor</keyword> + </keywordset> + </chapterinfo> + + <title>RHDS Editors</title> + +<para>RHDS is supplied with a huge range of various editors for different file types.</para> + +<section id="editors_features"> + <?dbhtml filename="editors_features.html"?> +<title>Editors Features</title> +<para>Red Hat 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"> +<?dbhtml filename="OpenOnSelection(Hyperlinknavigation)"?> +<title>OpenOn</title> + +<para><property>OpenOn</property> let&apos;s you easily navigate through your project without using the Package Explorer view (project tree). With OpenOn, you can simply click on a reference to another file and that file will be opened.</para> + +<para>OpenOn is available for the following files:</para> +<itemizedlist> +<listitem><para>XML files</para></listitem> +<listitem><para>JSP/XHTML Pages</para></listitem> + <listitem><para>Java files</para></listitem> +</itemizedlist> +<section id="XMLFiles232"> +<?dbhtml filename="XMLFiles"?> +<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 have the mouse cursor over 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> +<title>NameBean Managed Bean</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_1.png"/> + </imageobject> +</mediaobject> +</figure> +<para>This is the result of using OpenOn</para> +<figure> +<title>NameBean Java Class</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_2.png"/> + </imageobject> +</mediaobject> +</figure> +<para>You can also try OpenOn with defined attributes.</para> +<figure> +<title>OpenOn With Defined Attributes</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_3.png"/> + </imageobject> +</mediaobject> +</figure> +<para>You can also open any JSP pages.</para> +<figure> +<title>JSP Page OpenOn</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_4.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="JSPPages223"> +<?dbhtml filename="GettingStartedwithRHDS.html"?> +<title>JSP Pages</title> + +<para><property>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> +<title>OpenOn With Imported Property Files</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_5.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Use OpenOn to open a CSS file used with a JSP page:</para> +<figure> +<title>OpenOn With CSS File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_6.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Open managed beans:</para> +<figure> +<title>OpenOn With Maneaged Beans</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_7.png"/> + </imageobject> +</mediaobject> +</figure> +<para>For JSP files in a JSF project, you can also easily open the navigation rules by applying <property>OpenOn</property> to the JSF tag for the navigation outcome:</para> +<figure> +<title>OpenOn With JSF Tag</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_8.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> + +<section id="CodeAssistAndDynamicCodeAssist42BasedOnProjectData"> +<?dbhtml filename="CodeAssistAndDynamicCodeAssist(BasedOnProjectData).html"?> +<title>Code Assist and Dynamic Code Assist (based on project data)</title> +<section id="ContentAssistFeatures321"> +<?dbhtml filename="ContentAssistFeatures"?> +<title>Content Assist Features</title> +<section id="ContentAssist374"> +<?dbhtml filename="ContentAssist.html"?> +<title>Content Assist</title> +<para><property>Content assist</property> is available when working with</para> + +<itemizedlist> +<listitem><para>Seam project files</para></listitem> +<listitem><para>JSF project files</para></listitem> +<listitem><para>Struts project files</para></listitem> +<listitem><para>JSP files</para></listitem> +</itemizedlist> +</section> +<section id="JSFProjectFiles3087"> +<?dbhtml filename="JSFProjectFiles.html"?> +<title>JSF Project Files</title> + + <para>When working with JSF project in Red Hat Developer Studio, you can use various <property>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"> +<?dbhtml filename="ContentAssistForXMLJSPAndJSFConfigurationFiles.html"?> +<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>Ctrl-Space</property></emphasis> to see what is available.</para> + +<para>Content Assist for JSF configuration file:</para> +<figure> +<title>Content Assist in JSF Configuration File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_9.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Content Assist for JSF JSP file:</para> +<figure> +<title>Content Assist in JSP File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_10.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Content Assist for other JSF XML project files (web.xml shown):</para> +<figure> +<title>Content Assist in web.xml File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_11.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ContentAssistBasedOnProjectData86"> +<?dbhtml filename="ContentAssistBasedOnProjectData.html"?> +<title>Content Assist Based on Project Data</title> + +<para>Red Hat 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>&quot;Managed beans&quot;</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 first screenshot shows how to insert message from a Properties files. You simply put the cursor + inside the <emphasis role="italic"><property>&quot;value&quot;</property></emphasis> attribute and press <emphasis><property>Ctrl-Space</property></emphasis>. Red Hat Developer Studio will scan your project and show a list of possible values to insert.</para> +<figure> +<title>Inserting Message</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_12.png"/> + </imageobject> +</mediaobject> +</figure> +<para>In the following screen shot we are inserting a <emphasis role="italic"><property>&quot;Managed bean&quot;</property></emphasis> attribute value. Again, by simply clicking <emphasis><property>Ctrl-Space</property></emphasis>, Red Hat 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> +<title>Attributes List</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_13.png"/> + </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> +<title>Code Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_14.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ContentAssistWithinJSFGraphicalEditor44"> +<?dbhtml filename="ContentAssistWithinJSFGraphicalEditor.html"?> +<title>Content Assist within Tree JSF Editor</title> + +<para>Red Hat Developer Studio also provides Content Assist when working within the Tree JSF +configuration editor. Just click <emphasis><property>Ctrl-Space</property></emphasis>.</para> +<figure> +<title>Content Assist in Tree JSF Configuration Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_15.png"/> + </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"> +<?dbhtml filename="StrutsProjectFiles.html"?> +<title>Struts Project Files</title> +<section id="ContentAssistForStrutsConfigurationFile75"> +<?dbhtml filename="ContentAssistForStrutsConfigurationFile.html"?> +<title>Content Assist for Struts Configuration File</title> +<figure> +<title>Struts Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_20.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ContentAssistForStrutsJSPFile07"> +<?dbhtml filename="ContentAssistForStrutsJSPFile.html"?> +<title>Content Assist for Struts JSP File</title> +<figure> +<title>Struts JSP Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_21.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> +<section id="JSPPages434"> +<?dbhtml filename="JSPPages.html"?> +<title>JSP Pages</title> +<section id="ContentAssistForJSFTags96"> +<?dbhtml filename="ContentAssistForJSFTags.html"?> +<title>Content Assist for JSF Tags</title> +<para>RHDS provides full code completion for JSF tags:</para> + +<figure> +<title>JSF Tags Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_22.png"/> + </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. As this point you can ask for attribute proposals.</para> +<figure> +<title>Attributes Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_23.png"/> + </imageobject> +</mediaobject> +</figure> + +</section> +<section id="ContentAssistForJSTLTags6332"> +<?dbhtml filename="ContentAssistForJSTLTags.html"?> +<title>Content Assist for JSTL Tags</title> +<figure> +<title>JSTL Tags Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_24.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ContentAssistForHTMLTags7454"> +<?dbhtml filename="ContentAssistForHTMLTags.html"?> +<title>Content Assist for HTML Tags</title> +<para>Content assist for HTML tags has the same mechanism as for JSF tags:</para> +<figure> +<title>HTML Tags Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_25.png"/> + </imageobject> +</mediaobject> +</figure> +<para>You can use as well attributes proposals for HTML tags:</para> +<figure> +<title>HTML Tags Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_26.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ContentAssistForJavaScriptTags67433"> +<?dbhtml filename="ContentAssistForJavaScriptTags.html"?> +<title>Content Assist for JavaScript Tags</title> +<figure> +<title>JavaScript Tags Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_27.png"/> + </imageobject> +</mediaobject> +</figure> +</section> + +<section id="ContentAssistWithinConfigurationEditor743"> +<?dbhtml filename="ContentAssistWithinConfigurationEditor.html"?> +<title>Content Assist within JSF Configuration Editor</title> +<figure> +<title>Content Assist in JSF Configuration Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_28.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> +<section id="ContentAssistForRF"> +<?dbhtml filename="ContentAssistForRF.html"?> +<title>Content Assist for Rich Faces components</title> +<para>RHDS indeed provides code completion for Rich Faces framework components. All you have to do is to install Rich Faces libraries into your project. See <ulink url="http://labs.jboss.com/file-access/default/members/jbossrichface... how to install.</para> +<figure> +<title>Content Assist for Rich Faces Components</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_29.png"/> + </imageobject> +</mediaobject> +</figure> +<itemizedlist> + <listitem><para>To insert a Rich Faces component on a page expand <emphasis><property>JBoss Rich Faces</property></emphasis> group on the palette</para></listitem> + <listitem><para>Click on some component</para></listitem> + <listitem><para>Put the needed attributes in the <emphasis><property>Insert Tag</property></emphasis> dialog and click <emphasis><property>Finish</property></emphasis> button + <figure> +<title>Insert Tag</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_30.png"/> + </imageobject> +</mediaobject> +</figure> + </para></listitem> + </itemizedlist> + <para>The Rich Faces tag will be inserted on your page displayed in source and visual modes: </para> + <figure> +<title>Rich Faces Component</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_31.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> + +<section id="AddingDynamicCodeAssistToCustomComponents8745"> +<?dbhtml filename="AddingDynamicCodeAssistToCustomComponentsThatWereAddedToJBossToolsPalette.html"?> +<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 +Red Hat Developer Studio:</para> +<orderedlist> + <listitem><para>Create a new xml file in <emphasis><property>&lt;RHDS_home&gt;rhds/eclipse/plugins/org.jboss.tools.common.kb_***/schemas/tld/</property></emphasis>. For example call it JeniaFaces.xml. The file should be written according to <emphasis><property>&lt;RHDS_home&gt;/rhds/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>Here is how you set what is available for code assist:</para> +<itemizedlist> +<listitem><para>Adds code assist for JSF pre-defined objects, such as value=<emphasis role="italic"><property>&quot;#{param}&quot;</property></emphasis>:</para></listitem> +</itemizedlist> +<programlisting role="XML"><![CDATA[<AttributeType ...> + <proposal type="jsfVariables"/> +</AttributeType> +]]></programlisting> + <itemizedlist> +<listitem><para>Adds bundle resource (property file) <property>code assist</property>:</para></listitem> + </itemizedlist> +<programlisting role="XML"><![CDATA[<AttributeType ...> + <proposal type="bundleProperty"/> +</AttributeType> +]]></programlisting> + <itemizedlist> +<listitem><para>Adds managed bean property <property>code assist</property>:</para></listitem> + </itemizedlist> +<programlisting role="XML"><![CDATA[<AttributeType ...> + <proposal type="beanProperty"/> +</AttributeType> +]]></programlisting> + <itemizedlist> +<listitem><para>Adds managed bean property but with a specified type:</para></listitem> + </itemizedlist> +<programlisting role="XML"><![CDATA[<AttributeType ...> + <proposal type="beanProperty"> + <param name="type" value="java.lang.Boolean"/> + </proposal> +</AttributeType> +]]></programlisting> + <itemizedlist> +<listitem><para>Adds managed bean method with a signature:</para></listitem> + </itemizedlist> +<programlisting 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="continues"> + <listitem><para>Add information on your xml file in <emphasis><property>&lt;RHDS_home&gt;/rhds/eclipse/plugins/org.jboss.common.kb_***/plugin.xml</property></emphasis></para></listitem> + </orderedlist> + <programlisting role="XML"><![CDATA[ + <tld + jsf="true" + name="Jenia Faces" + schema-location="schemas/tld/myJSF.xml" + uri="http://www.jenia.org/jsf/dataTools"/>]]> + </programlisting> +<orderedlist continuation="continues"> +<listitem><para>Restart Eclipse. You should now have code assist for the component.</para></listitem> + </orderedlist> +</section> +</section> +<section id="FullControlOverSourceFiles-SynchronizedSourcAndVisualEditing74"> +<?dbhtml filename="FullControlOverSourceFiles-SynchronizedSourcAndVisualEditing.html"?> +<title>Full Control over Source Files - Synchronized Source and Visual Editing</title> + +<para>Red Hat Developer Studio 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. Red Hat Developer Studio provides you many different + graphical editors to speed your application development. At the same time, you always have full control + over all project source files. Any changes you make in the source view, will immediately appear in + the graphical view.</para> + +<para>The JSF configuration file editor has three views: Diagram, Tree and Source. All views are +synchronized, you can edit the file in any view.</para> +<figure> +<title>Diagram View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_32.png"/> + </imageobject> +</mediaobject> +</figure> +<figure> +<title>Tree View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_33.png"/> + </imageobject> +</mediaobject> +</figure> + +<figure> +<title>Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_34.png"/> + </imageobject> +</mediaobject> +</figure> +<para>The same applies to all other Red Hat Developer Studio editors.</para> + +<para>Web XML editor is shown. Web XML editor has a graphical view (Tree) and source (Source).</para> + +<figure> +<title>Tree View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_35.png"/> + </imageobject> +</mediaobject> +</figure> +<figure> +<title>Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_36.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Red Hat Developer Studio TLD file editor shown in Tree view. At any point you can edit the source by going + switching to Source view.</para> +<figure> +<title>Tree Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_37.png"/> + </imageobject> +</mediaobject> +</figure> +<figure> +<title>Source Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_38.png"/> + </imageobject> +</mediaobject> +</figure> +<para>The Struts configuration file editor has three views: Diagram, Tree and Source. All views are synchronized, + you can edit the file in any view.</para> +<figure> +<title>Struts Diagram View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_39.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Source view. Any changes here will immediately appear in all other views.</para> +<figure> +<title>Struts Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/editors_features/editors_features_40.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> + + +<section id="visual_page"> +<?dbhtml filename="visual_page.html"?> +<title>Visual Page Editor</title> +<para>Red Hat Developer Studio comes with a powerful and customizable <property>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> + +<section id="visual_tabs"> +<?dbhtml filename="visual_tabs.html"?> + +<para>Current VPE version has four tabs: Visual/Source, Visual, Source and Preview.</para> +<para>Split screen design with instant synchronization between source and visual views:</para> +<figure> +<title>Visual/Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_1.png" /> + </imageobject> +</mediaobject> +</figure> + +<para>You can also switch to pure Visual design:</para> +<figure> +<title>Visual View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_2.png" /> + </imageobject> +</mediaobject> +</figure> + +<para>Or work just in Source view. Note that selection bar is now available not only in Visual mode but also in Source one:</para> +<figure> +<title>Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_3.png" /> + </imageobject> +</mediaobject> +</figure> +<para>No matter what view you select, you get full integration with Properties and Outline views:</para> +<figure> +<title>Properties And Outline Views</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_4.png" /> + </imageobject> +</mediaobject> +</figure> +<para>Preview mode is read-only, it only shows how the page will look like in a browser.</para> +<figure> +<title>Preview Mode</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_5.png" /> + </imageobject> +</mediaobject> +</figure> +<para>Use the graphical toolbar to add inline styling to any tag.</para> +<figure> +<title>Graphical Toolbar</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_6.png" /> + </imageobject> +</mediaobject> +</figure> +<para>With just a click or drag-and-drop insert any tags from the palette on to the page you are editing.</para> +<figure> +<title>Inserting Tags From Palette</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_7.png" /> + </imageobject> +</mediaobject> +</figure> + +<section id="AdvancedSettings954"> +<?dbhtml filename="AdvancedSettings.html"?> +<title>Advanced Settings</title> + + <para>There are three buttons on the <property>Visual Page Editor</property> left side:</para> + + <figure> + <title>Visual Page Editor Buttons</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_8.png" /> + </imageobject> + </mediaobject> + </figure> + + <itemizedlist> + <listitem><para>Preferences</para></listitem> + </itemizedlist> + <para>Provides quick access to Visual Page Editor preferences.</para> + <figure> + <title>Visual Page Editor Preferences Window</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_9.png" /> + </imageobject> + </mediaobject> + </figure> + <itemizedlist> + <listitem><para>Refresh</para></listitem> + </itemizedlist> + <para>Refresh displaying information with this button.</para> + + <itemizedlist> + <listitem><para>Page Design Options</para></listitem> + </itemizedlist> +<para>This button leads to page design options.</para> + <figure> + <title>Page Design Options</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_10.png" /> + </imageobject> + </mediaobject> + </figure> +<para>This dialog let&apos;s you set resources which are usually only resolved in runtime. To set a stylesheet, + click <emphasis><property>Add</property></emphasis> (for CSS File Path section) and add your stylesheet. It works when CSS is defined on your page in the following way:</para> + +<para>Code:</para> + <programlisting role="XML"><![CDATA[<link rel="stylesheet" type="text/css" href="#{facesContext.externalContext.requestContextPath}/style.css"/> +]]></programlisting> + +<para>This will work fine in runtime, but the Visual Page Editor doesn&apos;t know what requestContextPath in design time is.</para> + +<para>The next section (URI), let&apos;s you add URI taglibs if you are using includes so that the editor knows + where to find the tag libraries.</para> + +<para>The first two sections let you define actual runtime folders. Here is an example.</para> + +<para>Let&apos;s say you have the following project structure:</para> + +<programlisting role="XML"><![CDATA[WebContent/ + pages/ + img/ + a.gif + header.jsp + main.jsp +]]></programlisting> +<para>header.jsp content:</para> +<programlisting role="XML"><![CDATA[My Header +<img src="img/a.gif"/> +]]></programlisting> +<para>main.jsp:</para> +<programlisting role="XML"><![CDATA[<jsp:include page="pages/header.jsp" /> +]]></programlisting> +<para> + When you open <emphasis><property>main.jsp</property></emphasis> in Visual Page Editor, it will not be able to resolve the image from the header, + however, it will work fine in runtime. To fix this in design time, click the <emphasis><property>Page Design Options</property></emphasis> button and + set <emphasis><property>Actual Run-Time Relative</property></emphasis> Folder to <emphasis><property>&lt;project&gt;WebContent > pages</property></emphasis> and you will see the image appear.</para> +<para></para> + <itemizedlist> + <listitem><para>Hide Selection bar</para></listitem> + </itemizedlist> +<para> By clicking on the component in Visual view or selecting a code snippet in Source mode you can see the tags tree. If you want to hide the selection bar, use the &quot;Hide Selection Bar&quot; button on the lower right side.</para> + + <figure> + <title>Selection Bar</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/visual_page/visual_page_11.png"/> + </imageobject> + </mediaobject> + </figure> + </section> +</section> + +<section id="SetupnotesforLinu895x"> +<?dbhtml filename="SetupNotesforLinux.html"?> +<title>Setup notes for Linux</title> +<section id="HowToStartTheVisualPageEditorUnderLinux85"> +<?dbhtml filename="HowToStartTheVisualPageEditorUnderLinux.html"?> +<title>How to Start the Visual Page Editor under Linux</title> + +<para>Linux users may need to do the following to get the Visual Editor to work correctly on their machines.</para> + <itemizedlist> +<listitem><para>On Fedora or Red Hat Enterprise Linux distributions, install the compat-libstdc++-33.i386 and libXp packages:</para></listitem> +</itemizedlist> +<programlisting role="JAVA"><![CDATA[yum install compat-libstdc++-33 libXp +]]></programlisting> + +<itemizedlist> +<listitem><para>On other rpm-based distributions download libXp.i386 package from <ulink url="http://rpm.pbone.net/index.php3/stat/4/idpl/3418392/com/libXp-1... +</para></listitem> +<listitem><para>And install it on your machine:</para></listitem> +</itemizedlist> +<programlisting role="JAVA"><![CDATA[rpm -U libXp-1.0.0-8.i386 +]]></programlisting> + +<itemizedlist> +<listitem><para>Open the RHDS perspective. If you see the Help view open, close it and restart RHDS +</para></listitem> +</itemizedlist> +</section> + + <!-- <section id="JustInCase06"> +<?dbhtml filename="JustInCase.html"?> +<title>Just in Case</title> + +<para>If you still experience problems, tell us about your system. Please do the following:</para> +<itemizedlist> + <listitem><para>Clear the Eclipse log file, <emphasis>&lt;workspace&gt;\.metadata\.log</emphasis></para></listitem> + +<listitem><para>Start Eclipse with the -debug option:</para></listitem></itemizedlist> +<programlisting role="JAVA"><![CDATA[eclipse -debug +]]></programlisting> +<itemizedlist> + <listitem><para>Send the Eclipse log file (<emphasis>&lt;workspace&gt;\.metadata\.log</emphasis>) to <ulink url="mailto:support@exadel.com">support@exadel.com</ulink></para></listitem> +</itemizedlist> + </section> + --> +</section> + +<section id="JSPsyntaxvalidation84"> +<?dbhtml filename="JSPsyntaxValidation.html"?> +<title>JSP syntax validation</title> +<para>When working in JBoss Tools JSP editor you are constantly provided with feedback and +contextual error checking as you type.</para> +</section> + + <!-- <section id="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 id="PageEditorWithPreview53"> +<?dbhtml filename="PageEditorWithPreview.html"?> +<title>JSP Page Preview</title> + +<para>Red Hat Developer Studio comes with JSP design-time preview features. When designing JSP pages you + can easily preview how they will look during runtime. You can even attach your stylesheet to the preview.</para> + +<para>JSP preview is available for:</para> + +<itemizedlist> +<listitem><para>Struts Pages</para></listitem> +<listitem><para>JSF Pages</para></listitem> +</itemizedlist> + +<para>The preview features are available with <link linkend="VisualPageEditor">Visual Page Editor</link>.</para> +</section> +</section> + +<section id="more_editors"> + <?dbhtml filename="more_editors.html"?> +<title>More Editors</title> +<para>Besides Visual Page Editor RHDS provides editors for editing project files of any types: properties, TLD, web.xml, tiles, and so on.</para> +<section id="GraphicalPropertiesEditor"> +<?dbhtml filename="GraphicalPropertiesEditor.html"?> +<title>Graphical Properties Editor</title> + + <para><property>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> New > Properties File</property></emphasis> from the right-click context menu on the folder where you want to create the file.</para> +<figure> +<title>Selecting Properties File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_1.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can edit the file using a table-oriented &quot;Properties&quot; viewer:</para> + +<figure> +<title>&quot;Properties&quot; Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_2.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also use a Source viewer for editing the file:</para> +<figure> +<title>Source Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_3.png"/> + </imageobject> +</mediaobject> +</figure> +</section> + +<section id="GraphicalTLDEditor"> +<?dbhtml filename="GraphicalTLDEditor.html"?> +<title>Graphical TLD Editor</title> + + <para><property>The TLD editor</property> comes with same features you will find in all other Red Hat 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"> +<?dbhtml filename="TreeView.html"?> +<title>Tree view</title> + +<figure> +<title>Tree View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_4.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="SourceView1"> +<?dbhtml filename="SourceView.html"?> +<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> +<title>Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_5.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can easily add a <property>new tag</property>:</para> + +<figure> +<title>Adding a New Tag</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_6.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also easily add a <property>new attribute</property> to an existing tag:</para> +<figure> +<title>Adding a New Attribute</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_7.png"/> + </imageobject> +</mediaobject> +</figure> +<para>Content assist is available when editing the file using the Source viewer:</para> + +<figure> +<title>Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_8.png"/> + </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> +<title>Error Reporting</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_9.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> + + +<section id="GraphicalWebApplicationFile(web.xml)Editor"> +<?dbhtml filename="GraphicalWebApplicationFile(web.xml)Editor.html"?> +<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 +Red Hat 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> +<title>Tree View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_10.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can add any new elements right in the <property>Tree viewer</property>:</para> + +<figure> +<title>Adding New Elements</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_11.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="SourceView2"> +<?dbhtml filename="SourceView.html"?> +<title>Source View</title> + +<para>Switch to the <property>Source viewer </property>to edit the web.xml file by hand at any time:</para> + +<figure> +<title>Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_12.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ContentAssist"> +<?dbhtml filename="ContentAssist.html"?> +<title>Content Assist</title> + +<para>Content assist is available in the Source viewer. Simply click <emphasis><property>CTRL-Space</property></emphasis> anywhere in the file.</para> + +<figure> +<title>Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_13.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="ErrorCheckingAndValidation"> +<?dbhtml filename="ErrorCheckingAndValidation.html"?> +<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> +<title>Errors Reporting</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_14.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> +<section id="GraphicalTilesFilesEditor"> +<?dbhtml filename="GraphicalTilesFilesEditor.html"?> +<title>Graphical Tiles Files Editor</title> +<section id="GraphicalEditorForTilesFiles"> +<?dbhtml filename="GraphicalEditorForTilesFiles.html"?> +<title>Graphical Editor For Tiles Files</title> +<para>The Tiles configuration file editor has three main viewers (modes): Tree (shown), Diagram and Source. The modes can be selected via the tabs at the bottom of the editor. Any changes made in one mode are immediately visible when you switch to any other mode.</para> + +<para>When working in Source view, you always have all following features available:</para> + +<itemizedlist> +<listitem><para>Content Assist</para></listitem> +<listitem><para>Open On Selection</para></listitem> +</itemizedlist> +</section> +<section id="CreateNewTilesFile"> +<?dbhtml filename="GraphicalTilesFilesEditor.html"?> +<title>Create New Tiles File</title> + +<para>To create a new Tiles files, right click any folder and select <emphasis><property>New > Tiles Files</property></emphasis>:</para> + +<figure> +<title>Creating New Tiles File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_15.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="TreeView3"> +<?dbhtml filename="TreeView.html"?> +<title>Tree View</title> + +<para>In the Tree mode, the different elements of the Tiles file are organized into functional categories +on the left-hand side and a form for editing the properties of currently selected items on the right-hand + side.</para> + +<figure> +<title>Tree View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_16.png"/> + </imageobject> +</mediaobject> +</figure> +<para>To edit the file, simply right click any node and select among the available actions:</para> + +<figure> +<title>Editing in Tiles Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_17.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="DiagramView"> +<?dbhtml filename="TreeView.html"?> +<title>Diagram View</title> + +<para>The Diagram mode is shown below:</para> +<figure> +<title>Diagram View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_18.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>To create new definition, simply right click anywhere in the diagram:</para> +<figure> +<title>Creating New Definition</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_19.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also use the Diagram toolbar to make editing easier:</para> + +<figure> +<title>Diagram Toolbar</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_20.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="Source"> +<?dbhtml filename="TreeView.html"?> +<title>Source</title> + + <para>The Tiles editor also comes with a <property>Source view</property> that gives you full control over the source. +Any changes here will immediately appear in when you switch to any of the other viewers.</para> +<figure> +<title>Source View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_21.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>Content assist is available in the Source mode.</para> + +<figure> +<title>Content Assist</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_22.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>Any errors are immediately reported as shown below:</para> +<figure> +<title>Error Reporting</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_23.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also use the Outline view together with the editor&apos;s Source mode. Selecting any node in the Outline view will jump to that place in the source:</para> + +<figure> +<title>Outline View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_24.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +</section> + + + +<section id="GraphicalEditorForStrutsValidationFiles"> +<?dbhtml filename="GraphicalStrutsValidationFilesEditor.html"?> +<title>Graphical Editor for Struts Validation Files</title> +<para>Red Hat Developer Studio comes with a visual validation editor. To create a new validation file, +right click any folder and select <emphasis><property>File > Validation File</property></emphasis> from the context menu.</para> + +<figure> +<title>Creating Validation File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_25.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>The validation editor works through a number of viewers.</para> + +<para>The Formsets viewer shows forms and their elements for which to define validation rules:</para> + +<figure> +<title>Formsets Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_26.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>The Constants viewer lets you set constant values for your validation rules:</para> + +<figure> +<title>Constants viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_27.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>The validation file also can be viewed in a Tree viewer:</para> + +<figure> +<title>Tree Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_28.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>At any point you have full control over the source by switching to the Source viewer. Any editing +in this viewer will immediately be available in the other viewers of this editor.</para> + +<figure> +<title>Source Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_29.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also open your own custom or Struts-standard validation-rules.xml file.</para> + +<para>The Validators viewer shows the validation rules for a selected validator. You can of course add your + own rules.</para> + +<figure> +<title>Validation Rules</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_30.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>Here are the validation rules shown in the Source viewer.</para> + +<figure> +<title>Validation Rules in Source Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_31.png"/> + </imageobject> +</mediaobject> +</figure> +</section> +<section id="SpringIDE"> +<?dbhtml filename="SpringIDE.html"?> +<title>Spring IDE</title> + <para>Red Hat Developer Studio bundles a <property>Spring Framework editor</property> from <ulink url="http://springide.org/project">Spring IDE for Eclipse</ulink>. Visit this site for the latest versions and documentation.</para> + + <para>You can add a <property>Spring Project nature</property> to an existing project by right-clicking on the project and + selecting from the context menu:</para> + +<figure> + <title>Adding Spring Project Nature</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_32.png"/> + </imageobject> + </mediaobject> + </figure> + + + <para>Once the nature is added, you will see a small <property>&quot;S&quot;</property> decorating a Spring project in the Package Explorer + view. To remove the nature, right click the project and select <emphasis><property>Remove Spring Project Nature</property></emphasis>:</para> + +<figure> + <title>Project with Spring Nature</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_33.png"/> + </imageobject> + </mediaobject> + </figure> + +<para>After creating a Spring configuration file with bean definitions:</para> + +<figure> + <title>Spring Configuration File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_34.png"/> + </imageobject> + </mediaobject> + </figure> + + <para>Select Spring Beans project with <emphasis><property>Project &gt; Properties &gt; Spring &gt; Beans Support</property></emphasis> from the menu bar:</para> + +<figure> + <title>Spring Beans</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_35.png"/> + </imageobject> + </mediaobject> + </figure> + +<para> Now you can add the Spring bean configuration files to your project by clicking on <emphasis><property>Add</property></emphasis> button:</para> + +<figure> + <title>Adding Configuration Files</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_36.png"/> + </imageobject> + </mediaobject> +</figure> + +<para>Once you add this file, the file will be marked by an &quot;S&quot; to indicate a Spring bean file:</para> + +<figure> + <title>Spring Bean File</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_37.png"/> + </imageobject> + </mediaobject> +</figure> + + <para>To activate the Spring Beans view, select <emphasis><property>Window &gt; Show View... &gt; Other</property></emphasis> and then <emphasis><property>Spring Explorer&gt; Spring Beans</property></emphasis> from the + menu bar:</para> + +<figure> + <title>Selecting Spring Beans View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_38.png"/> + </imageobject> + </mediaobject> + </figure> + +<para>The Spring Beans view shows a read-only outline view of the Spring bean configuration file:</para> + +<figure> + <title>Spring Beans View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_39.png"/> + </imageobject> + </mediaobject> +</figure> + +<para>Using a context menu, you can select a graph view of the Spring configuration file&apos;s referenced + beans:</para> + +<figure> + <title>Graph View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_40.png"/> + </imageobject> + </mediaobject> +</figure> +</section> + +<section id="CSSEditor"> +<?dbhtml filename="CSSEditor.html"?> +<title>CSS Editor</title> + + <para>The <property>CSS editor</property> comes with the same features you will find in all other Red Hat 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> +<title>CSS Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_41.png"/> + </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> +<title>Properties View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_43.png"/> + </imageobject> +</mediaobject> +</figure> + +</section> +<section id="JavaScriptEditor"> +<?dbhtml filename="JavaScriptEditor.html"?> +<title>JavaScript Editor</title> + + <para>The <property>JavaScript editor</property> includes a Preview viewer and a Source viewer. In the Source viewer, you can use code assist:</para> + +<figure> +<title>JavaScript Editor</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_44.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also use the Source viewer with the Outline view to navigate around the file:</para> + +<figure> +<title>Source Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_45.png"/> + </imageobject> +</mediaobject> +</figure> + +</section> +<section id="ImageViewer"> +<?dbhtml filename="ImageViewer.html"?> +<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"> +<?dbhtml filename="XSDEditor.html"?> +<title>XSD Editor</title> + + <para>Red Hat Developer Studio comes with an <property>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>New &gt; Other...</property></emphasis> from the context menu and then select <emphasis><property>XML &gt; XML Schema</property></emphasis> in the dialog box.</para> + +<figure> +<title>Creating New XSD file</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_47.png"/> + </imageobject> +</mediaobject> +</figure> + + <para>The XSD Editor includes two viewers for working on the file, a Design viewer and a Source viewer:</para> + +<figure> +<title>Source Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_48.png"/> + </imageobject> +</mediaobject> +</figure> + + <para>In the Design viewer, you can drill down on an element by double-clicking on it:</para> + +<figure> + <title>Design Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_49.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>Various edit options are available when you right-click an element in the diagram:</para> + +<figure> +<title>Edit Options</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_50.png"/> + </imageobject> +</mediaobject> +</figure> + +<para>You can also use the Properties view to edit a selected element:</para> + +<figure> +<title>Properties View</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_51.png"/> + </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> +<title>Source Viewer</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_52.png"/> + </imageobject> +</mediaobject> +</figure> + +</section> +<section id="SupportforXMLSchema"> +<?dbhtml filename="SupportforXMLSchema.html"?> +<title>Support for XML Schema</title> + +<para>Red Hat Developer Studio fully supports XML files based on schemas as well as DTDs:</para> +<figure> +<title>XML File</title> +<mediaobject> + <imageobject> + <imagedata fileref="images/more_editors/more_editors_53.png"/> + </imageobject> +</mediaobject> +</figure> + +</section> +</section> + +</chapter> \ No newline at end of file Added: trunk/jsf/docs/userguide/en/modules/jboss_tools.xml =================================================================== --- trunk/jsf/docs/userguide/en/modules/jboss_tools.xml (rev 0) +++ trunk/jsf/docs/userguide/en/modules/jboss_tools.xml 2007-11-20 16:29:12 UTC (rev 4987) @@ -0,0 +1,36 @@ +<?xml version="1.0" encoding="UTF-8"?> +<chapter id="jboss_tools" xreflabel="jboss_tools"> + <?dbhtml filename="jboss_tools.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Tools</keyword> + <keyword>Eclipse</keyword> + <keyword>Java</keyword> + <keyword>Tomcat</keyword> + </keywordset> + </chapterinfo> + <title>JBoss Tools</title> +<para>JBoss Tools is an umbrella project for the JBoss developed plugins that will make it into Red Hat Developer Studio. It includes the following Eclipse modules:</para> +<itemizedlist> + <listitem><para><emphasis><property>Seam Tools</property></emphasis> Will include support for seam-gen, RichFaces VE integration, Seam related code completion and refactoring and more.</para> + <para>To read more on Seam, see <ulink url="http://docs.jboss.com/seam/2.0.0.GA/reference/en/html/index.htm... Reference Guide </ulink> or <ulink url="http://www.redhat.com/developers/rhds/Getting_Started/GetStartS... Started Guide</ulink></para></listitem> + <!--TODO link for Seam Guide --> + + <listitem><para><emphasis><property>RichFaces Support</property></emphasis>. <para>Rich Faces is an open source framework that adds Ajax capability into existing JSF applications without resorting to JavaScript.</para> + <para>To read more on RF, see<ulink url="http://labs.jboss.com/jbossrichfaces/docs/index.html"> RF Developer Guide</ulink></para></listitem> + + <listitem><para><emphasis><property>Hibernate Tools</property></emphasis>Supporting mapping files, annotations and JPA with reverse engineering, code completion, project wizards, refactoring, interactive HQL/JPA-QL/Criteria execution and more.In short a merger of Hibernate Tools and Exadel ORM features.</para> + <para>To read more on Hibernate Tools, see <ulink url="http://www.hibernate.org/hib_docs/tools/reference/en/html/"... Tools Reference Guide</ulink></para></listitem> + + <listitem><para><emphasis><property>JBoss AS Tools</property></emphasis> Easy start, stop and debug of JBoss AS 4+ servers from within Eclipse. Will also include features for efficient packaging and deployment of any type of Eclipse project.</para></listitem> + <!-- TODO link for docs <para>To read more on AS Tools, see <ulink url="AS Tools">Hibernate Tools Reference Guide</ulink></listitem>--> + + <listitem><para><emphasis><property>Drools IDE</property></emphasis>Rules file editing, Rete View, working memory debugging/inspection and more.</para></listitem> + <!-- TODO link for docs <para>To read more on AS Tools, see <ulink url="AS Tools">Hibernate Tools Reference Guide</ulink></listitem>--> + + <listitem><para><emphasis><property>JBPM Tools</property></emphasis>JBPM workflow editing, deployment and more.</para></listitem> + <!-- TODO link for docs <para>To read more on AS Tools, see <ulink url="AS Tools">Hibernate Tools Reference Guide</ulink></listitem>--> + + </itemizedlist> + +</chapter>