How To Build GeoMOOSE from source ================================= These instructions apply to the GeoMOOSE 2.6 series. You will need to rebuild GeoMOOSE from source if you make any changes to the core code. This is because the core code is optimized and minified using the Dojo build system and the output is placed in the htdocs/build directory. geomoose.html is set to use this optimized build because it allow for much faster application load times than using the raw source. While developing, you may find it more convenient to use geomoose_dev.html which bypasses the build system and uses the raw JavaScript sources. Note: These instructions require you to run the Dojo build system. For now, this means you will need access to a Linux like command line (bash) and have Java or OpenJDK installed in your path. This works trivially on Linux and OS X, and probably works from within Cygwin on Windows, but this has not been tested. The GeoMOOSE documentation is maintained using reStructured text (http://sphinx.pocoo.org/rest.html) and built into HTML or PDF using Sphinx. Thus, to build the GeoMOOSE documentation from source, you will also need Sphinx installed (http://sphinx.pocoo.org). Step 0: Obtain a copy of GeoMOOSE --------------------------------- In can use whatever method you prefer, check out from svn:: svn co https://svn.osgeo.org/geomoose/geomoose2/trunk geomoose-trunk Or extract from a tarball. Step 1: Extract the libraries in libs ------------------------------------- From the GeoMOOSE base directory (e.g. ``geomoose-trunk``):: cd htdocs/libs tar xzf OpenLayers-*.tar.gz tar xzf dojo-*.tar.gz unzip proj4js-1.0.2.zip Next, run patch_dojo.sh to setup the Dojo build system for GeoMOOSE. ./patch_dojo.sh Step 2: Building GeoMOOSE ------------------------- Again, from the GeoMOOSE base directory, change directories to where the Dojo build system lives. Then, run the build. This will rebuild the files in htdocs/build.:: cd htdocs/libs/dojo-1.6.1/util/buildscripts ./build_geomoose2.sh Step 3: Building the GeoMOOSE documentation ------------------------------------------- Again, from the GeoMOOSE base directory, change directories to where the Sphinx source lives. Next, build the source using the supplied Makefile (or make.bat on Windows):: cd sphinx-docs make html