tapestry-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christophe Cordenier <christophe.corden...@gmail.com>
Subject Re: [CONF] Apache Tapestry > Getting Started
Date Mon, 29 Nov 2010 19:30:05 GMT
Hi Javier

2010/11/29 Javier Molina <javier@comunicamultimedia.com>

> 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.
>

No problem, I was just curious.


>
> El 29/11/10 19:06, Christophe Cordenier escribió:
>
>> Why have you removed the interactive way ?
>>
>> 2010/11/29<confluence@apache.org>
>>
>>     Getting Started<
>>> https://cwiki.apache.org/confluence/display/TAPESTRY/Getting+Started>
>>>  Page
>>> *edited* by Javier Molina<
>>> https://cwiki.apache.org/confluence/display/%7Ejavier@anatomicsoft.com>
>>> *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 users-subscribe@tapestry.apache.orgor
>>> 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: dev-unsubscribe@tapestry.apache.org
> For additional commands, e-mail: dev-help@tapestry.apache.org
>
>


-- 
Regards,
Christophe Cordenier.

Committer on Apache Tapestry 5
Co-creator of wooki @wookicentral.com

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message