svn commit: r1178729 - in /incubator/rave/site/trunk/content/rave/documentation: custom-gui.mdtext customizing.mdtext rave-extensions.mdtext

[ja...@apache.org]

Author: jasha
Date: Tue Oct  4 08:58:13 2011
New Revision: 1178729

URL: http://svn.apache.org/viewvc?rev=1178729&view=rev
Log:
RAVE-278 Document how to customise the CSS

Added:
    incubator/rave/site/trunk/content/rave/documentation/custom-gui.mdtext
Modified:
    incubator/rave/site/trunk/content/rave/documentation/customizing.mdtext
    incubator/rave/site/trunk/content/rave/documentation/rave-extensions.mdtext

Added: incubator/rave/site/trunk/content/rave/documentation/custom-gui.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/custom-gui.mdtext?rev=1178729&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/custom-gui.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/documentation/custom-gui.mdtext Tue Oct  4 08:58:13 2011
@@ -0,0 +1,36 @@
+Title: Customize the look and feel
+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.
+
+The look and feel (GUI) of the Rave Portal can be customized to your own preference. The Rave Portal contains a mechanism to easily add your own CSS file(s) which are called after the default.css file.
+
+##1) Get Rave
+
+There are multiple ways to build your custom Rave instance, but the quickest is to use a Maven WAR overlay.  See [Extending Rave](rave-extensions.html) for an example overlay.
+
+##2) Add CSS file(s)
+
+Add you own CSS file(s) to the src/main/webapp/css folder of your extension portal module.
+
+##3) Refer to the new CSS file(s)
+
+ - Create a JSP tag file: src/main/webapp/WEB-INF/tags/custom_css.tag
+ - Add a link to the stylesheet(s)
+
+    <%@ taglib uri="http://java.sun.com/jstl/core_rt" prefix="c"%>
+    <link rel="stylesheet" href="<c:url value="/css/my_custom.css" />" />
+

Modified: incubator/rave/site/trunk/content/rave/documentation/customizing.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/customizing.mdtext?rev=1178729&r1=1178728&r2=1178729&view=diff
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/customizing.mdtext (original)
+++ incubator/rave/site/trunk/content/rave/documentation/customizing.mdtext Tue Oct  4 08:58:13 2011
@@ -24,4 +24,5 @@ You will find guides for extending Rave 
 
   * [Adding a custom application context](custom-app-context.html)
   * [Adding a new Widget Renderer](custom-widget-renderer.html)
-  * [Working with the Script Manager](script-manager.html)
\ No newline at end of file
+  * [Working with the Script Manager](script-manager.html)
+  * [Customize the look and feel](custom-gui.html)
\ No newline at end of file

Modified: incubator/rave/site/trunk/content/rave/documentation/rave-extensions.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/rave-extensions.mdtext?rev=1178729&r1=1178728&r2=1178729&view=diff
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/rave-extensions.mdtext (original)
+++ incubator/rave/site/trunk/content/rave/documentation/rave-extensions.mdtext Tue Oct  4 08:58:13 2011
@@ -47,9 +47,6 @@ Application Security context provided in
   - Login page : This is just to demonstrate that if you have your own login page and style sheets you can copy them to right location and they will be 
 included in portal war along with other rave files. If you will have the same files name as in Rave war, they will be replaced with your version of files.
 
-###Other customizations points in RAVE. 
-
-[See Customizing Rave](./customizing.html)
 
  
 [1]: ../source.html