forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bd...@apache.org
Subject svn commit: r887433 - in /forrest/trunk/site-author: content/xdocs/docs_0_90/your-project.xml status.xml
Date Fri, 04 Dec 2009 23:05:40 GMT
Author: bdube
Date: Fri Dec  4 23:05:40 2009
New Revision: 887433

URL: http://svn.apache.org/viewvc?rev=887433&view=rev
Log:
Issue FOR-1000
Update custom skin documentation to show use of locationmap

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml
    forrest/trunk/site-author/status.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml?rev=887433&r1=887432&r2=887433&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml Fri Dec  4 23:05:40
2009
@@ -1126,30 +1126,41 @@
 <![CDATA[
 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 
-  <xsl:import href="../../../common/xslt/html/document-to-html.xsl"/>
+  <xsl:import href="lm://transform.skin.common.html.document-to-html"/>
 
   ]]><strong>... overrides of default templates ...</strong>
 <![CDATA[ 
 </xsl:stylesheet>]]>
         </source>
         <p>
-          In order to use this feature in your custom skins you must copy the
-          common skin from the forrest distribution into your custom skins
-          directory (from <code>main/webapp/skins/common</code>). This will
-          protect your skin from changes in the Forrest common skin, but you
-          must remember to update this skin in order to take advantage of new
-          features added over time by the Forrest team.
+          Notice the use of the <em>lm</em> protocol in the import statement.
+          The <em>lm</em> protocol directs Forrest to use the
+          <a href="site:v0.90//locationmap">locationmap</a> to resolve the
+          location of the indicated stylesheet. If you trace this
+          call through the sitemap, you will find the following section of
+          <code>main/webapp/locationmap-transforms.xml</code>:
         </p>
-        <note>
-          The above paragraph means that if you do copy an existing skin as this
-          section recomends you will also need to copy the common skin since all
-          existing skins import the common skin.
-        </note>
+        <source>
+<![CDATA[
+    <match pattern="transform.skin.*.*.*">
+      <select>
+        <location src="{properties:skins-dir}/{1}/xslt/{2}/{3}.xsl"/>
+        <location src="{forrest:forrest.context}/skins/{1}/xslt/{2}/{3}.xsl"/>
+      </select>
+    </match>
+]]>
+        </source>
         <p>
-          This is particularly relevant for menu rendering (book-to-menu.xsl),
-          where the common stylesheet does the 'logic' of which item is
-          selected, and over-riding stylesheets define the presentation.
+          This means that the locationmap first checks your project space
+          (according to the <code>${project.skins-dir}</code> property of
+          your <code>forrest.properties</code> file) and, if the file is
+          not found there, it then checks in your installation of Forrest.
         </p>
+        <note>
+          It has been necessary in the past to copy the common skin to
+          your project when creating a custom skin. This is no longer the
+          case.
+        </note>
       </section>
     </section>
     <section id="webapp">

Modified: forrest/trunk/site-author/status.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/status.xml?rev=887433&r1=887432&r2=887433&view=diff
==============================================================================
--- forrest/trunk/site-author/status.xml (original)
+++ forrest/trunk/site-author/status.xml Fri Dec  4 23:05:40 2009
@@ -153,6 +153,10 @@
         Added document to facilitate
         <link href="site:upgrading_09">upgrading to v0.9</link>
       </action>
+<!-- 2009-12 -->
+      <action context="code" type="update" dev="BMD" fixes-bug="FOR-1000">
+        Changed XSLT import statements in skins to use the LocationMap.
+      </action>
 <!-- 2009-11 -->
       <action context="code" type="update" dev="TWW">
         Replaced the custom caching implementation with EHCache in the



Mime
View raw message