Why was this renamed? ASF publishing guidelines? Martijn
On Fri, May 15, 2015 at 2:52 PM, <[email protected]> wrote: > Repository: wicket-site > Updated Branches: > refs/heads/asf-site 92ce327b6 -> 711fcbf74 > > > http://git-wip-us.apache.org/repos/asf/wicket-site/blob/711fcbf7/content/start/index.html > ---------------------------------------------------------------------- > diff --git a/content/start/index.html b/content/start/index.html > new file mode 100644 > index 0000000..eaa5db1 > --- /dev/null > +++ b/content/start/index.html > @@ -0,0 +1,207 @@ > +<!DOCTYPE html> > +<html> > +<head> > + <title>Apache Wicket - Get Started</title> > + > + <link rel="stylesheet" href="/css/screen.css" type="text/css" > media="screen" /> > + > + <!--[if lt ie 7]> > + <link rel="stylesheet" href="/css/ie.css" type="text/css" > media="screen" /> > + <![endif]--> > + <link rel="shortcut icon" href="/favicon.ico" > type="image/vnd.microsoft.icon" /> > + <link rel="alternate" type="application/atom+xml" href="/atom.xml" /> > + <meta http-equiv="content-type" content="text/html;charset=utf-8" /> > +</head> > +<body> > +<div id="container"> > + <div id="content"> > + <div id="header"><a href="/"><h1 id="logo"><span>Apache > Wicket</span></h1></a></div> > + <div id="navigation"> > + <h5><a name="Navigation-Wicket"></a>Meet Wicket</h5> > + <ul> > + <li> > + <a href="/" title="Index">Home</a> > + </li> > + <li> > + <a href="/meet/introduction.html" > title="Introduction">Introduction</a> > + </li> > + <li> > + <a href="/meet/features.html" > title="Features">Features</a> > + </li> > + <li> > + <a href="/meet/buzz.html" title="Buzz">Buzz</a> > + </li> > + <li> > + <a href="/meet/vision.html" title="Vision">Vision</a> > + </li> > + <li> > + <a href="/meet/blogs.html" title="Blogs">Blogs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-GettingStarted" > id="Navigation-GettingStarted"></a>Get Started > + </h5> > + <ul> > + <li> > + <a href="/start/download.html" title="Download > Wicket">Download Wicket</a> > + </li> > + <li> > + <a href="/start/quickstart.html" title="Getting > started via a Maven Archetype">Quickstart</a> > + </li> > + <li> > + <a href="http://www.jweekend.com/dev/LegUp"; > rel="nofollow">More archetypes</a> > + </li> > + <li> > + <a href="/help" title="Get help">Get help</a> > + </li> > + <li> > + <a href="/help/email.html" title="Wicket Mailing > Lists">Mailing Lists</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Documentation" > id="Navigation-Documentation"></a>Learn > + </h5> > + <ul> > + <li> > + <a href="/start/userguide.html" title="User > Guide">User Guide</a> > + </li> > + <li> > + <a href="/learn/examples" > title="Examples">Examples</a> > + </li> > + <li> > + <a > href="http://www.wicket-library.com/wicket-examples/compref/";>Components</a> > + </li> > + <li> > + <a href="/learn/projects/" title="Projects extending > basic Wicket">Projects</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET";>Wiki</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Reference+library";>Reference > guide</a> > + </li> > + <li> > + <a href="/learn/books" title="Books">Books</a> > + </li> > + <li> > + <a href="/learn/ides.html" title="IDEs">IDEs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Releases" > id="Navigation-Releases"></a>Releases > + </h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/6.19.0";>Wicket 6.19</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.5.13";>Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.4.23";>Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.3.7";>Wicket 1.3</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.2"; > class="external-link" rel="nofollow">Wicket 1.2</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.1"; > class="external-link" rel="nofollow">Wicket 1.1</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.0"; > class="external-link" rel="nofollow">Wicket 1.0</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Docs" id="Navigation-Docs"></a>API Docs > + </h5> > + <ul> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/6.x/"; title="JavaDocs of > Apache Wicket 6.x">Wicket 6.x</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.5.x/"; title="JavaDocs of > Apache Wicket 1.5.x">Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.4.x"; title="JavaDocs of > Apache Wicket 1.4.x">Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.3.x"; title="JavaDocs of > Apache Wicket 1.3.x">Wicket 1.3</a> > + </li> > + </ul> > + <h5>Wicket 7.x</h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/7.0.0-M5";>Download M5</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Migration+to+Wicket+7.0";>Migration > guide</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/7.x/"; title="JavaDocs of > Apache Wicket 7.x">API Docs 7.x</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Developers" > id="Navigation-Developers"></a>Contribute > + </h5> > + <ul> > + <li> > + <a href="/contribute/write.html" title="Writing > documentation">Writing docs</a> > + </li> > + <li> > + <a href="/contribute/build.html" title="Building from > SVN">Build Wicket</a> > + </li> > + <li> > + <a href="/contribute/patch.html" title="Provide a > patch">Provide a patch</a> > + </li> > + <li> > + <a href="/contribute/release.html" title="Release > Wicket">Release Wicket</a> > + </li> > + <li> > + <a > href="https://fisheye6.atlassian.com/browse/wicket-git"; title="Git Overview" > class="external-link" rel="nofollow">Fisheye</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Apache" id="Navigation-Apache"></a>Apache > + </h5> > + <ul> > + <li> > + <a href="http://www.apache.org/"; > class="external-link" rel="nofollow">Apache</a> > + </li> > + <li> > + <a href="http://www.apache.org/licenses/"; > class="external-link" rel="nofollow">License</a> > + </li> > + <li> > + <a > href="http://www.apache.org/foundation/sponsorship.html"; > class="external-link" rel="nofollow">Sponsorship</a> > + </li> > + <li> > + <a href="http://apache.org/foundation/thanks.html"; > class="external-link" rel="nofollow">Thanks</a> > + </li> > + <li> > + <a href="/apache/friends.html" title="Apache projects > using Wicket">Friends</a> > + </li> > + </ul> > +</div> > + > + <div id="contentbody"> > + <h1>Get Started</h1> > + <ul> > + <li>Start with Apache Wicket using the <a > href="quickstart.html">quickstart</a></li> > + <li><a href="download.html">Download</a> the latest and greatest Wicket > release</li> > + <li>Or use one of the available third party <a > href="http://www.jweekend.com/dev/LegUp"; rel="nofollow">Maven > archetypes</a></li> > +</ul> > + > + </div> > + <div id="clearer"></div> > + <div id="footer"><span> > +Copyright © 2015 — The Apache Software Foundation. Apache Wicket, > +Wicket, Apache, the Apache feather logo, and the Apache Wicket project logo > +are trademarks of The Apache Software Foundation. All other marks mentioned > +may be trademarks or registered trademarks of their respective owners. > +</span></div> > + > + </div> > +</div> > +</body> > +</html> > > http://git-wip-us.apache.org/repos/asf/wicket-site/blob/711fcbf7/content/start/installing.html > ---------------------------------------------------------------------- > diff --git a/content/start/installing.html b/content/start/installing.html > new file mode 100644 > index 0000000..499a764 > --- /dev/null > +++ b/content/start/installing.html > @@ -0,0 +1,260 @@ > +<!DOCTYPE html> > +<html> > +<head> > + <title>Apache Wicket - Installing Wicket</title> > + > + <link rel="stylesheet" href="/css/screen.css" type="text/css" > media="screen" /> > + > + <!--[if lt ie 7]> > + <link rel="stylesheet" href="/css/ie.css" type="text/css" > media="screen" /> > + <![endif]--> > + <link rel="shortcut icon" href="/favicon.ico" > type="image/vnd.microsoft.icon" /> > + <link rel="alternate" type="application/atom+xml" href="/atom.xml" /> > + <meta http-equiv="content-type" content="text/html;charset=utf-8" /> > +</head> > +<body> > +<div id="container"> > + <div id="content"> > + <div id="header"><a href="/"><h1 id="logo"><span>Apache > Wicket</span></h1></a></div> > + <div id="navigation"> > + <h5><a name="Navigation-Wicket"></a>Meet Wicket</h5> > + <ul> > + <li> > + <a href="/" title="Index">Home</a> > + </li> > + <li> > + <a href="/meet/introduction.html" > title="Introduction">Introduction</a> > + </li> > + <li> > + <a href="/meet/features.html" > title="Features">Features</a> > + </li> > + <li> > + <a href="/meet/buzz.html" title="Buzz">Buzz</a> > + </li> > + <li> > + <a href="/meet/vision.html" title="Vision">Vision</a> > + </li> > + <li> > + <a href="/meet/blogs.html" title="Blogs">Blogs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-GettingStarted" > id="Navigation-GettingStarted"></a>Get Started > + </h5> > + <ul> > + <li> > + <a href="/start/download.html" title="Download > Wicket">Download Wicket</a> > + </li> > + <li> > + <a href="/start/quickstart.html" title="Getting > started via a Maven Archetype">Quickstart</a> > + </li> > + <li> > + <a href="http://www.jweekend.com/dev/LegUp"; > rel="nofollow">More archetypes</a> > + </li> > + <li> > + <a href="/help" title="Get help">Get help</a> > + </li> > + <li> > + <a href="/help/email.html" title="Wicket Mailing > Lists">Mailing Lists</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Documentation" > id="Navigation-Documentation"></a>Learn > + </h5> > + <ul> > + <li> > + <a href="/start/userguide.html" title="User > Guide">User Guide</a> > + </li> > + <li> > + <a href="/learn/examples" > title="Examples">Examples</a> > + </li> > + <li> > + <a > href="http://www.wicket-library.com/wicket-examples/compref/";>Components</a> > + </li> > + <li> > + <a href="/learn/projects/" title="Projects extending > basic Wicket">Projects</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET";>Wiki</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Reference+library";>Reference > guide</a> > + </li> > + <li> > + <a href="/learn/books" title="Books">Books</a> > + </li> > + <li> > + <a href="/learn/ides.html" title="IDEs">IDEs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Releases" > id="Navigation-Releases"></a>Releases > + </h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/6.19.0";>Wicket 6.19</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.5.13";>Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.4.23";>Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.3.7";>Wicket 1.3</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.2"; > class="external-link" rel="nofollow">Wicket 1.2</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.1"; > class="external-link" rel="nofollow">Wicket 1.1</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.0"; > class="external-link" rel="nofollow">Wicket 1.0</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Docs" id="Navigation-Docs"></a>API Docs > + </h5> > + <ul> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/6.x/"; title="JavaDocs of > Apache Wicket 6.x">Wicket 6.x</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.5.x/"; title="JavaDocs of > Apache Wicket 1.5.x">Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.4.x"; title="JavaDocs of > Apache Wicket 1.4.x">Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.3.x"; title="JavaDocs of > Apache Wicket 1.3.x">Wicket 1.3</a> > + </li> > + </ul> > + <h5>Wicket 7.x</h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/7.0.0-M5";>Download M5</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Migration+to+Wicket+7.0";>Migration > guide</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/7.x/"; title="JavaDocs of > Apache Wicket 7.x">API Docs 7.x</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Developers" > id="Navigation-Developers"></a>Contribute > + </h5> > + <ul> > + <li> > + <a href="/contribute/write.html" title="Writing > documentation">Writing docs</a> > + </li> > + <li> > + <a href="/contribute/build.html" title="Building from > SVN">Build Wicket</a> > + </li> > + <li> > + <a href="/contribute/patch.html" title="Provide a > patch">Provide a patch</a> > + </li> > + <li> > + <a href="/contribute/release.html" title="Release > Wicket">Release Wicket</a> > + </li> > + <li> > + <a > href="https://fisheye6.atlassian.com/browse/wicket-git"; title="Git Overview" > class="external-link" rel="nofollow">Fisheye</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Apache" id="Navigation-Apache"></a>Apache > + </h5> > + <ul> > + <li> > + <a href="http://www.apache.org/"; > class="external-link" rel="nofollow">Apache</a> > + </li> > + <li> > + <a href="http://www.apache.org/licenses/"; > class="external-link" rel="nofollow">License</a> > + </li> > + <li> > + <a > href="http://www.apache.org/foundation/sponsorship.html"; > class="external-link" rel="nofollow">Sponsorship</a> > + </li> > + <li> > + <a href="http://apache.org/foundation/thanks.html"; > class="external-link" rel="nofollow">Thanks</a> > + </li> > + <li> > + <a href="/apache/friends.html" title="Apache projects > using Wicket">Friends</a> > + </li> > + </ul> > +</div> > + > + <div id="contentbody"> > + <h1>Installing Wicket</h1> > + <p>So you chose not to use one of the ready to use > Maven archetypes, but rather > +roll things on your own. While possible, it needs some close attention to > +make things work properly. Most notable things you need to take care of > are:</p> > + > +<ul> > + <li>dependencies</li> > + <li>logging</li> > +</ul> > + > +<h2 id="required-dependencies-to-use-wicket">Required dependencies to use > Wicket</h2> > + > +<p>While we are adamant users of Apache Maven and its build infrastructure, > this > +may not be to everyone’s liking. However, if you wish to learn all about > +which dependencies you need for your Wicket project, we ask you to learn to > +read the POM file format and retrieve the required versions stated there. We > +take great care to keep the POM files up to date with the latest and greatest > +of each dependency.</p> > + > +<h3 id="compilation--testing">Compilation & Testing</h3> > + > +<p>At a minimum a vanilla Wicket application requires for compilation:</p> > + > +<ul> > + <li>Java SDK 1.5 or newer</li> > + <li>servlet-api</li> > + <li>slf4j-api</li> > + <li>any slf4j implementation and dependencies necessary for that logging > +provider</li> > + <li>junit if you build Wicket from source or want to use > <code>WicketTester</code> to test > +your pages and components</li> > +</ul> > + > +<h3 id="runtime-dependencies">Runtime dependencies</h3> > + > +<p>At a minimum a barebones Wicket application requires the following at > runtime:</p> > + > +<ul> > + <li>a servlet container (Apache Tomcat, Jetty) or any JEE container</li> > + <li>Java 5 runtime or newer</li> > + <li>slf4j-api and your slf4j implementation and required logging provider > +dependencies.</li> > +</ul> > + > +<h2 id="logging">Logging</h2> > + > +<p>As of Wicket 1.3.0, Wicket uses the <a > href="http://www.slf4j.org/";>SLF4J</a> project > +for logging. SLF4J is similar to > +<a href="http://jakarta.apache.org/commons/logging/";>commons-logging</a>, in > that it > +allows libraries/frameworks like Wicket to avoid forcing a choice of logging > +framework on their users.</p> > + > +<p><strong>You cannot use Wicket without adding an SLF4J logging > implementation to > +your classpath</strong>. Most people use <a > href="http://logging.apache.org/log4j";>log4j</a>. > +If you do, just include <code>slf4j-log4j12.jar</code> on your classpath to > get Wicket > +to use log4j too. If you want to use commons-logging or JDK14 logging or > +something else, please see the <a href="http://www.slf4j.org/faq.html";>SLF4J > site</a> > +for more information.</p> > + > + > + </div> > + <div id="clearer"></div> > + <div id="footer"><span> > +Copyright © 2015 — The Apache Software Foundation. Apache Wicket, > +Wicket, Apache, the Apache feather logo, and the Apache Wicket project logo > +are trademarks of The Apache Software Foundation. All other marks mentioned > +may be trademarks or registered trademarks of their respective owners. > +</span></div> > + > + </div> > +</div> > +</body> > +</html> > > http://git-wip-us.apache.org/repos/asf/wicket-site/blob/711fcbf7/content/start/quickstart.html > ---------------------------------------------------------------------- > diff --git a/content/start/quickstart.html b/content/start/quickstart.html > new file mode 100644 > index 0000000..3b426b7 > --- /dev/null > +++ b/content/start/quickstart.html > @@ -0,0 +1,428 @@ > +<!DOCTYPE html> > +<html> > +<head> > + <title>Apache Wicket - Create a Wicket Quickstart</title> > + > + <link rel="stylesheet" href="/css/screen.css" type="text/css" > media="screen" /> > + > + <!--[if lt ie 7]> > + <link rel="stylesheet" href="/css/ie.css" type="text/css" > media="screen" /> > + <![endif]--> > + <link rel="shortcut icon" href="/favicon.ico" > type="image/vnd.microsoft.icon" /> > + <link rel="alternate" type="application/atom+xml" href="/atom.xml" /> > + <meta http-equiv="content-type" content="text/html;charset=utf-8" /> > +</head> > +<body> > +<div id="container"> > + <div id="content"> > + <div id="header"><a href="/"><h1 id="logo"><span>Apache > Wicket</span></h1></a></div> > + <div id="navigation"> > + <h5><a name="Navigation-Wicket"></a>Meet Wicket</h5> > + <ul> > + <li> > + <a href="/" title="Index">Home</a> > + </li> > + <li> > + <a href="/meet/introduction.html" > title="Introduction">Introduction</a> > + </li> > + <li> > + <a href="/meet/features.html" > title="Features">Features</a> > + </li> > + <li> > + <a href="/meet/buzz.html" title="Buzz">Buzz</a> > + </li> > + <li> > + <a href="/meet/vision.html" title="Vision">Vision</a> > + </li> > + <li> > + <a href="/meet/blogs.html" title="Blogs">Blogs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-GettingStarted" > id="Navigation-GettingStarted"></a>Get Started > + </h5> > + <ul> > + <li> > + <a href="/start/download.html" title="Download > Wicket">Download Wicket</a> > + </li> > + <li> > + <a href="/start/quickstart.html" title="Getting > started via a Maven Archetype">Quickstart</a> > + </li> > + <li> > + <a href="http://www.jweekend.com/dev/LegUp"; > rel="nofollow">More archetypes</a> > + </li> > + <li> > + <a href="/help" title="Get help">Get help</a> > + </li> > + <li> > + <a href="/help/email.html" title="Wicket Mailing > Lists">Mailing Lists</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Documentation" > id="Navigation-Documentation"></a>Learn > + </h5> > + <ul> > + <li> > + <a href="/start/userguide.html" title="User > Guide">User Guide</a> > + </li> > + <li> > + <a href="/learn/examples" > title="Examples">Examples</a> > + </li> > + <li> > + <a > href="http://www.wicket-library.com/wicket-examples/compref/";>Components</a> > + </li> > + <li> > + <a href="/learn/projects/" title="Projects extending > basic Wicket">Projects</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET";>Wiki</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Reference+library";>Reference > guide</a> > + </li> > + <li> > + <a href="/learn/books" title="Books">Books</a> > + </li> > + <li> > + <a href="/learn/ides.html" title="IDEs">IDEs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Releases" > id="Navigation-Releases"></a>Releases > + </h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/6.19.0";>Wicket 6.19</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.5.13";>Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.4.23";>Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.3.7";>Wicket 1.3</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.2"; > class="external-link" rel="nofollow">Wicket 1.2</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.1"; > class="external-link" rel="nofollow">Wicket 1.1</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.0"; > class="external-link" rel="nofollow">Wicket 1.0</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Docs" id="Navigation-Docs"></a>API Docs > + </h5> > + <ul> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/6.x/"; title="JavaDocs of > Apache Wicket 6.x">Wicket 6.x</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.5.x/"; title="JavaDocs of > Apache Wicket 1.5.x">Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.4.x"; title="JavaDocs of > Apache Wicket 1.4.x">Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.3.x"; title="JavaDocs of > Apache Wicket 1.3.x">Wicket 1.3</a> > + </li> > + </ul> > + <h5>Wicket 7.x</h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/7.0.0-M5";>Download M5</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Migration+to+Wicket+7.0";>Migration > guide</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/7.x/"; title="JavaDocs of > Apache Wicket 7.x">API Docs 7.x</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Developers" > id="Navigation-Developers"></a>Contribute > + </h5> > + <ul> > + <li> > + <a href="/contribute/write.html" title="Writing > documentation">Writing docs</a> > + </li> > + <li> > + <a href="/contribute/build.html" title="Building from > SVN">Build Wicket</a> > + </li> > + <li> > + <a href="/contribute/patch.html" title="Provide a > patch">Provide a patch</a> > + </li> > + <li> > + <a href="/contribute/release.html" title="Release > Wicket">Release Wicket</a> > + </li> > + <li> > + <a > href="https://fisheye6.atlassian.com/browse/wicket-git"; title="Git Overview" > class="external-link" rel="nofollow">Fisheye</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Apache" id="Navigation-Apache"></a>Apache > + </h5> > + <ul> > + <li> > + <a href="http://www.apache.org/"; > class="external-link" rel="nofollow">Apache</a> > + </li> > + <li> > + <a href="http://www.apache.org/licenses/"; > class="external-link" rel="nofollow">License</a> > + </li> > + <li> > + <a > href="http://www.apache.org/foundation/sponsorship.html"; > class="external-link" rel="nofollow">Sponsorship</a> > + </li> > + <li> > + <a href="http://apache.org/foundation/thanks.html"; > class="external-link" rel="nofollow">Thanks</a> > + </li> > + <li> > + <a href="/apache/friends.html" title="Apache projects > using Wicket">Friends</a> > + </li> > + </ul> > +</div> > + > + <div id="contentbody"> > + <h1>Create a Wicket Quickstart</h1> > + <p>There are two really good reasons to create a > Wicket quickstart. The first is if > +you just want to get started using Wicket quickly. The quickstart will set > up a > +ready-to-use project in under a minute (depending on your bandwidth). > Another > +great reason to create a quickstart is to accompany a bug report. If you > report > +a bug in JIRA or on the mailing list, the core developers may not be able to > +recreate it easily. In most cases, you’ll be told “please create a > quickstart and > +attach it to a JIRA issue”. If you don’t know how to do that, don’t worry - > just > +follow the instructions below. (If you are submitting a quickstart for an > issue > +report, please be sure to read the subheading below - “Submitting a > quickstart > +for an issue report”</p> > + > +<p>Quickstarts are made from a Maven archetype. So, you will need to have > +<a href="http://maven.apache.org";>Maven 2</a> installed and working (from > the command line) > +before following this.</p> > + > +<p>Creating a quickstart provides only a very basic starting point for your > Wicket > +project. If you are looking for examples of how to use Wicket and its > various > +features, please refer to the <em>wicket-example</em> projects instead!</p> > + > +<h2 id="creating-the-project---with-maven">Creating the project - with > Maven</h2> > + > +<p>To create your project, copy and paste the command line generated after > +typing in the groupId, artifactId and version.</p> > + > +<style> > + #mvncmd { > + padding-left: 25px; > + } > + #mvncmd label { > + font-weight: bold; > + width: 100px; > + display: inline-block; > + } > + #mvncmd input, #mvncmd select, #mvncm span { width: 180px; > margin-bottom: 5px;} > + #mvncmd textarea { width: 400px; height: 100px; } > + #mvncmd br { clear: left; } > + #mvncmd div { clear:both; padding-left: 25px; vertical-align:top;} > +</style> > + > +<script type="text/javascript"> > + function changeIt() > + { > + var groupId = document.getElementById("groupId").value; > + var artifactId = document.getElementById("artifactId").value; > + var version = document.getElementById("version").value; > + var appserver = document.getElementById("appserver").value; > + var cmd; > + if(version.match(/^1\.[34]/)) > + cmd = 'mvn archetype:create > -DarchetypeGroupId=org.apache.wicket > -DarchetypeArtifactId=wicket-archetype-quickstart -DarchetypeVersion=' + > version + ' -DgroupId=' + groupId + ' -DartifactId=' + artifactId; > + else > + cmd = 'mvn archetype:generate > -DarchetypeGroupId=org.apache.wicket > -DarchetypeArtifactId=wicket-archetype-quickstart -DarchetypeVersion=' + > version + ' -DgroupId=' + groupId + ' -DartifactId=' + artifactId; > + > + if (version.match(/.*SNAPSHOT/)) > + cmd += ' > -DarchetypeRepository=https://repository.apache.org/content/repositories/snapshots/'; > + else > + cmd += ' > -DarchetypeRepository=https://repository.apache.org/'; > + > + if (appserver === 'wildfly') > + cmd += ' > -Dlog4j.properties=wildfly-doesnt-need-log4j.properties'; > + > + cmd += ' -DinteractiveMode=false'; > + document.getElementById("cmdLine").value = cmd; > + } > +</script> > + > +<div id="mvncmd"> > + <div> > + <label for="groupId" title="Base Package">GroupId:</label> > + <input type="text" id="groupId" value="com.mycompany" > onkeyup="changeIt();" /><span title="Base Package"> (?)</span><br /> > + </div> > + <div> > + <label for="artifactId" title="Project > Name">ArtifactId:</label> > + <input type="text" id="artifactId" value="myproject" > onkeyup="changeIt();" /><span title="Project Name"> (?)</span><br /> > + </div> > + <div> > + <label for="version" title="Wicket Version">Version:</label> > + <select id="version" onchange="changeIt();"> > + > + > + <option value="7.0.0-SNAPSHOT">7.0.0-SNAPSHOT</option> > + > + > + > + <option > value="6.20.0-SNAPSHOT">6.20.0-SNAPSHOT</option> > + > + > + > + <option value="1.5-SNAPSHOT">1.5-SNAPSHOT</option> > + > + > + > + <option value="7.0.0-M5">7.0.0-M5</option> > + > + > + > + <option value="1.4.23">1.4.23</option> > + > + > + > + <option value="1.5.13">1.5.13</option> > + > + > + > + <option value="6.19.0" > selected="selected">6.19.0</option> > + > + > + </select><span title="Wicket Version"> (?)</span> > + </div> > + <div> > + <label for="appserver" title="Server to deploy > on">Server:</label> > + <select id="appserver" onchange="changeIt();"> > + <option value="any" selected="selected">Any but Wild > Fly</option> > + <option value="wildfly">Wild Fly (JBoss 8.x)</option> > + </select><span title="Web/App Server"> (?)</span> > + </div> > + <div> > + <label for="cmdLine" id="cmdLabel">Command Line:</label> > + <textarea id="cmdLine" onfocus="this.select();"> > + </textarea> > + <script>changeIt();</script> > + </div> > + <br /> > +</div> > + > +<h3 id="results">Results</h3> > + > +<p>This will produce the following project structure/files:</p> > + > +<div style="margin-left: 3em; border: 1px solid black"> > +<pre> > + .\myproject > + | pom.xml > + | > + \---src > + +---main > + | +---java > + | | \---com > + | | \---mycompany > + | | HomePage.html > + | | HomePage.java > + | | WicketApplication.java > + | | > + | +---resources > + | | log4j.properties > + | | > + | \---webapp > + | \---WEB-INF > + | web.xml > + | > + \---test > + \---java > + \---com > + \---mycompany > + Start.java > +</pre> > +</div> > + > +<h3 id="using-maven-quickstart-with-a-specific-ide">Using Maven quickstart > with a specific IDE</h3> > + > +<p>Maven has an integration with many IDEs. If you want to use your new > Maven-based > +Wicket quickstart with your favorite IDE, see one of these instructions:</p> > + > +<h4 id="eclipse">Eclipse</h4> > + > +<p>Change directory into the project that you just created. Now, run > +<code>mvn eclipse:eclipse</code>. This will set up the .project, .settings, > and .classpath > +files that Eclipse requires. </p> > + > +<p>Note that your workspace will have to have the classpath variable M2_REPO > set to point to the directory where your local Maven repository exists. You > can see this page for how to do that with Eclipse: <a > href="http://maven.apache.org/plugins/maven-eclipse-plugin/usage.html";>http://maven.apache.org/plugins/maven-eclipse-plugin/usage.html</a></p> > + > +<p>Now, in Eclipse, you can choose “File” (menu), then “Import”, then > “Existing project”. > +Navigate to the folder where your project exists and let Eclipse import it. > The classpath should > +be fully configured.</p> > + > +<p>Alternatively install the <a > href="http://m2eclipse.codehaus.org/";>m2eclipse</a> or > +<a href="http://www.eclipse.org/iam/";>Eclipse IAM</a> plugin and add the > project > +directly.</p> > + > +<h4 id="idea">IDEA</h4> > + > +<p>From within IDEA, just use “File/Import Project”, choose the project > directory and specify that this is a Maven project.</p> > + > +<h4 id="netbeans">NetBeans</h4> > + > +<p>To create a NetBeans project, just open the pom.xml directly.</p> > + > +<h3 id="more-examples">More examples</h3> > + > +<p>Many more information and examples can be found on our Wiki or > +<a > href="http://www.ralfebert.de/blog/wicket/wicket_eclipse_setup/";>here</a></p> > + > +<h2 id="using-your-new-project">Using your new project</h2> > + > +<p>Wicket quickstart projects include a file named Start.java. If you open > this file in > +your IDE (after configuring the project in your IDE), you can run it as a > Java application. > +It will run an embedded Jetty instance that will run your app on <a > href="http://localhost:8080";>http://localhost:8080</a> > +Navigate your browser to that address to see your app running.</p> > + > +<h3 id="using-the-jetty-plugin">Using the Jetty Plugin</h3> > + > +<p>The Jetty plugin is also enabled by default in the quickstart. If you > are using Maven, > +you can change directory into the project and run the “mvn jetty:run” > command. This will > +compile the project and deploy it to an embeded instance of the Jetty > servlet engine, > +which will run on port 8080, by default. As a result, once running, your > application will be available at <a > href="http://localhost:8080";>http://localhost:8080</a>.</p> > + > +<p>See the <a href="http://www.mortbay.org/maven-plugin/index.html";>Jetty > plugin</a> > +documentation for configuration options, etc.</p> > + > +<h2 id="submitting-a-quickstart-for-an-issue-report">Submitting a quickstart > for an issue report</h2> > + > +<h3 id="reproduce-the-problem">Reproduce the problem</h3> > + > +<p>Assuming you have followed the instructions above, the quickstart is now > created and ready for you to develop. Now comes the “duplicate the problem” > part. Try to create pages or components that reproduce the problem you were > trying to report. You can run the Start.java class from your > +IDE and go to <a href="http://localhost:8080";>http://localhost:8080</a> to > see your test application. If you run the Start.java class > +in your IDE’s debug mode, you should be able to attach breakpoints and have > automatic class and > +markup reloading.</p> > + > +<p>If you can’t reproduce the problem - start looking at your own code. > Keep adding pieces from > +your code until either you reproduce the problem, or else you’ve found the > bug in your own code. > +A lot of times, you will find the bug in your code just by trying to create > a quickstart that > +demonstrates the bug in ours. </p> > + > +<h3 id="clean-up-the-quickstart-and-submit-it">Clean up the quickstart and > submit it</h3> > + > +<p>Once you have reproduced the desired behavior in your quickstart, it > would be best to make it as small as possible before submitting. The best > way to do this is to run the “mvn clean” command from the project directory. > Then zip (or tar and gzip) the whole directory up and submit the zip (or tgz) > file. (The mvn clean command removes all of the compiled classes and > generated artifacts, generally in your “target” directory, leaving only the > actual source.)</p> > + > + > + </div> > + <div id="clearer"></div> > + <div id="footer"><span> > +Copyright © 2015 — The Apache Software Foundation. Apache Wicket, > +Wicket, Apache, the Apache feather logo, and the Apache Wicket project logo > +are trademarks of The Apache Software Foundation. All other marks mentioned > +may be trademarks or registered trademarks of their respective owners. > +</span></div> > + > + </div> > +</div> > +</body> > +</html> > > http://git-wip-us.apache.org/repos/asf/wicket-site/blob/711fcbf7/content/start/userguide.html > ---------------------------------------------------------------------- > diff --git a/content/start/userguide.html b/content/start/userguide.html > new file mode 100644 > index 0000000..20ca83d > --- /dev/null > +++ b/content/start/userguide.html > @@ -0,0 +1,222 @@ > +<!DOCTYPE html> > +<html> > +<head> > + <title>Apache Wicket - Wicket User Guide</title> > + > + <link rel="stylesheet" href="/css/screen.css" type="text/css" > media="screen" /> > + > + <!--[if lt ie 7]> > + <link rel="stylesheet" href="/css/ie.css" type="text/css" > media="screen" /> > + <![endif]--> > + <link rel="shortcut icon" href="/favicon.ico" > type="image/vnd.microsoft.icon" /> > + <link rel="alternate" type="application/atom+xml" href="/atom.xml" /> > + <meta http-equiv="content-type" content="text/html;charset=utf-8" /> > +</head> > +<body> > +<div id="container"> > + <div id="content"> > + <div id="header"><a href="/"><h1 id="logo"><span>Apache > Wicket</span></h1></a></div> > + <div id="navigation"> > + <h5><a name="Navigation-Wicket"></a>Meet Wicket</h5> > + <ul> > + <li> > + <a href="/" title="Index">Home</a> > + </li> > + <li> > + <a href="/meet/introduction.html" > title="Introduction">Introduction</a> > + </li> > + <li> > + <a href="/meet/features.html" > title="Features">Features</a> > + </li> > + <li> > + <a href="/meet/buzz.html" title="Buzz">Buzz</a> > + </li> > + <li> > + <a href="/meet/vision.html" title="Vision">Vision</a> > + </li> > + <li> > + <a href="/meet/blogs.html" title="Blogs">Blogs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-GettingStarted" > id="Navigation-GettingStarted"></a>Get Started > + </h5> > + <ul> > + <li> > + <a href="/start/download.html" title="Download > Wicket">Download Wicket</a> > + </li> > + <li> > + <a href="/start/quickstart.html" title="Getting > started via a Maven Archetype">Quickstart</a> > + </li> > + <li> > + <a href="http://www.jweekend.com/dev/LegUp"; > rel="nofollow">More archetypes</a> > + </li> > + <li> > + <a href="/help" title="Get help">Get help</a> > + </li> > + <li> > + <a href="/help/email.html" title="Wicket Mailing > Lists">Mailing Lists</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Documentation" > id="Navigation-Documentation"></a>Learn > + </h5> > + <ul> > + <li> > + <a href="/start/userguide.html" title="User > Guide">User Guide</a> > + </li> > + <li> > + <a href="/learn/examples" > title="Examples">Examples</a> > + </li> > + <li> > + <a > href="http://www.wicket-library.com/wicket-examples/compref/";>Components</a> > + </li> > + <li> > + <a href="/learn/projects/" title="Projects extending > basic Wicket">Projects</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET";>Wiki</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Reference+library";>Reference > guide</a> > + </li> > + <li> > + <a href="/learn/books" title="Books">Books</a> > + </li> > + <li> > + <a href="/learn/ides.html" title="IDEs">IDEs</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Releases" > id="Navigation-Releases"></a>Releases > + </h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/6.19.0";>Wicket 6.19</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.5.13";>Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.4.23";>Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/1.3.7";>Wicket 1.3</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.2"; > class="external-link" rel="nofollow">Wicket 1.2</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.1"; > class="external-link" rel="nofollow">Wicket 1.1</a> > + </li> > + <li> > + <a href="http://wicket.sf.net/wicket-1.0"; > class="external-link" rel="nofollow">Wicket 1.0</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Docs" id="Navigation-Docs"></a>API Docs > + </h5> > + <ul> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/6.x/"; title="JavaDocs of > Apache Wicket 6.x">Wicket 6.x</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.5.x/"; title="JavaDocs of > Apache Wicket 1.5.x">Wicket 1.5</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.4.x"; title="JavaDocs of > Apache Wicket 1.4.x">Wicket 1.4</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/1.3.x"; title="JavaDocs of > Apache Wicket 1.3.x">Wicket 1.3</a> > + </li> > + </ul> > + <h5>Wicket 7.x</h5> > + <ul> > + <li> > + <a > href="http://www.apache.org/dyn/closer.cgi/wicket/7.0.0-M5";>Download M5</a> > + </li> > + <li> > + <a > href="https://cwiki.apache.org/confluence/display/WICKET/Migration+to+Wicket+7.0";>Migration > guide</a> > + </li> > + <li> > + <a > href="http://ci.apache.org/projects/wicket/apidocs/7.x/"; title="JavaDocs of > Apache Wicket 7.x">API Docs 7.x</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Developers" > id="Navigation-Developers"></a>Contribute > + </h5> > + <ul> > + <li> > + <a href="/contribute/write.html" title="Writing > documentation">Writing docs</a> > + </li> > + <li> > + <a href="/contribute/build.html" title="Building from > SVN">Build Wicket</a> > + </li> > + <li> > + <a href="/contribute/patch.html" title="Provide a > patch">Provide a patch</a> > + </li> > + <li> > + <a href="/contribute/release.html" title="Release > Wicket">Release Wicket</a> > + </li> > + <li> > + <a > href="https://fisheye6.atlassian.com/browse/wicket-git"; title="Git Overview" > class="external-link" rel="nofollow">Fisheye</a> > + </li> > + </ul> > + <h5> > + <a name="Navigation-Apache" id="Navigation-Apache"></a>Apache > + </h5> > + <ul> > + <li> > + <a href="http://www.apache.org/"; > class="external-link" rel="nofollow">Apache</a> > + </li> > + <li> > + <a href="http://www.apache.org/licenses/"; > class="external-link" rel="nofollow">License</a> > + </li> > + <li> > + <a > href="http://www.apache.org/foundation/sponsorship.html"; > class="external-link" rel="nofollow">Sponsorship</a> > + </li> > + <li> > + <a href="http://apache.org/foundation/thanks.html"; > class="external-link" rel="nofollow">Thanks</a> > + </li> > + <li> > + <a href="/apache/friends.html" title="Apache projects > using Wicket">Friends</a> > + </li> > + </ul> > +</div> > + > + <div id="contentbody"> > + <h1>Wicket User Guide</h1> > + <p>The user guide has been written using the doc > engine from Grails project and is available in the following formats:</p> > + > +<ol> > + <li>Wicket 7.x > + <ul> > + <li><a > href="http://ci.apache.org/projects/wicket/guide/7.x/";>HTML</a></li> > + <li><a > href="http://ci.apache.org/projects/wicket/guide/7.x/guide/single.html";>HTML > (single page)</a></li> > + <li><a > href="http://ci.apache.org/projects/wicket/guide/7.x/guide/single.pdf";>PDF</a></li> > + </ul> > + </li> > + <li>Wicket 6.x > + <ul> > + <li><a > href="http://ci.apache.org/projects/wicket/guide/6.x/";>HTML</a></li> > + <li><a > href="http://ci.apache.org/projects/wicket/guide/6.x/guide/single.html";>HTML > (single page)</a></li> > + <li><a > href="http://ci.apache.org/projects/wicket/guide/6.x/guide/single.pdf";>PDF</a></li> > + </ul> > + </li> > +</ol> > + > +<p>For more details about the format used to write the guide and to know how > to contrinute, see <a > href="http://ci.apache.org/projects/wicket/guide/6.x/guide/contributing.html";>the > relative chapter</a>.</p> > + > + </div> > + <div id="clearer"></div> > + <div id="footer"><span> > +Copyright © 2015 — The Apache Software Foundation. Apache Wicket, > +Wicket, Apache, the Apache feather logo, and the Apache Wicket project logo > +are trademarks of The Apache Software Foundation. All other marks mentioned > +may be trademarks or registered trademarks of their respective owners. > +</span></div> > + > + </div> > +</div> > +</body> > +</html> > -- Become a Wicket expert, learn from the best: http://wicketinaction.com
