Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Tapestry Wiki" for 
change notification.

The following page has been changed by JesseKuhnert:
http://wiki.apache.org/tapestry/TapestrySite

New page:
= Overview =
This page describes the new processes involved in building various facets of 
the new [http://tapestry.apache.org] as it relates to maven2.

== Maven2 ==
You will need to grab a current version of [http://maven.apache.org/ maven] and 
install it. This should be pretty straightforward following the maven 
instructions.

== Top Level Site ==
To build the top level project site you will need to checkout the 
'''tapestry-site''' project from 
[http://svn.apache.org/viewvc/tapestry/tapestry-site svn].

This project should hold nothing but documentation for the core site, as well 
as our custom maven2 documentation theme skin which is under the sub directory 
''maven-skin''. 

== Building Site ==
For the most part this is all you need to do:

 * '''mvn site''' - Builds the site locally to your box. You can view the 
results and confirm that everything looks good by going to the ''target'' sub 
folder in your browser. 
 * '''mvn site:deploy''' - Will deploy the site to 
[http://tapestry.apache.org]. Make sure it's good before it goes out!
 * '''mvn -Dmaven.test.skip=true site:deploy''' - If you are getting failed 
unit tests for some reason. '''(Shouldn't happen for top level site, but sub 
projects may have test errors)'''.

== Building Maven Skin ==
Before you can build the actual site you need to have the tapestry skin plugin 
installed. It is intended that this will be released officially at some point 
so that people don't need to do this, but for now you need to do the following:

{{{
cd maven-skin; mvn install;
}}}

That's it! 

== Settings.xml ==
The core site and anything that requires authentication will need a username at 
a minimum from you in order to be deployable. With maven2 this is done via a 
'''settings.xml''' configuration file that is local to your machine only. If 
you are on a linux box it should be placed in '''~/.m2/settings.xml'''. 

Here is a sample settings.xml, you will need to make your server id match the 
name of '''tapestry''' if you want it to get picked up by the build.

{{{
<settings>
        <servers>
           <server>
                <username>jkuhnert</username>
                <id>tapestry</id>
           </server>
        </servers>
</settings>
}}}

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to