10:23 a.m.
Author: ochikvina
Date: 2009-06-05 11:23:02 -0400 (Fri, 05 Jun 2009)
New Revision: 15745
Modified:
trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml
Log:
https://jira.jboss.org/jira/browse/JBDS-743 - updating the master_output.xml;
Modified: trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml
===================================================================
--- trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml 2009-06-05 15:22:39 UTC (rev
15744)
+++ trunk/jsf/docs/jsf_tools_ref_guide/en/master_output.xml 2009-06-05 15:23:02 UTC (rev
15745)
@@ -28,7 +28,16 @@
]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
<bookinfo>
<title>JSF Tools Reference Guide</title>
-
+ <corpauthor diffmk:change="added">
+ <inlinemediaobject diffmk:change="added">
+ <imageobject diffmk:change="added"
role="fo">
+ <imagedata diffmk:change="added"
fileref="images/jbosstools_logo.png"
format="PNG"></imagedata>
+ </imageobject>
+ <imageobject diffmk:change="added"
role="html">
+ <imagedata
diffmk:change="added"></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
<author><firstname>Anatoly</firstname><surname>Fedosik</surname></author>
<author><firstname>Olga</firstname><surname>Chikvina</surname></author>
<author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
@@ -40,7 +49,7 @@
<holder>JBoss, a division of Red Hat</holder>
</copyright>
<releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 3.0.1.GA
+ Version: 3.1.0.M1
</diffmk:wrapper></releaseinfo>
<abstract>
@@ -161,8 +170,8 @@
</section>
<section>
<title>Other relevant resources on the topic</title>
- <para><diffmk:wrapper diffmk:change="changed">All JBoss
Developer Studio/JBoss Tools release documentation you can find
at</diffmk:wrapper><ulink
url="http://docs.jboss.org/tools/"><diffmk:wrapper
diffmk:change="changed">http://docs.jboss.org/tools</diff...
diffmk:change="changed"> in the corresponding release
directory.</diffmk:wrapper></para>
- <para><diffmk:wrapper diffmk:change="changed">The latest
documentation builds are available at </diffmk:wrapper><ulink
url="http://download.jboss.org/jbosstools/nightly-docs/"><...
diffmk:change="changed">http://download.jboss.org/jbosstools...
+ <para><diffmk:wrapper diffmk:change="changed">All JBoss
Developer Studio/JBoss Tools release documentation you can find at
</diffmk:wrapper><ulink
url="http://docs.jboss.org/tools/">http://docs.jboss.org/too...
in the corresponding release directory.</para>
+ <para>The latest documentation builds are available at <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/">htt...
</section>
</chapter>
@@ -467,441 +476,404 @@
</chapter>
-<chapter id="projects"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml">
- <?dbhtml filename="projects.html"?>
- <chapterinfo>
- <keywordset>
- <keyword>JBoss Developer Studio</keyword>
- <keyword>Eclipse</keyword>
- <keyword>JSF Tools</keyword>
- <keyword>Java</keyword>
- <keyword>JBoss</keyword>
- </keywordset>
- </chapterinfo>
-
- <title>Projects</title>
- <para>To take an advantage of JSF firstly you should
perform one of the next
- steps:</para>
+<chapter diffmk:change="added" id="projects"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/projects.xml">
+ <?dbhtml filename="projects.html"?>
+ <chapterinfo diffmk:change="added">
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>Eclipse</keyword>
+ <keyword>JSF Tools</keyword>
+ <keyword>Java</keyword>
+ <keyword>JBoss</keyword>
+ </keywordset>
+ </chapterinfo>
- <itemizedlist>
- <listitem>
- <para>Create new JSF projects</para>
- </listitem>
- <listitem>
- <para>Import (open) existing JSF
projects</para>
- </listitem>
- <listitem>
- <para>Add JSF capability to any existing
Eclipse
- project</para>
- </listitem>
- <listitem>
- <para>Import and add JSF capability to any
existing project
- created outside Eclipse.</para>
- </listitem>
- </itemizedlist>
- <para>In this section we're going to stop on each of
them in
- detail.</para>
-
- <section id="new_jsf_project">
+ <title>Projects</title>
+ <para><diffmk:wrapper diffmk:change="changed">To take an
advantage of JSF firstly you should perform one of the next
steps:</diffmk:wrapper></para>
- <title>Creating a New JSF Project</title>
+ <itemizedlist>
+ <listitem>
+ <para>Create new JSF projects</para>
+ </listitem>
+ <listitem>
+ <para>Import (open) existing JSF projects</para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">Add JSF capability to any existing Eclipse
project</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">Import and add JSF capability to any existing project
created outside
+ Eclipse.</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+ <para><diffmk:wrapper diffmk:change="changed">In this
section we're going to stop on each of them in
detail.</diffmk:wrapper></para>
- <para>If you want your project to already contain
all JSF
- libraries, tag libraries and JSF configuration
file, just
- organize a new brand JSF project. It is possible
to do this easily with the
- help of the special wizard. To get it,
select<emphasis>
- <property
moreinfo="none"> File > New > Project
- > JBoos Tools Web > JSF
- > JSF Project</property>
- </emphasis> and click <emphasis>
- <property
moreinfo="none">Next</property>.</emphasis></para>
+ <section id="new_jsf_project">
- <figure float="0">
- <title>Choosing a JSF
Project</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_10.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ <title>Creating a New JSF Project</title>
- <para>On the next form you'll be prompted to
enter
- <property
moreinfo="none">Project Name</property> and select a
- location for the project or just leave a default
path.</para>
- <para>Here, JSF Version also allows you to select
which JSF
- implementation to use.</para>
- <figure float="0">
- <title>Creating a New JSF
Project</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_11.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ <para><diffmk:wrapper diffmk:change="changed">If
you want your project to already contain all JSF libraries, tag libraries
+ and JSF configuration file, just organize a new brand JSF
project. It is
+ possible to do this easily with the help of the special wizard.
To get it, select</diffmk:wrapper><emphasis>
+ <property
moreinfo="none"><diffmk:wrapper diffmk:change="changed"> File
> New > Project > JBoos Tools
+ Web > JSF > JSF
Project</diffmk:wrapper></property>
+ </emphasis> and click <emphasis>
+ <property
moreinfo="none">Next</property>.</emphasis></para>
- <para>There is a number of predefined project
templates that are flexible and
- easily customizable. Thus you can pick a
different template
- on which the projects Importing Existing should
be based on. Almost all
- templates come in two variations: with jsf
libraries and
- without ones.</para>
- <figure float="0">
- <title>Choosing JSF
Templates</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_12.png "></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure float="0">
+ <title>Choosing a JSF Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_10.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>The table below provides description for each
possible JSF
- template.</para>
- <table>
- <title>JSF Project Templates</title>
- <tgroup cols="2">
- <colspec align="left"
colnum="1" colwidth="1*"></colspec>
- <colspec colnum="2"
colwidth="3*"></colspec>
+ <para><diffmk:wrapper diffmk:change="changed">On
the next form you'll be prompted to enter </diffmk:wrapper><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Project
+
Name</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed"> and select a location for the project or just leave
+ a default path.</diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="changed">Here,
JSF Version also allows you to select which JSF implementation to
+ use.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Creating a New JSF Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_11.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para><diffmk:wrapper diffmk:change="changed">There
is a number of predefined project templates that are flexible and easily
+ customizable. Thus you can pick a different template on which the
projects
+ Importing Existing should be based on. Almost all templates come
in two
+ variations: with jsf libraries and without
ones.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Choosing JSF Templates</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_12.png "></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <thead>
- <row>
- <entry align="center">
+ <para><diffmk:wrapper diffmk:change="changed">The
table below provides description for each possible JSF
template.</diffmk:wrapper></para>
+ <table>
+ <title>JSF Project Templates</title>
+ <tgroup cols="2">
+ <colspec align="left" colnum="1"
colwidth="1*"></colspec>
+ <colspec colnum="2"
colwidth="3*"></colspec>
+
+
+ <thead>
+ <row>
+ <entry align="center">
<para>Template</para>
- </entry>
+ </entry>
- <entry align="center">
+ <entry align="center">
<para>Description</para>
- </entry>
- </row>
- </thead>
+ </entry>
+ </row>
+ </thead>
- <tbody>
+ <tbody>
- <row>
- <entry>
+ <row>
+ <entry>
<para>
<emphasis>
<property
moreinfo="none">JSFBlankWithLibs</property>
</emphasis>
</para>
- </entry>
+ </entry>
- <entry>
- <para>This template will
- create a standard
- Web project
- structure with all
- JSF
- capabilities</para>
- </entry>
- </row>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">This template will create a standard Web
+ project structure with all JSF
capabilities</diffmk:wrapper></para>
+ </entry>
+ </row>
- <row>
- <entry>
+ <row>
+ <entry>
<para>
<emphasis>
<property
moreinfo="none">JSFKickStartWithLibs</property>
</emphasis>
</para>
- </entry>
+ </entry>
- <entry>
- <para>This template will
- create a standard
- Web project
- structure but will
- also include a
- sample application
- that is ready to
- run</para>
- </entry>
- </row>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">This template will create a standard Web
+ project structure but will also include
a sample
+ application that is ready to
run</diffmk:wrapper></para>
+ </entry>
+ </row>
- <row>
- <entry>
+ <row>
+ <entry>
<para>
<emphasis>
<property
moreinfo="none">JSFKickStartWithoutLibs</property>
</emphasis>
</para>
- </entry>
+ </entry>
- <entry>
- <para>Some servers already
- provide jsf libs and
- you take risk of
- getting conflicting
- libraries while
- deploying your
- project. To avoid
- such conflicts, use
- a template without
- libs if you have a
- server with its own
- jsf libraries</para>
- </entry>
- </row>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">Some servers already provide jsf libs and
+ you take risk of getting conflicting
libraries
+ while deploying your project. To avoid
such
+ conflicts, use a template without libs
if you have
+ a server with its own jsf
libraries</diffmk:wrapper></para>
+ </entry>
+ </row>
- </tbody>
- </tgroup>
- </table>
+ </tbody>
+ </tgroup>
+ </table>
- <!-- <para>You can of course
create your own custom templates. More information
- on templates creation could be found in <link
-
linkend="CreatingCustomJSPTemplates">Chapter 5</link>.</para>
- -->
+
- <para>On the next screen select what
<emphasis>
- <property
moreinfo="none">Servlet version</property>
- </emphasis> to use and whether to register
this application
- with JBoss AS (or other server) for running and
testing your application.</para>
+ <para>On the next screen select what <emphasis>
+ <property moreinfo="none">Servlet
version</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> to use and whether to register this application with
JBoss AS
+ (or other server) for running and testing your
application.</diffmk:wrapper></para>
- <para>The <emphasis>
- <property
moreinfo="none">Context Path</property>
- </emphasis> is the name under which the
application will be
- deployed.</para>
+ <para>The <emphasis>
+ <property moreinfo="none">Context
Path</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> is the name under which the application will be
deployed.</diffmk:wrapper></para>
- <para>The <emphasis>
- <property
moreinfo="none">Runtime</property>
- </emphasis> value tells Eclipse where to
find Web libraries
- in order to build (compile) the project. It is
not possible
- to finish project creation without selecting
Runtime. If you
- don't have any values, select
<emphasis>
- <property
moreinfo="none">New...</property>
- </emphasis> to add new
Runtime.</para>
+ <para>The <emphasis>
+ <property
moreinfo="none">Runtime</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> value tells Eclipse where to find Web libraries in
order to
+ build (compile) the project. It is not possible to finish project
creation
+ without selecting Runtime. If you don't have any values,
select </diffmk:wrapper><emphasis>
+ <property
moreinfo="none">New...</property>
+ </emphasis> to add new Runtime.</para>
- <para>The <emphasis>
- <property
moreinfo="none">Target Server</property>
- </emphasis> allows you specifying whether
to deploy the
- application. The Target Server corresponds to the
Runtime
- value selected above. If you don't want to
deploy
- the application, uncheck this
value.</para>
- <figure float="0">
- <title>Registering the Project on
Server</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_14.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ <para>The <emphasis>
+ <property moreinfo="none">Target
Server</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> allows you specifying whether to deploy the
application. The
+ Target Server corresponds to the Runtime value selected above. If
you
+ don't want to deploy the application, uncheck this
value.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Registering the Project on Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_14.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>When you are all done, you should have the
project that has
- been appeared in the Package Explorer
view:</para>
- <figure float="0">
- <title>A New Project in the Package
Explorer</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_15.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ <para><diffmk:wrapper diffmk:change="changed">When
you are all done, you should have the project that has been appeared in
+ the Package Explorer view:</diffmk:wrapper></para>
+ <figure float="0">
+ <title>A New Project in the Package Explorer</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_15.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>At this point you can open <emphasis>
- <property
moreinfo="none">faces-config.xml</property>
- </emphasis> and start working on your
application.
- There are a lot of features
- to develop JSF applications. We will describe the
features
- further.</para>
- </section>
+ <para>At this point you can open <emphasis>
+ <property
moreinfo="none">faces-config.xml</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> and start working on your application. There are a
lot of
+ features to develop JSF applications. We will describe the
features
+ further.</diffmk:wrapper></para>
+ </section>
- <section
id="ImportingExsJSFProjWithAnyStr74447">
+ <section id="ImportingExsJSFProjWithAnyStr74447">
- <title>Importing Existing JSF Projects with Any
Structure</title>
+ <title>Importing Existing JSF Projects with Any
Structure</title>
- <para>For detailed information on migration of JSF
projects into a workspace see <ulink
url="../../Exadel-migration/html_single/index.html#jsf_struts">Migration
Guide</ulink>.</para>
+ <para><diffmk:wrapper diffmk:change="changed">For
detailed information on migration of JSF projects into a workspace see
+ </diffmk:wrapper><ulink
url="../../Exadel-migration/html_single/index.html#jsf_struts"><diffmk:wrapper
diffmk:change="changed">Migration
+ Guide</diffmk:wrapper></ulink>.</para>
- </section>
- <section id="add_jsf_capability">
+ </section>
+ <section id="add_jsf_capability">
- <title>Adding JSF Capability to Any Existing
Eclipse Project</title>
+ <title>Adding JSF Capability to Any Existing Eclipse
Project</title>
- <para>It's also possible to add <property
moreinfo="none">JSF capability</property>
- (JSF libraries, tag libraries) to any existing
Eclipse
- project in your workspace. After that you'll
be
- able to make use of such editors as JSF
configuration editor, JBoss
- Tools JSP editor and any others.</para>
- <para>Right click the project and select
<emphasis>
- <property
moreinfo="none">JBoss Tools > Add JSF
- Capabilities</property>.
</emphasis> This will start
- the process of adding all necessary libraries,
files to make
- this a Web JSF project.</para>
- <figure float="0">
- <title>Adding JSF
Capabilities</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_16.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>The wizard will first ask you to show the
<emphasis>
- <property
moreinfo="none">web.xml</property>
- </emphasis> file location and the project
name.</para>
- <figure float="0">
- <title>Project Location</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_17.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>On the last form you can set the different
folders for your
- project as well as register this application with
a servlet
- container.</para>
+ <para>It's also possible to add <property
moreinfo="none">JSF capability</property><diffmk:wrapper
diffmk:change="changed"> (JSF
+ libraries, tag libraries) to any existing Eclipse project in your
workspace.
+ After that you'll be able to make use of such editors as JSF
+ configuration editor, JBoss Tools JSP editor and any
others.</diffmk:wrapper></para>
+ <para>Right click the project and select <emphasis>
+ <property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
Tools > Add JSF Capabilities</diffmk:wrapper></property>.
</emphasis><diffmk:wrapper diffmk:change="changed">
+ This will start the process of adding all necessary libraries,
files to make
+ this a Web JSF project.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Adding JSF Capabilities</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_16.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The wizard will first ask you to show the <emphasis>
+ <property
moreinfo="none">web.xml</property>
+ </emphasis> file location and the project
name.</para>
+ <figure float="0">
+ <title>Project Location</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_17.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para><diffmk:wrapper diffmk:change="changed">On
the last form you can set the different folders for your project as well as
+ register this application with a servlet
container.</diffmk:wrapper></para>
- <para>Make sure to select <emphasis>
- <property
moreinfo="none">Add Libraries</property>
- </emphasis> to add all required JSF related
libraries to this project.</para>
+ <para>Make sure to select <emphasis>
+ <property moreinfo="none">Add
Libraries</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> to add all required JSF related libraries to this
+ project.</diffmk:wrapper></para>
- <para>The <emphasis>
- <property
moreinfo="none">Context Path</property>
- </emphasis> is the name under which the
application will be
- deployed.</para>
+ <para>The <emphasis>
+ <property moreinfo="none">Context
Path</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> is the name under which the application will be
deployed.</diffmk:wrapper></para>
- <para>The <emphasis>
- <property
moreinfo="none">Runtime</property>
- </emphasis> value tells Eclipse where to
find Web libraries
- in order to build (compile) the project. It is
not possible
- to finish project import without selecting
Runtime. If you
- don't have any values, select
<emphasis>
- <property
moreinfo="none">New...</property>
- </emphasis> to add new
Runtime.</para>
+ <para>The <emphasis>
+ <property
moreinfo="none">Runtime</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> value tells Eclipse where to find Web libraries in
order to
+ build (compile) the project. It is not possible to finish project
import
+ without selecting Runtime. If you don't have any values,
select </diffmk:wrapper><emphasis>
+ <property
moreinfo="none">New...</property>
+ </emphasis> to add new Runtime.</para>
- <para>The <emphasis>
- <property
moreinfo="none">Target Server</property>
- </emphasis> allows you to specify whether
to deploy the
- application. The Target Server corresponds to the
Runtime
- value selected above. If you don't want to
deploy
- the application, uncheck this
value.</para>
- <figure float="0">
- <title>Project Folders</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_18.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <para>Once your project is imported you can see
that JSF related
- libraries have been added to your project:
<emphasis>
- <property
moreinfo="none">jsf-api.jar</property>
- </emphasis> and <emphasis>
- <property
moreinfo="none">jsf-impl.jar</property>
- </emphasis>.</para>
- <note>
- <title>Note:</title>
- <para>Some application servers provide
their own jsf
- implementation libraries. Thus, to avoid
conflicts you
- should not add jsf libraries while adding
jsf
- capabilities.</para>
- </note>
- <para>You are now ready to work with JSF by
creating a new JSF
- configuration file:</para>
+ <para>The <emphasis>
+ <property moreinfo="none">Target
Server</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> allows you to specify whether to deploy the
application. The
+ Target Server corresponds to the Runtime value selected above. If
you
+ don't want to deploy the application, uncheck this
value.</diffmk:wrapper></para>
+ <figure float="0">
+ <title>Project Folders</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_18.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para><diffmk:wrapper diffmk:change="changed">Once
your project is imported you can see that JSF related libraries have been
+ added to your project: </diffmk:wrapper><emphasis>
+ <property
moreinfo="none">jsf-api.jar</property>
+ </emphasis> and <emphasis>
+ <property
moreinfo="none">jsf-impl.jar</property>
+ </emphasis>.</para>
+ <note>
+ <title>Note:</title>
+ <para><diffmk:wrapper
diffmk:change="changed">Some application servers provide their own jsf
implementation
+ libraries. Thus, to avoid conflicts you should not add
jsf libraries
+ while adding jsf
capabilities.</diffmk:wrapper></para>
+ </note>
+ <para><diffmk:wrapper diffmk:change="changed">You
are now ready to work with JSF by creating a new JSF configuration
+ file:</diffmk:wrapper></para>
- <figure float="0">
- <title>Creating a New JSF Configuration
File</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_19.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ <figure float="0">
+ <title>Creating a New JSF Configuration File</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_19.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <para>Once the file has been created, it should be
opened in a
- special <link
linkend="jsf_config_file">Faces Config Editor</link>.</para>
- </section>
- <section id="AddingYourOwnProjectTemplates853">
+ <para><diffmk:wrapper diffmk:change="changed">Once
the file has been created, it should be opened in a special
</diffmk:wrapper><link linkend="jsf_config_file">Faces Config
Editor</link>.</para>
+ </section>
+ <section id="AddingYourOwnProjectTemplates853">
- <title>Adding Your Own Project
Templates</title>
- <para>Template is a set of files that is served as
a basis to facilitate
- the creation of a new project. Project templates
provide
- content and structure for a
project.</para>
- <para>There is a powerful
- templating capability for creating new and
importing
- existing Struts and JSF projects. This templating
facility
- has a variety of aspects to consider. But,
let's
- start with the most straightforward case and
consider the
- process of creating a template from your existing
JSF
- project.</para>
+ <title>Adding Your Own Project Templates</title>
+ <para><diffmk:wrapper
diffmk:change="changed">Template is a set of files that is served as a basis
to facilitate the
+ creation of a new project. Project templates provide content and
structure
+ for a project.</diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="changed">There
is a powerful templating capability for creating new and importing
+ existing Struts and JSF projects. This templating facility has a
variety of
+ aspects to consider. But, let's start with the most
straightforward
+ case and consider the process of creating a template from your
existing JSF
+ project.</diffmk:wrapper></para>
- <para>Let's say you have a project that you
want to use as
- the basis for a new <property
moreinfo="none">template</property>. Follow
- these steps to make a template out of
it:</para>
- <itemizedlist>
- <listitem>
- <para>In the Web Projects view,
right-click the
- project and select <emphasis>
- <property
moreinfo="none">JBoss Tools JSF > Save As
+ <para><diffmk:wrapper
diffmk:change="changed">Let's say you have a project that you want to use
as the basis for a
+ new </diffmk:wrapper><property
moreinfo="none">template</property><diffmk:wrapper
diffmk:change="changed">. Follow these steps to make a template out
+ of it:</diffmk:wrapper></para>
+ <itemizedlist>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">In the Web Projects view, right-click the project and
select </diffmk:wrapper><emphasis>
+ <property
moreinfo="none">JBoss Tools JSF > Save As
Template</property>
- </emphasis></para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Saving Your Project as
Template</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_20.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>In the first dialog box, you
can choose a name
- for the template (defaults to the
project
- name) and confirm what run-time
- implementation of the project
- technology will be used</para>
- </listitem>
+ </emphasis></para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Saving Your Project as Template</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_20.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">In the first dialog box, you can choose a name for
the
+ template (defaults to the project name) and
confirm what
+ run-time implementation of the project technology
will be
+ used</diffmk:wrapper></para>
+ </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Define Template
Properties</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_20_1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
+ </itemizedlist>
+ <figure float="0">
+ <title>Define Template Properties</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_20_1.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
- <itemizedlist>
- <listitem>
- <para>Select <emphasis>
- <property
moreinfo="none">Next</property>
- </emphasis> and you will be sent
to a dialog
- box with your project structure
displayed
- with check boxes. Here you can check
only
- those parts and files in your project
- directory that should be part of the
- template</para>
- </listitem>
- </itemizedlist>
- <figure float="0">
- <title>Define Template
Properties</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_support/jsf_support_20_2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- <itemizedlist>
- <listitem>
- <para>At this point, unless you
want to designate
- some extra files as having Velocity
template
- coding inside them, you should click
<emphasis>
- <property
moreinfo="none">Finish</property>
- </emphasis>.</para>
- </listitem>
- </itemizedlist>
- <para>That's it. Now, you can use this template
with any
- new or imported project that uses the same
run-time
- implementation as the project you turned into a
- template.</para>
- <para>At this point, you have a fully configured
project and now you can
- bring some new logic to it starting from JSF
configuration
- file.</para>
- </section>
+ <itemizedlist>
+ <listitem>
+ <para>Select <emphasis>
+ <property
moreinfo="none">Next</property>
+ </emphasis><diffmk:wrapper
diffmk:change="changed"> and you will be sent to a dialog box with your
+ project structure displayed with check boxes.
Here you can
+ check only those parts and files in your project
directory
+ that should be part of the
template</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+ <figure float="0">
+ <title>Define Template Properties</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_support/jsf_support_20_2.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <itemizedlist>
+ <listitem>
+ <para><diffmk:wrapper
diffmk:change="changed">At this point, unless you want to designate some
extra files
+ as having Velocity template coding inside them,
you should
+ click </diffmk:wrapper><emphasis>
+ <property
moreinfo="none">Finish</property>
+ </emphasis>.</para>
+ </listitem>
+ </itemizedlist>
+ <para><diffmk:wrapper
diffmk:change="changed">That's it. Now, you can use this template with
any new or imported
+ project that uses the same run-time implementation as the project
you turned
+ into a template.</diffmk:wrapper></para>
+ <para><diffmk:wrapper diffmk:change="changed">At
this point, you have a fully configured project and now you can bring some
+ new logic to it starting from JSF configuration
file.</diffmk:wrapper></para>
+ </section>
+ <section diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Relevant Resources
Links</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">You can find more in-depth explanation on how to work
with special wizards, editors and views that can
+ be used in various scenarios while developing JSF applications in
our </diffmk:wrapper><ulink diffmk:change="added"
url="../../jsf/html_single/index.html"><diffmk:wrapper
diffmk:change="added">Visual Web Tools
guide</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+ </section>
+
</chapter>
-
<chapter id="jsf_config_file" role="updated"
xml:base="file:///home/ochikvina/WORK/for_compare/trunk/jsf/docs/jsf_tools_ref_guide/en/modules/jsf_config_file.xml">
<?dbhtml filename="jsf_config_file.html"?>
<chapterinfo>
@@ -1980,8 +1952,7 @@
reference introduces you to wizards for creating and importing JSF projects, JSF
Configuration File editor features, functionality for enabling JSF capabilities
and etc.</para>
- <para>If you have questions or good suggestions, please refer to <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
+ <para>If you have questions or good suggestions, please refer to <ulink
url="http://www.jboss.com/index.html?module=bb'op=viewforum...
Tools Forum</ulink>.</para>
</chapter>
-
</book>