Author: carlucci
Date: Tue Apr 3 20:58:16 2012
New Revision: 1309144
URL: http://svn.apache.org/viewvc?rev=1309144&view=rev
Log:
CMS commit to rave by carlucci
Added:
rave/site/trunk/content/documentation/manage-static-resources.mdtext
(with props)
Added: rave/site/trunk/content/documentation/manage-static-resources.mdtext
URL:
http://svn.apache.org/viewvc/rave/site/trunk/content/documentation/manage-static-resources.mdtext?rev=1309144&view=auto
==============================================================================
--- rave/site/trunk/content/documentation/manage-static-resources.mdtext (added)
+++ rave/site/trunk/content/documentation/manage-static-resources.mdtext Tue
Apr 3 20:58:16 2012
@@ -0,0 +1,35 @@
+Title:
+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.
+
+**Managing Static Resources**
+
+Apache Rave uses [wro4j][1] to optimize JavaScript. At build time it uses
Google Closure Compiler to concatenate and minify all of the individual Rave
javascript files into one file called rave_all.min.js
+
+All of the original JavaScript files, along with the minified version, are
bundled into the WAR. Rave uses a Portal Preference to determine if it should
serve out the individual source files, or the single optimized file. By
default, for ease of debugging, Rave serves out the individual scripts. Rave
admins can change the Portal Preference, called javaScriptDebugMode, to
"Disabled" if they want to serve out the optimized file (recommended for
production installations).
+
+Like all other Portal Preferences, changes are effective immediately, making
it useful when you need to debug an issue in a production environment.
+
+*Settings*
+
+Out-of-the box Rave has configured wro4j to use Google Closure Compiler with
SIMPLE_OPTIMIZATIONS. If you would like to change the JavaScript Processor to
use ADVANCED_OPTIMIZATIONS, or another library all-together (such as YUI
Compressor), you can overlay the wro.properties file located in
rave-portal-resources and modify the postProcessors. See the [wro4j][1]
website for more information.
+
+*Future Enhancements*
+
+[wro4j][1] supports a wide variety of JavaScript and CSS related optimization
libraries. As we continue to improve Rave we will look into expanding its use
to CSS as well.
+
+ [1]: http://code.google.com/p/wro4j/
\ No newline at end of file
Propchange: rave/site/trunk/content/documentation/manage-static-resources.mdtext
------------------------------------------------------------------------------
svn:eol-style = native
