This was proposed in the users@ list and somebody added it to the
confluence task list before I was given write access, so I took it for
granted that it was somehow approved.
The rational for the change was that the interactive way forces the user
to make choices that
- are not relevant to the end result, since this is just a test project
- he might not even know how to make, if he is not familiar with maven
I can revert the changes if there is disagreement about them, but I
truly think that the less we make people think, the better.
El 29/11/10 19:06, Christophe Cordenier escribió:
Why have you removed the interactive way ?
2010/11/29<[email protected]>
Getting
Started<https://cwiki.apache.org/confluence/display/TAPESTRY/Getting+Started>
Page
*edited* by Javier
Molina<https://cwiki.apache.org/confluence/display/%[email protected]>
*Comment:* Cleaned up maven instructions to give the reader a copy-paste
ready command. Also changed instructions to direct the reader to run the
application first of all, then open the IDE
Changes (20)
...
The easiest way to get started is to use [Apache Maven|
http://maven.apache.org] to create your initial project; Maven can use an
_archetype_ (a kind of project template) to create a bare-bones Tapestry
application for you.
One you have Maven installed, execute the command (copy and paste it
as-is)
{noformat}
mvn archetype:generate -DarchetypeCatalog=http://tapestry.apache.org
mvn -DarchetypeVersion=5.1.0.5 -Darchetype.interactinteractive=false
-DgroupId=com.example -DarchetypeArtifactId=quickstart
-Dversion=1.0-SNAPSHOT -DarchetypeGroupId=org.apache.tapestry
-Dpackage=com.example.newapp -DartifactId=newapp --batch-mode
-DarchetypeRepository=http://tapestry.apache.org archetype:generate
{noformat}
Maven will (after performing a large number of one-time downloads) ask you
questions about how to create the new project, including a group id (like a
package name) and an artifact id for your new project.
Maven will (after performing a large number of one-time downloads) create a
skeleton project ready to run.
{noformat}$ mvn archetype:generate -DarchetypeCatalog=
http://tapestry.apache.org
{noformat}$ [INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'archetype'.
[INFO]
------------------------------------------------------------------------
[INFO] Building Maven Default Project
[INFO] task-segment: [archetype:generate] (aggregator-style)
[INFO]
------------------------------------------------------------------------
[INFO] Preparing archetype:generate
[INFO] No goals needed for project - skipping
[INFO] [archetype:generate {execution: default-cli}]
[INFO] Generating project in Interactive Batch mode
[INFO] No archetype defined. Using maven-archetype-quickstart
(org.apache.maven.archetypes:maven-archetype-quickstart:1.0)
Choose archetype:
1: http://tapestry.apache.org -> quickstart (Tapestry 5.2.1-SNAPSHOT
Quickstart Project)
2: http://tapestry.apache.org -> tapestry-archetype (Tapestry 4.1.6
Archetype)
Choose a number: : 1
Choose version:
1: 5.0.19
2: 5.1.0.5
3: 5.2.0
4: 5.2.1-SNAPSHOT
Choose a number: : 3
Define value for property 'groupId': : com.example
Define value for property 'artifactId': : newapp
Define value for property 'version': 1.0-SNAPSHOT:
Define value for property 'package': com.example: com.example.newapp
Confirm properties configuration:
groupId: com.example
artifactId: newapp
version: 1.0-SNAPSHOT
package: com.example.newapp
Y:
[INFO] Archetype defined by properties
[INFO]
------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO]
------------------------------------------------------------------------
[INFO] Total time: 25 seconds 1 second
[INFO] Finished at: Tue Aug 17 14:01:50 PDT Mon Nov 29 18:30:20 CET 2010
[INFO] Final Memory: 16M/81M 20M/213M
[INFO]
------------------------------------------------------------------------
/tmp
...
{noformat}
Once it is created, you can load it into any IDE and start coding, or use
{{mvn jetty:run{}}}{footnote}Jetty is a well-known, open-source,
high-performance servlet container. Jetty starts up quickly, and implements
the official Servlet specification very closely.{footnote}. Again, more
one-time downloads, but then you can open your browser to [
http://localhost:8080] to run the application.
Once it is created, you can run
{noformat}
mvn jetty:run
{noformat}
and after some more one-time downloads you can open your browser to [
http://localhost:8080] to see the application running.
You can also load the newly-created project it into any IDE and start
coding. See the next section on where to find the different components of
the application.
For more information on this, try the [Tapestry Tutorial|TAPESTRY:Tutorial]
which goes into more detail about setting up your project, as well as
loading it into Eclipse ... then continues on to teach you more about
Tapestry.
h2. Exploring the test project
Tapestry page templates have the .tml extension and are found in
src/main/webapp. They are basically HTML with some special markup tags.
A Tapestry application is composed of pages, each page consisting of one
template file and one Java class.
Tapestry page templates have the .tml extension and are found in
src/main/webapp. They are basically HTML with some special markup to link
the template to the Java class and to ready-made components you can use to
speed up your development.
Java classes are found in src/main/*java*/com/example/newapp/*pages* and
their name matches their template name (Index.tml -> Index.java).
...
Full Content
See it live !
You can play with Tapestry via our live demonstration applications. To
start you can have a look at the Hotel
Booking<http://tapestry.zones.apache.org:8180/tapestry5-hotel-booking/>that has
been developed by contributors and committers. The whole source
code is available at
github<http://github.com/ccordenier/tapestry5-hotel-booking>so you can download
and play with it.
Create your first Tapestry project
The easiest way to get started is to use Apache
Maven<http://maven.apache.org>to create your initial project; Maven can use an
*archetype* (a kind of project template) to create a bare-bones Tapestry
application for you.
One you have Maven installed, execute the command (copy and paste it as-is)
mvn -DarchetypeVersion=5.1.0.5 -Darchetype.interactinteractive=false
-DgroupId=com.example -DarchetypeArtifactId=quickstart -Dversion=1.0-SNAPSHOT
-DarchetypeGroupId=org.apache.tapestry -Dpackage=com.example.newapp
-DartifactId=newapp --batch-mode
-DarchetypeRepository=http://tapestry.apache.org archetype:generate
Maven will (after performing a large number of one-time downloads) create
a skeleton project ready to run.
$ [INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'archetype'.
[INFO] ------------------------------------------------------------------------
[INFO] Building Maven Default Project
[INFO] task-segment: [archetype:generate] (aggregator-style)
[INFO] ------------------------------------------------------------------------
[INFO] Preparing archetype:generate
[INFO] No goals needed for project - skipping
[INFO] [archetype:generate {execution: default-cli}]
[INFO] Generating project in Batch mode
[INFO] Archetype defined by properties
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Mon Nov 29 18:30:20 CET 2010
[INFO] Final Memory: 20M/213M
[INFO] ------------------------------------------------------------------------
/tmp
$
Once it is created, you can run
mvn jetty:run
and after some more one-time downloads you can open your browser to
http://localhost:8080 to see the application running.
You can also load the newly-created project it into any IDE and start
coding. See the next section on where to find the different components of
the application.
For more information on this, try the Tapestry
Tutorial<https://cwiki.apache.org/confluence/display/TAPESTRY/Tutorial>which
goes into more detail about setting up your project, as well as
loading it into Eclipse ... then continues on to teach you more about
Tapestry.
Exploring the test project
A Tapestry application is composed of pages, each page consisting of one
template file and one Java class.
Tapestry page templates have the .tml extension and are found in
src/main/webapp. They are basically HTML with some special markup to link
the template to the Java class and to ready-made components you can use to
speed up your development.
Java classes are found in src/main/*java*/com/example/newapp/*pages* and
their name matches their template name (Index.tml -> Index.java).
In the test project, most of the HTML is not found on the pages themselves
but in a Layout component which acts as a global template for the whole
site. Java classes for components live in src/main/*java*
/com/example/newapp/*components* and component templates go in src/main/*
resources*/com/example/newapp/*components*
More
Learn more about Tapestry
Philosophy<https://cwiki.apache.org/confluence/display/TAPESTRY/Principles>and
then checkout our full
Documentation<https://cwiki.apache.org/confluence/display/TAPESTRY/Documentation>page
on which you will find a lot of resources written by committers and
contributors.
Obtain Help
Tapestry has an active user mailing list on which you can find a lot of
valuable support. You can subscribe [email protected] or
look for an answer in the
archives<http://markmail.org/search/list:org.apache.tapestry.users>
Having trouble? Try our Frequently Asked
Questions<https://cwiki.apache.org/confluence/display/TAPESTRY/Frequently+Asked+Questions>
.
Footnotes Reference Notes
Change Notification
Preferences<https://cwiki.apache.org/confluence/users/viewnotifications.action>
View
Online<https://cwiki.apache.org/confluence/display/TAPESTRY/Getting+Started>|
View
Changes<https://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=23334911&revisedVersion=11&originalVersion=10>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
