svn commit: r638523 - /myfaces/trinidad/trunk/src/site/xdoc/devguide/skinning.xml

[jw...@apache.org]

Author: jwaldman
Date: Tue Mar 18 12:28:22 2008
New Revision: 638523

URL: http://svn.apache.org/viewvc?rev=638523&view=rev
Log:
TRINIDAD-1013 add better documentation on what can go into trinidad-skins.xml's style-sheet-name parameter
on trunk

Modified:
    myfaces/trinidad/trunk/src/site/xdoc/devguide/skinning.xml

Modified: myfaces/trinidad/trunk/src/site/xdoc/devguide/skinning.xml
URL: http://svn.apache.org/viewvc/myfaces/trinidad/trunk/src/site/xdoc/devguide/skinning.xml?rev=638523&r1=638522&r2=638523&view=diff
==============================================================================
--- myfaces/trinidad/trunk/src/site/xdoc/devguide/skinning.xml (original)
+++ myfaces/trinidad/trunk/src/site/xdoc/devguide/skinning.xml Tue Mar 18 12:28:22 2008
@@ -226,7 +226,23 @@
         </li>
         <li>
         <b>style-sheet-name</b> - This is your skin's stylesheet name url.
+        We try a few different means to get the style-sheet-name file as an URL object.
+        <p>
+        First, we try to get an URL for the non static urls, that is, urls that could change
+        after the server has started:
+        <ol>
+        <li>
+        If style-sheet-name starts with "http:", "https:", "file:", "ftp:", or "jar:",
+        then we create the URL by calling new java.net.URL(style-sheet-name).</li>
+        <li>
+        Else we create the URL by calling FacesContext's ExternalContext's getResource(style-sheet-name).
+        (we prepend '/' if it isn't already there)
         </li>
+        </ol>
+        If we still don't have an URL, we try to create the style-sheet-name URL using the ClassLoader's getResource.
+        </p>
+        </li>
+
         <li>
         <b>extends</b> - This is how you can extend another skin rather than the default simple skin. Say you like 
         the purple skin but only want to change the font size. You'd extend the purple.desktop skin and