Author: ochikvina
Date: 2008-01-14 09:28:00 -0500 (Mon, 14 Jan 2008)
New Revision: 5663
Modified:
trunk/seam/docs/reference/en/modules/creating_new_seam.xml
Log:
http://jira.jboss.com/jira/browse/JBDS-234 - updating according to Svetlana Mukhina
remarks
Modified: trunk/seam/docs/reference/en/modules/creating_new_seam.xml
===================================================================
--- trunk/seam/docs/reference/en/modules/creating_new_seam.xml 2008-01-14 14:27:22 UTC
(rev 5662)
+++ trunk/seam/docs/reference/en/modules/creating_new_seam.xml 2008-01-14 14:28:00 UTC
(rev 5663)
@@ -11,8 +11,8 @@
<title>Creating a New Seam Project via the New Seam Project
wizard</title>
<para>In this chapter we provide you with the necessary steps to start working
with Seam
Framework.</para>
- <para>At first, we suggest setting the specific Seam perspective that provides
a necessary type
- of functionality. For that select <emphasis>
+ <para>At first, we suggest setting the specific Seam perspective that combines
a number of
+ different views and editors needed for work with resources concerned. For that
select <emphasis>
<property>Window > Open Perspective > Other >
Seam</property>
</emphasis> or you can also access it through the button in the right top
corner.</para>
@@ -31,14 +31,14 @@
experiment with it by creating variations.</para>
<para>Thus, you should select <emphasis>
<property>File > New > Seam Web Project</property>
- </emphasis> to run the <property>New Seam
Project</property> wizard. It's necessary to
- enter a name and a location directory for your new project. The next wizard
forms allow
- you to create runtime and server instances in order to get started creating,
running,
- and debugging J2EE applications.</para>
+ </emphasis> to run the <property>New Seam
Project</property> wizard. The wizard form
+ allows you to create runtime and server instances in order to get started
creating,
+ running, and debugging J2EE applications.</para>
<para>Seam Web Project wizard has an option for selecting the actual Server
(not just WTP
runtime) that will be used for the project. This allows the wizard to
identify correctly
where the required datasource and driver libraries need to go.</para>
- <para>Let's get through the wizard step-by-step. First, you should
type the name of your new project.</para>
+ <para>Let's get through the wizard step-by-step. First, you should
enter a name and
+ a location directory for your new project</para>
<figure>
<title>New Seam Project Wizard</title>
<mediaobject>
@@ -51,10 +51,10 @@
<para>Clicking on <emphasis>
<property>New...</property>
- </emphasis> button in the Target Runtime section brings us to another
dialog. Here, you
- can specify a new installed Runtime environment or the other type of runtime
appropriate
- for configuring your project. Let's create a JBoss 4.2 Runtime. For that
after choosing
- it click on <emphasis>
+ </emphasis> button in the Target Runtime section will bring you to
another dialog. Here,
+ you can specify a new installed Runtime environment or the other type of
runtime
+ appropriate for configuring your project. Let's create a JBoss 4.2
Runtime. For that
+ after choosing it click on <emphasis>
<property>Next</property>
</emphasis> button.</para>
@@ -144,17 +144,18 @@
</figure>
<para>The last section on this wizard step is
<property>Configurations</property>. You can
- select one of the pre-defined project configurations or create your own.
Having all needed options arranged click on
- <emphasis><property>Next</property></emphasis> to
pass on to the other wizard.</para>
+ select one of the pre-defined project configurations or create your own.
Having all
+ needed options arranged click on <emphasis>
+ <property>Next</property>
+ </emphasis> to pass on to the other wizard.</para>
</section>
<section id="projectFacets">
<title>Select the Project Facets</title>
- <para>This page of the wizard allows you to enable or disable specific
facets. You can save
- or delete your preset of selected facets clicking on <emphasis>
- <property>Save</property>
- </emphasis> button.</para>
+ <para>This page of the wizard allows you to enable or disable specific
facets that define
+ necessary characteristics for the project. The moment you switch to this
wizard form,
+ all critical facets are already checked for the chosen Dynamic Web
Project.</para>
<figure>
<title>Project Facets Selection</title>
@@ -165,6 +166,20 @@
</mediaobject>
</figure>
+ <para>Moreover, you can specify your own preset of selected facets by
checking needed ones
+ in project facets window and clicking on <emphasis>
+ <property>Save</property>
+ </emphasis> button.</para>
+
+ <figure>
+ <title>Specifying Custom Facet Preset</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/create_new_seam/create_seam8_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
<para>You can also see all available runtimes after clicking on
<emphasis>
<property>Show Runtimes</property>
</emphasis> or create new ones using the <emphasis>
@@ -175,21 +190,29 @@
<title>Project Facets Selection</title>
<mediaobject>
<imageobject>
- <imagedata
fileref="images/create_new_seam/create_seam8_1.png"/>
+ <imagedata
fileref="images/create_new_seam/create_seam8_2.png"/>
</imageobject>
</mediaobject>
</figure>
+ <para>Here, if more than one runtimes are checked, the <emphasis>
+ <property>Make Primary</property>
+ </emphasis> button won't be dimmed yet. So you can make use of
it to mark
+ primary runtime.</para>
<para><emphasis>
- <property>Next</property>
- </emphasis> button will bring you to the Web Module wizard.</para>
+ <property>Next</property>
+ </emphasis> button will bring you to the Web Module wizard
form.</para>
</section>
<section id="configureWebModule">
<title>How to Configure Web Module Settings</title>
- <para>A dynamic web application contains both web pages and Java code. The
wizard will ask
- you where you want to put those files. You can just leave the default
values.</para>
+ <para> As we deal with a dynamic web application we should first specify
the top level
+ directory of our application for deploying it to a server afterwards. You
know, this
+ kind of application contains both Web and Java code resources. Thus, it's
also important
+ to indicate the content directory as well as Java source directory. The
wizard will put
+ all those values itself. So you can leave everything as it is.</para>
+
<figure>
<title>Web Module Settings</title>
<mediaobject>
@@ -198,13 +221,16 @@
</imageobject>
</mediaobject>
</figure>
-
+ <para>Choose <emphasis>
+ <property>Next</property>
+ </emphasis> to switch to the next wizard form.</para>
</section>
-
+
<section id="addJSFCapab">
<title>Adding JSF Capabilities</title>
- <para>This wizard helps you to add JSF capabilities into your project.
</para>
+ <para>This wizard helps you to add JSF capabilities into your project for
representing
+ appropriate behaviours associated with JSF. </para>
<para>Checking <emphasis>
<property>Server Supplied JSF Implementation</property>
</emphasis> means that you will have a default JSF implementation given
by server.</para>
@@ -222,9 +248,11 @@
button. You are able to create a library of jars by clicking on
<emphasis>
<property>New</property>
</emphasis> button.</para>
- <para>Here, it's necessary to type a <property>Library
Name</property>, select a <property>Version
- Supported</property> and add proper <property>Library
jars</property>. Then click on
-
<emphasis><property>Finish</property>.</emphasis></para>
+ <para>Here, it's necessary to type a <property>Library
Name</property>, select a
+ <property>Version Supported</property> and add proper
<property>Library
+ jars</property>. Then click on <emphasis>
+ <property>Finish</property>
+ </emphasis> to complete the choice.</para>
<figure>
<title>Create JSF Implementation Library</title>
<mediaobject>
@@ -234,10 +262,13 @@
</mediaobject>
</figure>
- <para>You can also add a <property>Component
Libraries</property> (e.g. Richfaces) clicking
- on <emphasis>
+ <para>In the Component Libraries section of the wizard you can also add
<property>Component
+ Libraries</property> (e.g. Richfaces). Just click on
<emphasis>
<property>New</property>
- </emphasis> button in the Component Libraries section.</para>
+ </emphasis> button. Appeared dialog will ask you to type the Library
name, supported
+ version and add necessary jar's. Press <emphasis>
+ <property>Finish</property>
+ </emphasis> to complete the choice.</para>
<figure>
<title>Create JSF Implementation Library</title>
@@ -260,6 +291,9 @@
</imageobject>
</mediaobject>
</figure>
+
+ <para>Finally, as we are arranging the Seam Web project, the last step we
should do is to adjust project
+ configurations associated with Seam.</para>
</section>
<section id="seamFacet">
@@ -277,12 +311,12 @@
<itemizedlist>
<listitem>
- <para>Create Seam runtime and define Seam home folder. Click on
<emphasis>
- <property>Add</property>
- </emphasis> button in the
<property>General</property> section.</para>
+ <para>Create Seam runtime and define Seam home
folder.</para>
</listitem>
</itemizedlist>
- <para>Notice that in this wizard presented below you can create a Seam
runtime only for that
+ <para>For that click on <emphasis>
+ <property>Add</property>
+ </emphasis> button in the <property>General</property> section.
Notice that in this wizard presented below you can create a Seam runtime only for that
version which was selected in the <link
linkend="projectFacets">Project Facets</link>
wizard (version 1.2 in our case).</para>
@@ -314,7 +348,7 @@
</imageobject>
</mediaobject>
</figure>
-
+
<itemizedlist>
<listitem>
<para>and create a <emphasis>
@@ -326,6 +360,15 @@
</itemizedlist>
<figure>
+ <title>Connection Profile Options</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/create_new_seam/create_seam13_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <figure>
<title>Connection Profile Selecting</title>
<mediaobject>
<imageobject>
@@ -352,6 +395,7 @@
<para>Click on <emphasis>
<property>Finish</property>
</emphasis> to generate a project.</para>
-
+
+ <para></para>
</section>
</chapter>