Changes between Initial Version and Version 1 of DeveloperGuidelines/Minify

Timestamp:

07/04/13 10:55:35 (12 years ago)

Author:

Fran Boon

Comment:

--

DeveloperGuidelines/Minify

@@ +1 @@
+= Minify =
+Browsers default to only downloading 2 files from the same origin at a time, so many files is very slow on high latency links.
+
+We therefore consolidate into fewer, larger files when running in Production mode.
+
+Although, note that iPhone 3.x cannot cache files larger than 15kb and in iPhone 4 the limit is 25kb. And this is the size before gzipping.
+
+Since GIS is a specialised app which requires many files, it's JS is loaded separately when required.
+
+The build script is {{{static/scripts/tools/build.sahana.py}}}
+
+It needs to be run as a web2py script:
+{{{
+python web2py.py -S eden -M -R applications/eden/static/scripts/tools/build.sahana.py
+}}}
+
+There is also a convenience wrapper for Windows to run this: {{{static/scripts/tools/build.cmd}}}
+
+You must have an internet connection to run the build script unless you have a local version of the Compiler.
+
+Our build process is based on the one used by !OpenLayers
+* http://trac.openlayers.org/wiki/Profiles 
+
+This uses Google's Closure compiler to compress the JS. This is done using their web service, however for !OpenLayers itself we need to download the jar file & place in the tools folder since this is over 1Mb:
+* http://closure-compiler.googlecode.com/files/compiler-latest.zip
+
+!ToDo: Investigate using other options instead:
+* http://developer.yahoo.com/yui/compressor/
+* http://www.crowproductions.de/repos/main/public/packer/jspacker.py
+
+!ToDo: Download/execute scripts asynchronously:
+* Projects/Advanced/Optimisation