You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@wookie.apache.org by rg...@apache.org on 2011/09/14 14:38:14 UTC

svn commit: r1170574 - /incubator/wookie/site/trunk/content/wookie/docs/source.mdtext

Author: rgardler
Date: Wed Sep 14 12:38:14 2011
New Revision: 1170574

URL: http://svn.apache.org/viewvc?rev=1170574&view=rev
Log:
Create a download page focussed on developers

Added:
    incubator/wookie/site/trunk/content/wookie/docs/source.mdtext   (with props)

Added: incubator/wookie/site/trunk/content/wookie/docs/source.mdtext
URL: http://svn.apache.org/viewvc/incubator/wookie/site/trunk/content/wookie/docs/source.mdtext?rev=1170574&view=auto
==============================================================================
--- incubator/wookie/site/trunk/content/wookie/docs/source.mdtext (added)
+++ incubator/wookie/site/trunk/content/wookie/docs/source.mdtext Wed Sep 14 12:38:14 2011
@@ -0,0 +1,112 @@
+Title:     Wookie Sourcecode
+Notice:    Licensed to the Apache Software Foundation (ASF) under one
+           or more contributor license agreements.  See the NOTICE file
+           distributed with this work for additional information
+           regarding copyright ownership.  The ASF licenses this file
+           to you under the Apache License, Version 2.0 (the
+           "License"); you may not use this file except in compliance
+           with the License.  You may obtain a copy of the License at
+           .
+             http://www.apache.org/licenses/LICENSE-2.0
+           .
+           Unless required by applicable law or agreed to in writing,
+           software distributed under the License is distributed on an
+           "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+           KIND, either express or implied.  See the License for the
+           specific language governing permissions and limitations
+           under the License.
+
+# Source
+
+If you want to work with source you can either use the latest development
+version from Subversion or you can download the most recent release. We 
+try to keep the development version stable however, for production environments
+we recommend the stable release. Alternatively you might want to work with
+a [binary release][1]
+
+## Getting and building from the latest source code
+
+To build from source follow these summary steps, more details can be found below:
+
+  - Install [Java JDK](http://java.com/en/download/)
+  - Install [Apache Subversion](http://subversion.apache.org/packages.html)
+  - Install [Apache Ant](http://archive.apache.org/dist/ant/binaries/) 
+  - Either checkout Wookie from [SVN](http://svn.apache.org/repos/asf/incubator/wookie/trunk)
+    - svn co http://svn.apache.org/repos/asf/incubator/wookie/trunk wookie
+  - or, download latest stable release (see also [Release Signing Keys][19])
+    -  [apache-wookie-0.9.0-incubating-src.tar.gz][13] [MD5 Checksum][14] [Signature][15]
+    -  [apache-wookie-0.9.0-incubating-src.zip][16] [MD5 Checksum][17] [Signature][18]
+  - Build and run using "ant run"
+  - Visit http://localhost:8080/wookie
+
+We've got some notes on setting up a [development environment][20] for Wookie.
+
+### Building
+
+We use Apache Ant to manage our build process. This makes it really easy to build on any platform.
+
+#### Building on Linux
+
+If you are running Ubuntu Linux the commands you need to carry out a source installation are:
+
+    sudo apt-get install openjdk-6-jdk
+    sudo apt-get install subversion
+    sudo apt-get install ant1.7
+    svn co http://svn.apache.org/repos/asf/incubator/wookie/trunk ~/projects/wookie
+
+Now skip to "Running Wookie" below.
+
+#### Building on Windows
+
+If you are running Windows you need to download and install the following applications:
+
+  - [Java Development Kit][21]
+  - [Apache Subversion][22]
+  - [Apache Ant][23]
+
+Once you've installed those applications you should checkout the source as follows:
+
+    svn co http://svn.apache.org/repos/asf/incubator/wookie/trunk ~/projects/wookie
+
+### Running Wookie
+
+There are various ways of running Wookie, the simplest is to run in standalone mode:
+
+    ant run
+    http://localhost:8080/wookie
+
+For more information and for instruction on how to configure for production environments
+see our page on [Running Wookie](/wookie/docs/developer/running.html)
+
+### Developing Wookie
+
+There are various docs that are useful for developers linked from the left 
+hand menu in the "Development" section.
+
+A good place to start your reading is out page which details how to create your 
+[development environment](/wookie/docs/development/develop.html).
+
+
+  [1]: /docs/downlad.html
+  [2]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/standalone/apache-wookie-0.9.0-incubating-standalone.tar.gz.md5
+  [3]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/standalone/apache-wookie-0.9.0-incubating-standalone.tar.gz.asc
+  [4]: http://www.apache.org/dyn/closer.cgi/incubator/wookie/0.9.0-incubating/binary/standalone/apache-wookie-0.9.0-incubating-standalone.zip
+  [5]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/standalone/apache-wookie-0.9.0-incubating-standalone.zip.md5
+  [6]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/standalone/apache-wookie-0.9.0-incubating-standalone.zip.asc
+  [7]: http://www.apache.org/dyn/closer.cgi/incubator/wookie/0.9.0-incubating/binary/war/apache-wookie-0.9.0-incubating-war.tar.gz
+  [8]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/war/apache-wookie-0.9.0-incubating-war.tar.gz.md5
+  [9]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/war/apache-wookie-0.9.0-incubating-war.tar.gz.asc
+  [10]: http://www.apache.org/dyn/closer.cgi/incubator/wookie/0.9.0-incubating/binary/war/apache-wookie-0.9.0-incubating-war.zip
+  [11]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/war/apache-wookie-0.9.0-incubating-war.zip.md5
+  [12]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/binary/war/apache-wookie-0.9.0-incubating-war.zip.asc
+  [13]: http://www.apache.org/dyn/closer.cgi/incubator/wookie/0.9.0-incubating/source/apache-wookie-0.9.0-incubating-src.tar.gz
+  [14]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/source/apache-wookie-0.9.0-incubating-src.tar.gz.md5
+  [15]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/source/apache-wookie-0.9.0-incubating-src.tar.gz.asc
+  [16]: http://www.apache.org/dyn/closer.cgi/incubator/wookie/0.9.0-incubating/source/apache-wookie-0.9.0-incubating-src.zip
+  [17]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/source/apache-wookie-0.9.0-incubating-src.zip.md5
+  [18]: http://www.apache.org/dist/incubator/wookie/0.9.0-incubating/source/apache-wookie-0.9.0-incubating-src.zip.asc
+  [19]: http://www.apache.org/dist/incubator/wookie/KEYS
+  [20]: /docs/develop.html
+  [21]: http://jdk6.java.net/download.html
+  [22]: http://subversion.apache.org/
+  [23]: http://ant.apache.org/
\ No newline at end of file

Propchange: incubator/wookie/site/trunk/content/wookie/docs/source.mdtext
------------------------------------------------------------------------------
    svn:eol-style = native