[Commits] r621 - in apps/opengeo/geoexplorer/trunk: . build

commits at geoext.org commits at geoext.org
Thu May 7 17:04:10 CEST 2009


Author: ahocevar
Date: 2009-05-07 17:04:09 +0200 (Thu, 07 May 2009)
New Revision: 621

Added:
   apps/opengeo/geoexplorer/trunk/README.TXT
   apps/opengeo/geoexplorer/trunk/build/geoext-license.js
   apps/opengeo/geoexplorer/trunk/build/license.js
   apps/opengeo/geoexplorer/trunk/license.txt
Modified:
   apps/opengeo/geoexplorer/trunk/build/build.cfg
Log:
added license files in build.cfg and readme with build instructions (closes http://projects.opengeo.org/geoext/ticket/138)

Added: apps/opengeo/geoexplorer/trunk/README.TXT
===================================================================
--- apps/opengeo/geoexplorer/trunk/README.TXT	                        (rev 0)
+++ apps/opengeo/geoexplorer/trunk/README.TXT	2009-05-07 15:04:09 UTC (rev 621)
@@ -0,0 +1,71 @@
+=================================
+Running and deploying GeoExplorer
+=================================
+
+Downloading and unpacking Ext JS
+--------------------------------
+GeoExplorer requires version 2.2.x of the Ext JS library.
+
+1. Download Ext JS SDK 2.2.1 from
+   http://www.extjs.com/products/extjs/download.php
+2. Read the Ext JS license page (http://www.extjs.com/products/license.php)
+   and choose the appropriate license for your needs 
+3. Create a folder externals/ext in your geoexplorer root directory
+4. Unpack the downloaded file (ext-2.2.1.zip) to the folder created in step 3
+
+Connecting GeoExplorer to a GeoServer instance
+----------------------------------------------
+The easiest way to run GeoExplorer is to place it in the www folder of a
+GeoServer data dir.
+
+1. Copy the geoexplorer root directory (with Ext JS unpacked as described
+   above) to $GEOSERVER_DATA_DIR/www/
+2. If the path of your GeoServer instance is different than /geoserver, modify
+   the ows setting in debug.html and index.html in your geoexplorer root
+   directory to point to your GeoServer web path
+
+Test GeoExplorer by running the debug version
+---------------------------------------------
+If installed as described above, you should be able to run GeoExplorer by
+pointing your web browser to
+http://localhost:8080/geoserver/www/geoexplorer/debug.html (assuming your
+browser is running on the same machine as your GeoServer instance).
+
+Running GeoExplorer this way is slow because many small JavaScript files will
+be loaded dynamically. Therefore it is recommended to build GeoExplorer as
+described below.
+
+Build GeoExplorer with minified JS files for better performance
+---------------------------------------------------------------
+1. Download and install JSTools following the instructions in README.rst
+   on http://github.com/whitmo/jstools/
+2. Open a console in your geoexplorer/build folder and run
+   ``jsbuild build.cfg -o ../script/``
+2. Now you should have four minified JS files in your geoexplorer/script
+   folder. To try your built version of GeoExplorer, point your browser to
+   http://localhost:8080/geoserver/www/geoexplorer/index.html and enjoy the
+   performance boost.
+
+Removing unneeded directories and files (optional)
+--------------------------------------------------
+If you want a lean installation, you can remove everything except the files
+and folders in the folder tree below:
+
+::
+
+  geoexplorer
+      externals
+          ext
+              adapter
+                  ext
+              resources
+          geoext
+              resources
+          openlayers
+              img
+              theme
+      script
+      theme
+      about.html
+      index.html
+              
\ No newline at end of file

Modified: apps/opengeo/geoexplorer/trunk/build/build.cfg
===================================================================
--- apps/opengeo/geoexplorer/trunk/build/build.cfg	2009-05-07 14:05:49 UTC (rev 620)
+++ apps/opengeo/geoexplorer/trunk/build/build.cfg	2009-05-07 15:04:09 UTC (rev 621)
@@ -1,5 +1,6 @@
 [GeoExt.js]
 root = ../externals/geoext/lib
+license = geoext-license.js
 
 first =
     GeoExt/data/WMSCapabilitiesReader.js
@@ -183,6 +184,7 @@
 
 [OpenLayers.js]
 root = ../externals/openlayers/lib
+license = ../externals/openlayers/build/license.txt
 
 first =
     OpenLayers/SingleFile.js
@@ -223,6 +225,7 @@
 
 [GeoExplorer.js]
 root = ../lib
+license = license.js
 
 first =
     Viewer.js

Added: apps/opengeo/geoexplorer/trunk/build/geoext-license.js
===================================================================
--- apps/opengeo/geoexplorer/trunk/build/geoext-license.js	                        (rev 0)
+++ apps/opengeo/geoexplorer/trunk/build/geoext-license.js	2009-05-07 15:04:09 UTC (rev 621)
@@ -0,0 +1,30 @@
+/*
+Copyright (c) 2008-2009, The Open Source Geospatial Foundation ¹
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Open Source Geospatial Foundation nor the names
+      of its contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+¹ pending approval
+*/

Added: apps/opengeo/geoexplorer/trunk/build/license.js
===================================================================
--- apps/opengeo/geoexplorer/trunk/build/license.js	                        (rev 0)
+++ apps/opengeo/geoexplorer/trunk/build/license.js	2009-05-07 15:04:09 UTC (rev 621)
@@ -0,0 +1,28 @@
+/*
+Copyright (c) 2008-2009, The Open Planning Project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Open Planning Project nor the names
+      of its contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+*/

Added: apps/opengeo/geoexplorer/trunk/license.txt
===================================================================
--- apps/opengeo/geoexplorer/trunk/license.txt	                        (rev 0)
+++ apps/opengeo/geoexplorer/trunk/license.txt	2009-05-07 15:04:09 UTC (rev 621)
@@ -0,0 +1,26 @@
+Copyright (c) 2008-2009, The Open Planning Project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Open Planning Project nor the names
+      of its contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
\ No newline at end of file



More information about the Commits mailing list