[Commits] r1023 - apps/opengeo/geoexplorer/branches/0.1.x/build

[commits at geoext.org]

Author: tschaub
Date: 2009-06-09 00:14:27 +0200 (Tue, 09 Jun 2009)
New Revision: 1023

Added:
   apps/opengeo/geoexplorer/branches/0.1.x/build/readme.txt
Modified:
   apps/opengeo/geoexplorer/branches/0.1.x/build/Makefile
   apps/opengeo/geoexplorer/branches/0.1.x/build/index.html
Log:
Adding a readme for the zip.

Modified: apps/opengeo/geoexplorer/branches/0.1.x/build/Makefile
===================================================================
--- apps/opengeo/geoexplorer/branches/0.1.x/build/Makefile	2009-06-08 21:53:06 UTC (rev 1022)
+++ apps/opengeo/geoexplorer/branches/0.1.x/build/Makefile	2009-06-08 22:14:27 UTC (rev 1023)
@@ -33,7 +33,7 @@
 	cp index.html $(APP_NAME)
 	cp ../about.html $(APP_NAME)
 	cp ../license.txt $(APP_NAME)
-	
+	cp readme.txt $(APP_NAME)
 
 zip: clean app
 	@echo "Archiving the application."

Modified: apps/opengeo/geoexplorer/branches/0.1.x/build/index.html
===================================================================
--- apps/opengeo/geoexplorer/branches/0.1.x/build/index.html	2009-06-08 21:53:06 UTC (rev 1022)
+++ apps/opengeo/geoexplorer/branches/0.1.x/build/index.html	2009-06-08 22:14:27 UTC (rev 1023)
@@ -28,8 +28,31 @@
         <script>
             Ext.BLANK_IMAGE_URL = "theme/app/img/blank.gif";
             var app = new GeoExplorer({
+
+                /**
+                 * The application loads capabilities from a single WMS.  The
+                 * ows value below is an absolute URL for this WMS.  Because the
+                 * application loads capabilities from a different host than the
+                 * one that serves this application, you need to configure a
+                 * proxy to have the application work.
+                 *
+                 * If you have a WMS running on the same origin as this application
+                 * you can use a relative URL and remove the proxy property below.
+                 */
                 ows: "http://demo.opengeo.org/geoserver/wms",
+
+                /**
+                 * If you do not have a WMS running on the same host that serves
+                 * this application, you need to set up a proxy.  For a proxy
+                 * that works with mod_python, see the following:
+                 * http://svn.opengeo.org/util/proxy/proxy.py
+                 *
+                 * If you do have a WMS on the same origin as this application,
+                 * provide a relative URL for the WMS above and comment out this
+                 * proxy property below.
+                 */
                 proxy: "/proxy/?url=",
+
                 map: {
                     layers: [{
                         name: "topp:bluemarble",

Added: apps/opengeo/geoexplorer/branches/0.1.x/build/readme.txt
===================================================================
--- apps/opengeo/geoexplorer/branches/0.1.x/build/readme.txt	                        (rev 0)
+++ apps/opengeo/geoexplorer/branches/0.1.x/build/readme.txt	2009-06-08 22:14:27 UTC (rev 1023)
@@ -0,0 +1,72 @@
+===========
+GeoExplorer
+===========
+
+Running and deploying GeoExplorer
+---------------------------------
+
+These instructions describe how to deploy GeoExplorer assuming you have a copy
+of the application archive (GeoExplorer.zip).
+
+1. Extract the archive to someplace in your web root.
+
+    you at prompt:~/public_html$ unzip GeoExplorer.zip
+
+2. Load the application in your browser (e.g. http://localhost/~you/GeoExplorer).
+
+Note that the inital configuration for the application works off of a remote
+WMS and requires that you have a proxy set up locally.  See the index.html
+source for detail on configuration with a local WMS.
+
+
+Connecting GeoExplorer to a local GeoServer
+-------------------------------------------
+
+The easiest way to run GeoExplorer with GeoServer is to place it in the www
+folder of a GeoServer data dir.
+
+1. Copy the GeoExplorer root directory to $GEOSERVER_DATA_DIR/www/
+
+2. Modify the "ows" configuration value in GeoExplorer/index.html to reflect the
+path to your GeoServer WMS endpoint (usually "/geoserver/wms").
+
+3. Open the debug.html page in a browser (e.g.
+http://localhost:8080/geoserver/www/GeoExplorer)
+
+
+Changing which layers are displayed at startup
+----------------------------------------------
+
+Find the application configuration in index.html.  It should look something like
+the code below (assuming you are running it with a local GeoServer)::
+
+    var app = new GeoExplorer({
+        ows: "/geoserver/wms",
+        map: {
+            layers: [{
+                name: "topp:bluemarble",
+                title: "Global Imagery"
+            }],
+            center: [-96.7, 37.6],
+            zoom: 4
+        }
+    });
+
+If you want to add the "topp:states" layer to the layers that are initially
+displayed, edit your application config to read something like the code below::
+
+    var app = new GeoExplorer({
+        ows: "/geoserver/wms",
+        map: {
+            layers: [{
+                name: "topp:bluemarble",
+                title: "Global Imagery"
+            }, {
+                name: "topp:states",
+                title: "US States"
+            }],
+            center: [-96.7, 37.6],
+            zoom: 4
+        }
+    });
+