myfaces-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r897537 - in /websites/staging/myfaces/trunk/content: ./ wiki/core/user-guide/getting-started/myfaces-archetypes-for-maven.html
Date Wed, 12 Feb 2014 03:11:45 GMT
Author: buildbot
Date: Wed Feb 12 03:11:44 2014
New Revision: 897537

Log:
Staging update by buildbot for myfaces

Modified:
    websites/staging/myfaces/trunk/content/   (props changed)
    websites/staging/myfaces/trunk/content/wiki/core/user-guide/getting-started/myfaces-archetypes-for-maven.html

Propchange: websites/staging/myfaces/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Feb 12 03:11:44 2014
@@ -1 +1 @@
-1567506
+1567508

Modified: websites/staging/myfaces/trunk/content/wiki/core/user-guide/getting-started/myfaces-archetypes-for-maven.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/user-guide/getting-started/myfaces-archetypes-for-maven.html
(original)
+++ websites/staging/myfaces/trunk/content/wiki/core/user-guide/getting-started/myfaces-archetypes-for-maven.html
Wed Feb 12 03:11:44 2014
@@ -267,53 +267,114 @@ archetypes</a> to get you started on a M
 table below lists the available archetypes and which MyFaces libraries are
 used for any given archetype.</p>
 
-<p /><p><ac:macro
-ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA[{table-plus:columnAttributes=align=left,align=left,align=center,align=center,align=center,align=left}
-<table>
-<tr><th> Archetype name      </th><th>  Description of the created
project </th><th> JSF
-version </th><th> View technology </th><th>  </th><th>Component
set</th></tr>
-<tr><th>                 </th><th>                  </th><th>
     
-       </th><th> JSP </th><th> Facelets </th><th>  </th></tr>
-<tr><td> [HelloWorld 2.0 Basic](#the-myfaces-hello-world-archetypes.html)
-    </td><td> Webapp project that uses MyFaces Core 2.0.x with Facelets as the
-page templating system. </td><td> 2.0 </td><td>   </td><td>
• </td><td> none        </td></tr>
-<tr><td> [HelloWorld 2.0 OpenWebBeans](#the-myfaces-hello-world-archetypes.html)
- </td><td> Webapp project that uses MyFaces Core 2.0.x with Facelets as the page
-templating system. Uses JSR-299/JSR-330 annotations for managed bean
-definition with Apache OpenWebBeans as the CDI implementation.         
-        </td><td> 2.0 </td><td>   </td><td> • </td><td>
none        </td></tr>
-<tr><td> [HelloWorld Basic](#the-myfaces-hello-world-archetypes.html)
+<table border="0" class="bodyTable">
+    <tr>
+        <th> Archetype name </th>
+        <th> Description of the created project </th>
+        <th> JSF version </th>
+        <th> View technology </th>
+        <th>  </th>
+        <th>Component set</th>
+    </tr>
+    <tr><th>                 </th>
+        <th>                    </th>
+        <th>                  </th>
+        <th> JSP </th>
+        <th> Facelets </th>
+        <th>  </th>
+    </tr>
+    <tr>
+        <td> [HelloWorld 2.0 Basic](#the-myfaces-hello-world-archetypes.html)</td>
+        <td> Webapp project that uses MyFaces Core 2.0.x with Facelets as the 
+            page templating system. </td>
+        <td> 2.0 </td>
+        <td>   </td>
+        <td> • </td>
+        <td> none       </td>
+    </tr>
+    <tr><td> [HelloWorld 2.0 OpenWebBeans](#the-myfaces-hello-world-archetypes.html)
+        </td><td> Webapp project that uses MyFaces Core 2.0.x with Facelets as
the page
+            templating system. Uses JSR-299/JSR-330 annotations for managed bean
+            definition with Apache OpenWebBeans as the CDI implementation.         
+        </td>
+        <td> 2.0 </td>
+        <td>   </td>
+        <td> • </td>
+        <td> none       </td>
+    </tr>
+    <tr><td> [HelloWorld Basic](#the-myfaces-hello-world-archetypes.html)
         </td><td> Webapp project that uses MyFaces Core 1.2.x with JSP as the
-page templating system.      </td><td> 1.2 </td><td> • </td><td>
  </td><td> Tomahawk  </td></tr>
-<tr><td> [HelloWorld-Facelets](#the-myfaces-hello-world-archetypes.html)
-     </td><td> Webapp project that uses MyFaces Core 1.2.x with Facelets as the
-page templating system. </td><td> 1.2 </td><td>   </td><td>
• </td><td> Tomahawk  </td></tr>
-<tr><td> [HelloWorld-Portlet](#the-myfaces-hello-world-archetypes.html)
-      </td><td> Simple portlet-enabled webapp.                 
-             </td><td> 1.2 </td><td> • </td><td>
    </td><td> none      </td></tr>
-<tr><td> Trinidad             </td><td> Webapp that uses MyFaces
Core 1.2.x and
-MyFaces Trinidad.                </td><td> 1.2 </td><td> • </td><td>
    </td><td> Trinidad
-1.2 </td></tr>
-<tr><td> Trinidad 2.0 Archetype      </td><td> Webapp that uses MyFaces
Core 2.0.x and
-MyFaces Trinidad 2.0.                </td><td> 2.0 </td><td> •
</td><td>     </td><td> Trinidad
-2.0 </td></tr>
-<tr><td> [JSF-Component Library](#the-jsf-components-library-archetype.html)
-       </td><td> Project that is intended to define new JSF components (rather
than
-just use them). If you want to create a jar that defines a set of new
-custom JSF components then this archetype is a good starting point.    
-            </td><td> 1.2 </td><td> • </td><td>
</td><td> N/A         </td></tr>
-<tr><td> [JSF-Component Library](#the-jsf-components-library-archetype.html)
- myfaces-archetype-jsfcomponents20     </td><td> Project that is intended to
define
-new JSF components (rather than just use them). If you want to create a jar
-that defines a set of new custom JSF components then this archetype is a
-good starting point.                     </td><td> 2.0 </td><td>
  </td><td> • </td><td> N/A 
-       </td></tr>
-<tr><td> myfaces-archetype-codi-jsf20 </td><td> Hello World Archetype
using MyFaces CODI </td><td>
-2.0 </td><td>   </td><td> • </td><td> none </td></tr>
-<tr><td> myfaces-archetype-codi-jsf12 </td><td> Hello World Archetype
using MyFaces CODI </td><td>
-1.2 </td><td>   </td><td> • </td><td> none </td></tr>
-{table-plus}]
-]></ac:plain-text-body></ac:macro></p><p />
+            page templating system.      </td>
+        <td> 1.2 </td>
+        <td> • </td>
+        <td>   </td>
+        <td> Tomahawk  </td>
+    </tr>
+    <tr><td> [HelloWorld-Facelets](#the-myfaces-hello-world-archetypes.html)
+        </td><td> Webapp project that uses MyFaces Core 1.2.x with Facelets as
the
+            page templating system. </td>
+        <td> 1.2 </td>
+        <td>   </td>
+        <td> • </td>
+        <td> Tomahawk  </td>
+    </tr>
+    <tr><td> [HelloWorld-Portlet](#the-myfaces-hello-world-archetypes.html)
+        </td><td> Simple portlet-enabled webapp.                   
+        </td>
+        <td> 1.2 </td>
+        <td> • </td>
+        <td>     </td>
+        <td> none      </td>
+    </tr>
+    <tr><td> Trinidad             </td><td> Webapp that uses MyFaces
Core 1.2.x and
+            MyFaces Trinidad.                </td>
+        <td> 1.2 </td>
+        <td> • </td>
+        <td>     </td>
+        <td> Trinidad 1.2 </td>
+    </tr>
+    <tr><td> Trinidad 2.0 Archetype      </td><td> Webapp that uses
MyFaces Core 2.0.x and
+            MyFaces Trinidad 2.0.                </td>
+        <td> 2.0 </td>
+        <td> • </td>
+        <td>     </td>
+        <td> Trinidad 2.0 </td>
+    </tr>
+    <tr><td> [JSF-Component Library](#the-jsf-components-library-archetype.html)
+        </td><td> Project that is intended to define new JSF components (rather
than
+            just use them). If you want to create a jar that defines a set of new
+            custom JSF components then this archetype is a good starting point.    
+        </td>
+        <td> 1.2 </td>
+        <td> • </td>
+        <td>    </td>
+        <td> N/A          </td>
+    </tr>
+    <tr><td> [JSF-Component Library](#the-jsf-components-library-archetype.html)
+            myfaces-archetype-jsfcomponents20     </td><td> Project that is intended
to define
+            new JSF components (rather than just use them). If you want to create a jar
+            that defines a set of new custom JSF components then this archetype is a
+            good starting point.                     </td>
+        <td> 2.0 </td>
+        <td>   </td>
+        <td> • </td>
+        <td> N/A </td>
+    </tr>
+    <tr><td> myfaces-archetype-codi-jsf20 </td>
+        <td> Hello World Archetype using MyFaces CODI </td>
+        <td> 2.0 </td>
+        <td>    </td>
+        <td> • </td>
+        <td> none </td>
+    </tr>
+    <tr>
+        <td> myfaces-archetype-codi-jsf12 </td>
+        <td> Hello World Archetype using MyFaces CODI </td>
+        <td> 1.2 </td>
+        <td>    </td>
+        <td> • </td>
+        <td> none </td>
+    </tr>
 </table>
 
 <p>Each project that is created based on one of these archetypes comes with
@@ -322,37 +383,36 @@ preconfigured, so you don't need a separ
 Application Server to deploy the app to.</p>
 
 <h3>Getting started </h3>
+
 <p>To get started with a new project using one of the provided archetypes,
 we have to make sure <a href="http://maven.apache.org/">Maven</a> is
 installed on your system. Once Maven is installed, we can just type </p>
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 mvn archetype:generate -DarchetypeCatalog=http://myfaces.apache.org
 ]
-]></ac:plain-text-body></ac:macro>
+]&gt;</ac:plain-text-body></ac:macro>
 <p>at a command line. Maven will present us a numbered list of the
 available archetypes. (This should resemble the list presented above.)
 After choosing a number and pressing Enter, Maven asks us for a group ID,
 artifact ID, version, and package. These are the default values used to
 create the project. After we confirm these settings, Maven creates the new,
-empty project for us.</p>
-
-
+empty project for us.</p></p>
 <h3>The MyFaces Hello World Archetypes</h3>
 
 <p>This archetypes allows you to generate a template for a web application
 that uses MyFaces, based on the blank example application. So, creating the
 template of the application is as easy as executing:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 mvn archetype:generate -DarchetypeCatalog=http://myfaces.apache.org
 ]
-]></ac:plain-text-body></ac:macro>
+]&gt;</ac:plain-text-body></ac:macro>
 <p>A list of available archetypes is show. Just select one of the 'Hello
 world' options. Answer the questions that follow to set the properties and
 you're all set! There are different 'Hello World' archetypes, see the
 <ac:link ac:anchor="MyFaces Maven archetypes"><ac:link-body>table
-above</ac:link-body></ac:link> for details.</p>
-
+above</ac:link-body></ac:link> for details.</p></p>
 <p>That's all. The goal <code>archetype:create</code> downloads the proper
 artifacts from the main maven repo and creates the test project. Now you
 can start to work immediately.</p>
@@ -363,28 +423,26 @@ can start to work immediately.</p>
 should do is to checkout the myfaces archetype source from the svn, using
 the command:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 svn co
 http://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/trunk/maven2-archetypes
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>Now, let's install the plugin locally (this supposes that you have maven
 2.x already installed). Navigate to the plugin root folder and use the
 <code>mvn install</code> command. For example:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 cd myfaces-archetype-helloworld
 mvn install
 ]
-]></ac:plain-text-body></ac:macro>
+]&gt;</ac:plain-text-body></ac:macro>
 <ac:macro ac:name="info"><ac:parameter ac:name="title">Other
 archetypes</ac:parameter><ac:rich-text-body>
 <p>If you want to install any of the other archetypes locally, just replace
 <code>myfaces-archetype-helloworld</code> in the above command with the
 appropriate id for the archetype you want to
-install.</p></ac:rich-text-body></ac:macro>
-
+install.</p></ac:rich-text-body></ac:macro></p>
 <p>At this point, you have the plugin installed in your local system. You
 don't have to install it again unless you want to update it.</p>
 
@@ -400,12 +458,11 @@ like.)</p>
 <p>If we want to test the basic application created, we can just run the
 command:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 cd testApp
 mvn package
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>And we will have a war-file created at testApp/target folder!</p>
 
 <p>This whole process can save a lot of time while setting up a new web
@@ -422,57 +479,54 @@ simple edit the <code>pom.xml</code> fil
 <p>E.g. to setup a MyFaces 1.1.x project we have to change the MyFaces
 version numbers within the generated <code>pom.xml</code>. Example for
 version 1.1.5:</p>
-<ac:macro
-ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body>&lt;![CDATA[
     <dependency>
     <groupId>org.apache.myfaces.core</groupId>
     <artifactId>myfaces-api</artifactId>
     <version>1.1.5</version>
     <scope>compile</scope>
-    </dependency>
+    </dependency></p>
+<div class="codehilite"><pre><span class="nt">&lt;dependency&gt;</span>
+<span class="nt">&lt;groupId&gt;</span>org.apache.myfaces.core<span
class="nt">&lt;/groupId&gt;</span>
+<span class="nt">&lt;artifactId&gt;</span>myfaces-impl<span class="nt">&lt;/artifactId&gt;</span>
+<span class="nt">&lt;version&gt;</span>1.1.5<span class="nt">&lt;/version&gt;</span>
+<span class="nt">&lt;scope&gt;</span>compile<span class="nt">&lt;/scope&gt;</span>
+<span class="nt">&lt;/dependency&gt;</span>
+</pre></div>
 
-    <dependency>
-    <groupId>org.apache.myfaces.core</groupId>
-    <artifactId>myfaces-impl</artifactId>
-    <version>1.1.5</version>
-    <scope>compile</scope>
-    </dependency>
-]
-]></ac:plain-text-body></ac:macro>
 
-<ac:macro ac:name="note"><ac:rich-text-body><p>Make sure the version of
the
+<p>]
+]&gt;</ac:plain-text-body></ac:macro></p>
+<p><ac:macro ac:name="note"><ac:rich-text-body><p>Make sure the version
of the
 <code><strong>-api</strong></code><strong> and </strong><code>-impl</code>
-libraries are the same!</p></ac:rich-text-body></ac:macro>
-
+libraries are the same!</p></ac:rich-text-body></ac:macro></p>
 <h3>Jetty plugin</h3>
 
 <p>The Jetty6 plugin has been added to the <code>pom.xml</code> of the
 archetype. This makes it easy to start your application, without the need
 to install and configure any container or application server. Just type</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 mvn -PjettyConfig clean jetty:run
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>This will create a war, launch the Jetty container and it will server
 your project at <a class="external-link"
 href="http://localhost:8080/testApp"
 rel="nofollow">http://localhost:8080/testApp</a></p>
 
-
-
 <h2>The JSF Components Library Archetype</h2>
 
 <p>This archetype generates a maven multi-module project prepared for the
 development of custom JSF components. To create your new project, the only
 thing you have to do is to execute this command;</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 mvn archetype:generate -DarchetypeCatalog=http://myfaces.apache.org
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>It might be the case that the central archetype catalog is not yet up to
 date and does not contain the Component Library archetype. In that case,
 you have to install the archetype module locally, as described above under
@@ -484,39 +538,35 @@ locally</ac:link-body></ac:link>. The ar
 <p>Now, you can create the project in the folder of your choice! Just go to
 that folder and run the <code>archetype:create</code> goal.</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
-cd yourFolder
-
-mvn archetype:create -DarchetypeGroupId=org.apache.myfaces.buildtools     
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
+cd yourFolder</p>
+<p>mvn archetype:create -DarchetypeGroupId=org.apache.myfaces.buildtools   <br />
 \
              -DarchetypeArtifactId=myfaces-archetype-jsfcomponents
 \
-             -DarchetypeVersion=1.0.1                 
+             -DarchetypeVersion=1.0.1               <br />
 \
-             -DgroupId=myAppId                    
+             -DgroupId=myAppId                  <br />
 \
              -DartifactId=myJsfComponents
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>And there you have it, you can start coding without the hassle of
 project configuration. The archetype generates a multi-module project with
 this structure:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
  -+ project base (parent pom)
   |
   +--- core (component library)
   |
   +--- examples (examples for the components)
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>The layout of the project is almost identical to the layout of the
 MyFaces sandbox. This also ensures that your components could go to the
 sandbox without having too handle major conversions.</p>
 
-
 <h3>The base project</h3>
 
 <p>It contains the parent pom which lists the 'core' and 'examples'
@@ -541,19 +591,17 @@ handy to test that your components work 
 instance, if you want to execute your application directly from Jetty and
 using MyFaces, execute this in the examples folder:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 mvn -PjettyConfig clean package jetty:run
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>Alternately, to build your example app using the JSF Reference
 Implementation, execute this in the examples folder:</p>
 
-<ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+<p><ac:macro ac:name="code"><ac:plain-text-body>&lt;![CDATA[
 mvn -PjettyConfig -Djsf=ri clean package jetty:run
 ]
-]></ac:plain-text-body></ac:macro>
-
+]&gt;</ac:plain-text-body></ac:macro></p>
 <p>And you can go to [<a href="http://localhost:8080/myJsfComponents-examples">http://localhost:8080/myJsfComponents-examples</a>](<a-href="http://localhost:8080/myjsfcomponents-examples">http://localhost:8080/myjsfcomponents-examples</a>.html)
  to see the examples.</p>
 



Mime
View raw message