[jbosstools-commits] JBoss Tools SVN: r7182 - in trunk/jsf/docs/jsf_tools_ref_guide/en: modules and 1 other directory.
jbosstools-commits at lists.jboss.org
jbosstools-commits at lists.jboss.org
Fri Mar 28 10:08:42 EDT 2008
Author: ochikvina
Date: 2008-03-28 10:08:41 -0400 (Fri, 28 Mar 2008)
New Revision: 7182
Added:
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml
Modified:
trunk/jsf/docs/jsf_tools_ref_guide/en/master.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/introduction.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml
trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-261 - the new chapter was organized
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/master.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/master.xml 2008-03-28 13:08:29 UTC (rev 7181)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/master.xml 2008-03-28 14:08:41 UTC (rev 7182)
@@ -8,8 +8,7 @@
<!ENTITY projects SYSTEM "modules/projects.xml">
<!ENTITY jsf_config_file SYSTEM "modules/jsf_config_file.xml">
<!ENTITY managed_beans SYSTEM "modules/managed_beans.xml">
-<!ENTITY cust_converters_validators SYSTEM "modules/cust_converters_validators.xml">
-<!ENTITY referenced_beans SYSTEM "modules/referenced_beans.xml">
+<!ENTITY creation_and_registration SYSTEM "modules/creation_and_registration.xml">
<!ENTITY jsf_project_verification SYSTEM "modules/jsf_project_verification.xml">
]>
<book>
@@ -31,7 +30,6 @@
&projects;
&jsf_config_file;
&managed_beans;
- &cust_converters_validators;
- &referenced_beans;
+ &creation_and_registration;
&jsf_project_verification;
</book>
\ No newline at end of file
Added: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml (rev 0)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/creation_and_registration.xml 2008-03-28 14:08:41 UTC (rev 7182)
@@ -0,0 +1,362 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="creation_and_registration">
+ <?dbhtml filename="creation_and_registration.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>JSF Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
+ <title>Creation and Registration</title>
+
+ <section id="CreateAndRegisterACustomConverter94230">
+
+ <title>Create and Register a Custom Converter</title>
+
+ <para>To create and register a custom converter it's necessary to
+ go through the following steps:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>In the Project Explorer view open <emphasis>
+ <property>faces-config.xml</property>
+ </emphasis> and select <emphasis>
+ <property>Tree</property>
+ </emphasis> tab.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Converters</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_44.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Select <emphasis>
+ <property>Converters</property>
+ </emphasis> and click on<emphasis>
+ <property> Add</property>
+ </emphasis> button.</para>
+ </listitem>
+ <listitem>
+ <para>On the form type the name of your converter in the <emphasis>
+ <property>Converter-id</property>
+ </emphasis> field and name of the class for
+ converters. After clicking <emphasis>
+ <property>Finish</property>
+ </emphasis> button your custom converter is
+ registered under the entered name.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Add Converter Form</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_45.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Now you can create <emphasis role="italic">
+ <property>"converter"</property>
+ </emphasis> class. In the Converter section you
+ should see your <emphasis>
+ <property>Converter-id</property>
+ </emphasis> and
+ <emphasis><property>Converter-class</property>.</emphasis>
+ Click on <emphasis>
+ <property>Converter-class</property>
+ </emphasis> to generate the source code.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Generation of Source Code for Converter Class</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_46.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <itemizedlist>
+ <listitem>
+ <para>A usual wizard for creating a Java class will appear.
+ All needed fields here will be adjusted
+ automatically. Just leave everything without changes
+ and click <emphasis>
+ <property>Finish</property>.
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>New Java Class Form</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_47.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>To open a converter class click again on <emphasis>
+ <property>Converter-class</property>
+ </emphasis> link in the Converter section. Now you
+ are able to add a business logic of converter in the
+ Java editor.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Converter Class</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_48.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ </section>
+
+ <section id="CreateAndRegisterACustomValidator5632">
+
+ <title>Create and Register a Custom Validator</title>
+
+ <para>With the help of JBDS it's also quite easy to develop your
+ own custom Validators. You should perform the actions similar to
+ previous. Go through the following steps:</para>
+ <itemizedlist>
+ <listitem>
+ <para>In the Project Explorer view open<emphasis>
+ <property> faces-config.xml</property>
+ </emphasis> and select <emphasis>
+ <property>Tree </property>
+ </emphasis>tab.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Validator in Faces Config Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_49.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Select <emphasis>
+ <property>Validators</property>
+ </emphasis> and click on <emphasis>
+ <property>Add </property>
+ </emphasis>button.</para>
+ </listitem>
+ <listitem>
+ <para>Type the name of your validator in the <emphasis>
+ <property>Validator-id</property>
+ </emphasis> field and name of the class for
+ validators. After clicking <emphasis>
+ <property>Finish</property>
+ </emphasis> button your custom validator is
+ registered under the entered name.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Adding Validator</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_50.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Now you can create the "validator" class. </para>
+ <itemizedlist>
+ <listitem>
+ <para>In the Validator section you can see your <emphasis>
+ <property>Validator-id</property>
+ </emphasis> and <emphasis>
+ <property>Validator-class</property>
+ </emphasis>. To generate the source code click on <emphasis>
+ <property>Validator-class</property>.
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Creating Validator Class</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_51.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Java class will be created automatically. Leave
+ everything without changes and click <emphasis>
+ <property>Finish</property>.
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>New Java Class Form</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_52.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>To open validator class click again on <emphasis>
+ <property>Validator-Class</property>
+ </emphasis> link in the Validator section. Now you
+ are able to write a business logic of validator in
+ the Java editor.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Converter Class Editing</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_53.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section>
+ <title>Create and Register Referenced Beans</title>
+
+ <para>Creation of Referenced Beans is similar to creation of Custom
+ Validator.</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>In the Project Explorer view open<emphasis>
+ <property> faces-config.xml</property>
+ </emphasis> and select <emphasis>
+ <property>Tree </property>
+ </emphasis>tab.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Referenced Beans in Faces Config Editor</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_54.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Select <emphasis>
+ <property>Referenced Beans</property>
+ </emphasis> and click on <emphasis>
+ <property>Add</property>
+ </emphasis> button.</para>
+ </listitem>
+ <listitem>
+ <para>Type in the name of your Referenced Bean and type in
+ or select <emphasis>
+ <property>Referenced-Bean-Class</property>
+ </emphasis> by using <emphasis>
+ <property>Browse</property>
+ </emphasis> button.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Add Referenced Bean</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_55.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>In the Referenced Bean section you should see your <emphasis>
+ <property>Referenced-Bean-Name</property>
+ </emphasis> and
+ <emphasis><property>Referenced-Bean-Class</property>.</emphasis>
+ Click on the link to open the Java creation
+ wizard.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Create Referenced Bean Class</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_56.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>Java class will be created automatically. Leave
+ everything without changes and click <emphasis>
+ <property>Finish</property>.
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>New Java Class Form</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_57.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para>To open Referenced Bean class click again on <emphasis>
+ <property>Referenced-Bean-Class</property>
+ </emphasis> in the Referenced Bean section. Now you
+ are able to write business logic of Referenced Bean
+ in the Java editor.</para>
+ </listitem>
+ </itemizedlist>
+ <figure>
+ <title>Referenced Bean Class Editing</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
+ fileref="images/jsf_support/jsf_support_58.png"
+ />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+</chapter>
\ No newline at end of file
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/introduction.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/introduction.xml 2008-03-28 13:08:29 UTC (rev 7181)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/introduction.xml 2008-03-28 14:08:41 UTC (rev 7182)
@@ -14,7 +14,13 @@
<title>Introduction</title>
- <para>This guide provides information on JSF tooling in JBoss Developer Studio
+ <para>JBoss Developer Studio is especially designed for supporting JSF and JSF-related
+ technologies. JBDS provides extensible and exemplary tools for building JSF-based
+ applications as well as adding JSF capabilities to existing web projects, importing
+ JSF projects (created outside JBDS) and choosing any JSF implementation while
+ developing JSF application.</para>
+
+ <para>In this guide we provide you with the information on JSF tooling in JBoss Developer Studio
which allows you to develop JSF applications much faster and with far fewer
errors so sparing your time.</para>
</chapter>
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml 2008-03-28 13:08:29 UTC (rev 7181)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml 2008-03-28 14:08:41 UTC (rev 7182)
@@ -10,279 +10,236 @@
<keyword>JBoss</keyword>
</keywordset>
</chapterinfo>
-
+
<title>JSF Configuration File</title>
-
- <para>First, we should mention that JSF configuration file (<emphasis>
+
+ <para>First, we should mention that JSF configuration file (<emphasis>
<property>faces-config.xml</property>
- </emphasis>) is intended for registering JSF application resources
- such as Converters, Validators, Managed Beans and page-to-page
- navigation rules.</para>
- <para>Now, let's look at how you can easily configure this file by
- means of a special graphical editor. The editor has three main
- viewers (modes):</para>
-
+ </emphasis>) is intended for registering JSF application resources such as Converters,
+ Validators, Managed Beans and page-to-page navigation rules.</para>
+ <para>Now, let's look at how you can easily configure this file by means of a special
+ graphical editor for JSF configuration file. The editor has three main views:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Diagram</para>
+ </listitem>
+ <listitem>
+ <para>Tree</para>
+ </listitem>
+ <listitem>
+ <para>Source</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>They can be selected via the tabs at the bottom of the editor.</para>
+
+ <para>The JSF configuration editor also comes with a very useful <link
+ linkend="OpenOnSelection4Hyperlinknavigation">OpenOn</link> selection feature.</para>
+
+ <section id="Diagram9553">
+
+ <title>Diagram view</title>
+
+ <para>Here, we will show you how to work with JSF configuration file through the Diagram
+ view of the editor.</para>
+ <para>As you can see on the figure below, the Diagram view displays the navigation rules in
+ the faces-config.xml:</para>
+ <figure>
+ <title>Diagram View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_21.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To create a new page here, you should click the page icon (View Template) on the
+ toolbar from the left and then click anywhere on the diagram. A New Page Wizard will
+ appear.</para>
+
+ <para>To create a transition for connecting pages:</para>
+
<itemizedlist>
<listitem>
- <para>Diagram</para>
+ <para>Select the transition icon from the toolbar (New Connection).</para>
</listitem>
<listitem>
- <para>Tree</para>
+ <para>Click the source page.</para>
</listitem>
<listitem>
- <para>Source</para>
+ <para>Click the target page.</para>
</listitem>
</itemizedlist>
-
- <para>The modes can be selected via the tabs at the bottom of the editor.</para>
-
- <para>The JSF configuration editor also comes with a very useful <link
- linkend="OpenOnSelection4Hyperlinknavigation">OpenOn</link>
- selection feature.</para>
-
- <section id="Diagram9553">
-
- <title>Diagram</title>
- <para>The Diagram view displays the navigation rules in the JSF
- configuration file:</para>
- <figure>
- <title>Diagram View</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_21.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="CreatingNewViewPage85">
-
- <title>Creating New View (Page)</title>
-
- <para>To create a new page (view), you can click the page icon on
- this toolbar and then click anywhere on the diagram. A New
- Page Wizard will appear.</para>
-
- <para>To create a transition (rule) connecting pages:</para>
-
-
- <itemizedlist>
- <listitem>
- <para>Select the transition icon from the toolbar
- (2nd from the bottom).</para>
- </listitem>
- <listitem>
- <para>Click the source page.</para>
- </listitem>
- <listitem>
- <para>Click the target page.</para>
- </listitem>
- </itemizedlist>
-
- <para>A transition will appear between the two pages:</para>
- <figure>
- <title>Transition Between JSP Pages</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_22.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>It is also possible to create a new page with context menu by
- right-clicking anywhere on the diagram and selecting <emphasis>
- <property>New View</property>. </emphasis></para>
- <figure>
- <title>Creating a New View</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_23.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To edit an existing transition, first select the transition
- line. Then, place the mouse cursor over the last black dot
- (on the target page). The mouse cursor will change to a big
- +. At this point, drag the line to a new target page:</para>
- <figure>
- <title>Editing Transition Between Views</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_24.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="TreeView11123">
-
+
+ <para>A transition will appear between the two pages:</para>
+ <figure>
+ <title>Transition Between JSP Pages</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_22.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>It is also possible to create a new page with context menu by right-clicking anywhere
+ on the diagram and selecting <emphasis>
+ <property>New View</property>. </emphasis></para>
+ <figure>
+ <title>Creating a New View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_23.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To edit an existing transition, first select the transition line. Then, place the
+ mouse cursor over the last black dot (on the target page). The mouse cursor will change
+ to a big +. At this point, drag the line to a new target page:</para>
+ <figure>
+ <title>Editing Transition Between Views</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_24.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="TreeView11123">
+
+ <title>Tree View</title>
+
+ <para>The Tree mode for the editor displays all JSF application artifacts referenced in the
+ configuration file in a tree format. By selecting any node you can see and edit its
+ properties which will appear in the right-hand area. For example, a Managed Bean:</para>
+ <figure>
<title>Tree View</title>
-
- <para>The Tree mode for the editor displays all JSF application
- artifacts referenced in the configuration file in a tree
- format. By selecting any node you can see and edit its
- properties which will appear in the right-hand area. For
- example, a Managed Bean:</para>
- <figure>
- <title>Tree View</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_25.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To edit some artifact, right-click any node and select one of
- the available actions in the context menu. You can also edit
- in the properties window to the right:</para>
- <figure>
- <title>Editing in Tree View</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_26.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- <para>The same way you can create a new artifact:</para>
- <figure>
- <title>Creating a New Artifact in Tree View</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_59.png"
- />
- </imageobject>
- </mediaobject>
- </figure>
- </section>
- <section id="SourceView4643">
-
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_25.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>To edit some artifact, right-click any node and select one of the available actions in
+ the context menu. You can also edit in the properties window to the right:</para>
+ <figure>
+ <title>Editing in Tree View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_26.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The same way you can create a new artifact:</para>
+ <figure>
+ <title>Creating a New Artifact in Tree View</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_59.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+ <section id="SourceView4643">
+
+ <title>Source View</title>
+
+ <para>The Source mode for the editor displays a text view of the JSF configuration file. All
+ three viewers are always synchronized, so any changes made in one of the viewers will
+ immediately appear in the others:</para>
+ <figure>
<title>Source View</title>
-
- <para>The Source mode for the editor displays a text view of the JSF
- configuration file. All three viewers are always
- synchronized, so any changes made in one of the viewers will
- immediately appear in the others:</para>
- <figure>
- <title>Source View</title>
- <mediaobject>
- <imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_27.png"
- scale="75"/>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_support/jsf_support_27.png" scale="75"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
<section id="ContentAssist976">
-
+
<title>Code Assist</title>
- <para>Code Assist provides pop-up tip to help you complete your code
- statements. It allows you to write your code faster and with
- more accuracy.</para>
+ <para>Code Assist provides pop-up tip to help you complete your code statements. It
+ allows you to write your code faster and with more accuracy.</para>
<para>Code assist is always available in the Source mode:</para>
<figure>
<title>Code Assist in Source View</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_28.png"
- scale="75"/>
+ <imagedata fileref="images/jsf_support/jsf_support_28.png" scale="75"/>
</imageobject>
</mediaobject>
</figure>
</section>
<section id="ErrorReporting3324">
-
+
<title>Error Reporting</title>
- <para>When you are developing your project, JBoss Developer Studio
- constantly provides error checking. This greatly reduces
- your development time as it allows you to catch many of the
- errors during development.</para>
- <para>Errors will be reported by JBoss Developer Studio's
- <link linkend="verif_valid"> verification</link>
- facility:</para>
+ <para>When you are developing your project, JBoss Developer Studio constantly provides
+ error checking. This greatly reduces your development time as it allows you to catch
+ many of the errors during development.</para>
+ <para>Errors will be reported by JBoss Developer Studio's <link
+ linkend="verif_valid"> verification</link> facility:</para>
<figure>
<title>Error Reporting in Source View</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_29.png"
- scale="75"/>
+ <imagedata fileref="images/jsf_support/jsf_support_29.png" scale="75"/>
</imageobject>
</mediaobject>
</figure>
-
+
<para>Other errors are also reported.</para>
<figure>
<title>Other Errors Reporting</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_30.png"
- scale="75"/>
+ <imagedata fileref="images/jsf_support/jsf_support_30.png" scale="75"/>
</imageobject>
</mediaobject>
</figure>
-
+
<para>You can also work in the Source editor with the help of the <emphasis>
- <property>Outline view</property>.</emphasis> The
- Outline views show a tree structure of the JSF configuration
- file. Simply select any element in the Outline view, and it
- will jump to the same place in the Source editor, so you can
- navigate through the source code with Outline view.</para>
+ <property>Outline view</property>.</emphasis> The Outline views show a tree
+ structure of the JSF configuration file. Simply select any element in the Outline
+ view, and it will jump to the same place in the Source editor, so you can navigate
+ through the source code with Outline view.</para>
<figure>
<title>Outline View</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_31.png"
- scale="60"/>
+ <imagedata fileref="images/jsf_support/jsf_support_31.png" scale="60"/>
</imageobject>
</mediaobject>
</figure>
-
- <para>If your diagram is large, within Outline view you can switch
- to a <emphasis>
+
+ <para>If your diagram is large, within Outline view you can switch to a <emphasis>
<property>Diagram Navigator</property>
- </emphasis> mode by selecting the middle icon at the top of
- the view window. It allows you to easily move around the
- diagram. Just move the blue area in any direction, and the
- diagram on the left will also move:</para>
+ </emphasis> mode by selecting the middle icon at the top of the view window. It
+ allows you to easily move around the diagram. Just move the blue area in any
+ direction, and the diagram on the left will also move:</para>
<figure>
<title>Outline View for Diagram</title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_32.png"
- scale="60"/>
+ <imagedata fileref="images/jsf_support/jsf_support_32.png" scale="60"/>
</imageobject>
</mediaobject>
</figure>
-
- <para>You can also edit the properties of the selected element in
- the <property>Tree</property> mode with the help of the
- Properties view as shown below:</para>
+
+ <para>You can also edit the properties of the selected element in the
+ <property>Tree</property> mode with the help of the Properties view as shown below:</para>
<figure>
<title>Properties View </title>
<mediaobject>
<imageobject>
- <imagedata
- fileref="images/jsf_support/jsf_support_33.png"
- scale="75"/>
+ <imagedata fileref="images/jsf_support/jsf_support_33.png" scale="75"/>
</imageobject>
</mediaobject>
</figure>
</section>
+ </section>
+
+
</chapter>
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml 2008-03-28 13:08:29 UTC (rev 7181)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_support.xml 2008-03-28 14:08:41 UTC (rev 7182)
@@ -13,23 +13,16 @@
<title>JavaServer Faces Support</title>
- <para>JBoss Developer Studio is especially designed for supporting JSF and JSF-related
- technologies. JBDS provides extensible and exemplary tools for building JSF-based
- applications as well as adding JSF capabilities to existing web projects, importing
- JSF projects (created outside JBDS) and choosing any JSF implementation while
- developing JSF application.</para>
-
<para>With Developer Studio, we don't lock you into any one <property>JavaServer
- Faces</property> implementation. You can select the one which is necessary
- for you while <link linkend="new_jsf_project">creating a new JSF project</link> or
- <link linkend="add_jsf_capability">adding JSF capability</link> to any
- existing Eclipse project.</para>
+ Faces</property> implementation. You can always select the one which is
+ necessary for you while <link linkend="new_jsf_project">creating a new JSF
+ project</link> or <link linkend="add_jsf_capability">adding JSF capability</link> to
+ any existing Eclipse project.</para>
+ <para>At this point the spacial wizard will prompt you to specify a proper JSF environment.
+ It may be JSF 1.1.02 RI or JSF 1.2 which is integrates a number of new features and
+ changes. The wizard also lets you select JSF implementation with a component
+ orientation such as JSF 1.2 with Facelets or MyFaces 1.1.4.</para>
- <para>The spacial wizard will prompt you to specify a proper JSF environment. It may be
- JSF 1.1.02 RI or JSF 1.2 which is integrates a number of new features and
- changes. The wizard also lets you select JSF implementations with a component orientation such as JSF 1.2 with
- Facelets or MyFaces 1.1.4.</para>
-
<figure>
<title>Choosing JSF Environment</title>
<mediaobject>
@@ -39,8 +32,8 @@
</mediaobject>
</figure>
- <para>After specifying a proper JSF environment all the required libraries for the selected version will be added to
- your project.</para>
+ <para>After specifying a proper JSF environment all the required libraries for the selected
+ version will be added to your project.</para>
<!--
<section id="AddingSupportForTheOracleADFComponentsLibraryOrAnyOtherSupport64">
@@ -73,21 +66,22 @@
<section id="FaceletsSupport865">
<title>Facelets Support</title>
- <para>This section will perform you all concepts that JBDS involves to use the
- Facelets.</para>
+ <para>In this section we will focus more on all concepts that JBDS integrates for
+ working with Facelets.</para>
<para>The Facelets extends JavaServer Faces by providing a lightweight framework
that radically simplifies the design of presentation pages for JSF. JBoss
- Developer Studio provides support for Facelets in a variety of ways:</para>
+ Developer Studio provides support for Facelets in a variety of ways that we
+ will consider further in this section.</para>
+
<section>
<title>Facelets templates</title>
-
- <para>The New JSF Project wizard contains templates for creating Facelets
- projects based on version 1.2 of the JSF Reference Implementation.
- Select the <emphasis>
+ <para>If you want to build an application using Facelets, just create a
+ project with Facelets based on version 1.2 of the JSF Reference
+ Implementation, i. e. select the <emphasis>
<property>JSF 1.2 with Facelets</property>
- </emphasis> in JSF Environment section.</para>
-
+ </emphasis> in the JSF Environment section of the New JSF Project wizard.</para>
+
<figure>
<title>Choosing Facelets Environment</title>
<mediaobject>
@@ -98,10 +92,9 @@
</imageobject>
</mediaobject>
</figure>
-
- <para>Once you select the environment, you can specify the one of three
- available templates:</para>
-
+
+ <para>Once you've selected the
+ environment, it's possible to specify the one of three available templates:</para>
<figure>
<title>Choosing Facelets Template</title>
<mediaobject>
@@ -112,8 +105,7 @@
</imageobject>
</mediaobject>
</figure>
-
- <para>The following table lists possible Facelets templates for any JSF
+ <para>The following table lists possible templates with Facelets for any JSF
project and gives a proper description for each one.</para>
<table>
<title>Facelets Templates</title>
@@ -168,7 +160,7 @@
</entry>
<entry>
- <para>a sample application with
+ <para>A sample application with
Facelets that is ready to
run</para>
</entry>
@@ -184,7 +176,7 @@
</entry>
<entry>
- <para>a sample application without
+ <para>A sample application without
libraries</para>
</entry>
</row>
@@ -192,11 +184,11 @@
</tbody>
</tgroup>
</table>
-
</section>
<section>
<title>Facelets components</title>
+ <para>ss</para>
<para>The <link linkend="palette">JBoss Tools Palette</link> comes with the
Facelets components ready to use. A useful tip appears when you
hover the mouse cursor over the tag, the tip includes a detailed
@@ -222,7 +214,7 @@
</figure>
</section>
<section>
- <title>Code assist</title>
+ <title>Code assist for Facelets</title>
<para>Code assist (Ctrl + Space) for <property>Facelets tags</property> is
available when editing <emphasis>
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml 2008-03-28 13:08:29 UTC (rev 7181)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml 2008-03-28 14:08:41 UTC (rev 7182)
@@ -368,7 +368,7 @@
<para>Once the file have been created, it should be open in a
special <link
- linkend="GraphicalEditorAndViewingForJSFConfigurationFiles76331"
+ linkend="jsf_config_file"
>Faces Config Editor</link>.</para>
</section>
<section id="AddingYourOwnProjectTemplates853">
More information about the jbosstools-commits
mailing list