forrest-site-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r1550142 - in /forrest/site: abs-linkmap abs-menulinks docs_0_100/changes.html docs_0_100/changes.rss docs_0_100/changes.xml docs_0_100/faq.html docs_0_100/faq.xml dtdx/document-v13.pdf dtdx/document-v20.pdf
Date Wed, 11 Dec 2013 14:06:32 GMT
Author: crossley
Date: Wed Dec 11 14:06:32 2013
New Revision: 1550142

URL: http://svn.apache.org/r1550142
Log:
 Publish from forrestbot

Modified:
    forrest/site/abs-linkmap
    forrest/site/abs-menulinks
    forrest/site/docs_0_100/changes.html
    forrest/site/docs_0_100/changes.rss
    forrest/site/docs_0_100/changes.xml
    forrest/site/docs_0_100/faq.html
    forrest/site/docs_0_100/faq.xml
    forrest/site/dtdx/document-v13.pdf
    forrest/site/dtdx/document-v20.pdf

Modified: forrest/site/abs-linkmap
URL: http://svn.apache.org/viewvc/forrest/site/abs-linkmap?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/abs-linkmap (original)
+++ forrest/site/abs-linkmap Wed Dec 11 14:06:32 2013
@@ -301,6 +301,7 @@
         <run_port href="docs_0_100/faq.html#run_port"/>
         <single-document href="docs_0_100/faq.html#single-document"/>
         <sitemap-entities href="docs_0_100/faq.html#sitemap-entities"/>
+        <handle-errors href="docs_0_100/faq.html#handle-errors"/>
         <svn-eol-style href="docs_0_100/faq.html#svn-eol-style"/>
         <tab-index href="docs_0_100/faq.html#tab-index"/>
         <cli-xconf href="docs_0_100/faq.html#cli-xconf"/>

Modified: forrest/site/abs-menulinks
URL: http://svn.apache.org/viewvc/forrest/site/abs-menulinks?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/abs-menulinks (original)
+++ forrest/site/abs-menulinks Wed Dec 11 14:06:32 2013
@@ -301,6 +301,7 @@
         <run_port tab="v0_100" href="docs_0_100/faq.html#run_port"/>
         <single-document tab="v0_100" href="docs_0_100/faq.html#single-document"/>
         <sitemap-entities tab="v0_100" href="docs_0_100/faq.html#sitemap-entities"/>
+        <handle-errors tab="v0_100" href="docs_0_100/faq.html#handle-errors"/>
         <svn-eol-style tab="v0_100" href="docs_0_100/faq.html#svn-eol-style"/>
         <tab-index tab="v0_100" href="docs_0_100/faq.html#tab-index"/>
         <cli-xconf tab="v0_100" href="docs_0_100/faq.html#cli-xconf"/>

Modified: forrest/site/docs_0_100/changes.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/changes.html?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/changes.html (original)
+++ forrest/site/docs_0_100/changes.html Wed Dec 11 14:06:32 2013
@@ -547,6 +547,11 @@ document.write("Last Published: " + docu
 <ul>
 <li>
 <img class="icon" alt="add" src="../images/add.jpg">
+        Enable per-project configuration of Cocoon error handling.
+        Added an <a href="../docs_0_100/faq.html#handle-errors">FAQ</a>.
+       Committed by DC. See Issue <a href="http://issues.apache.org/jira/browse/FOR-1245">FOR-1245</a>.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
         Add initial "logo" input plugin to Whiteboard.
         Assist management of project logos and banner images.
         For example, overlay a TM symbol using SVG to create a new image.

Modified: forrest/site/docs_0_100/changes.rss
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/changes.rss?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/changes.rss (original)
+++ forrest/site/docs_0_100/changes.rss Wed Dec 11 14:06:32 2013
@@ -64,6 +64,19 @@
         upgrading to v0.10-dev
       </description></item>
 
+      <item><title>Apache Forrest code add
+          (bug FOR-1245)
+        </title><link>http://forrest.apache.org//changes.html</link><description>code
add
+        by
+        DC
+          (fixes bug FOR-1245)
+        
+        :
+        
+        Enable per-project configuration of Cocoon error handling.
+        Added an FAQ.
+      </description></item>
+
       <item><title>Apache Forrest code update</title><link>http://forrest.apache.org//changes.html</link><description>code
update
         by
         DC
@@ -6822,6 +6835,17 @@
 
         Added document to facilitate
         upgrading to v0.10-dev
+      </description></item><item><title>Apache Forrest code add
+          (bug FOR-1245)
+        </title><link>http://forrest.apache.org//changes.html</link><description>code
add
+        by
+        DC
+          (fixes bug FOR-1245)
+        
+        :
+        
+        Enable per-project configuration of Cocoon error handling.
+        Added an FAQ.
       </description></item><item><title>Apache Forrest code update</title><link>http://forrest.apache.org//changes.html</link><description>code
update
         by
         DC

Modified: forrest/site/docs_0_100/changes.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/changes.xml?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/changes.xml (original)
+++ forrest/site/docs_0_100/changes.xml Wed Dec 11 14:06:32 2013
@@ -6,6 +6,9 @@
           detailed changes.
         </p>
       <section id="code_0.10-dev"><title>Changes to the Code Base</title><ul><li><icon
alt="add" src="../images/add.jpg"/>
+        Enable per-project configuration of Cocoon error handling.
+        Added an <link href="site:faq/handle-errors">FAQ</link>.
+       Committed by DC. See Issue <link href="http://issues.apache.org/jira/browse/FOR-1245">FOR-1245</link>.</li><li><icon
alt="add" src="../images/add.jpg"/>
         Add initial "logo" input plugin to Whiteboard.
         Assist management of project logos and banner images.
         For example, overlay a TM symbol using SVG to create a new image.

Modified: forrest/site/docs_0_100/faq.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/faq.html?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/faq.html (original)
+++ forrest/site/docs_0_100/faq.html Wed Dec 11 14:06:32 2013
@@ -526,7 +526,10 @@ document.write("Last Published: " + docu
 <a href="#sitemap-entities">3.21. How to configure some Cocoon sitemap components,
e.g. output html encoding or doctype?</a>
 </li>
 <li>
-<a href="#svn-eol-style">3.22. Why are there SVN diffs for some documents, even though
they have not changed?</a>
+<a href="#handle-errors">3.22. How to enable Cocoon error handling?</a>
+</li>
+<li>
+<a href="#svn-eol-style">3.23. Why are there SVN diffs for some documents, even though
they have not changed?</a>
 </li>
 </ul>
 </li>
@@ -1767,8 +1770,49 @@ X [0]         /docs_0_80/upgrading_08.ht
           file into your project symbols file and edit the entity declaration.
           Re-start Forrest.
         </p>
+<a name="handle-errors"></a>
+<h3 class="underlined_5">3.22. How to enable Cocoon error handling?</h3>
+<p>
+          When Cocoon encounters an exception then it will present a default
+          page to explain the error. Better error handling can be configured
+          by adding a "map:handle-errors" section to each sitemap from which
+          such exceptions might arise.
+        </p>
+<p>
+          That is easily added directly to your project sitemap for any
+          special processing.
+          However for many cases it needs to be added to the main
+          webapp/sitemap.xmap file.
+        </p>
+<p>
+          Do this by adding a "handle-errors" xml entity to your project
+          "symbols" file (<a href="#sitemap-entities">explained above</a>).
+          For example:
+        </p>
+<pre class="code">
+&lt;!ENTITY handle-errors '
+     &lt;map:handle-errors&gt;
+      &lt;map:select type="exception"&gt;
+       &lt;map:when test="resourceNotFound"&gt;
+         &lt;map:generate type="exception"/&gt;
+         &lt;map:transform src="{lm:transform.exception.text}"&gt;
+           &lt;map:parameter name="type" value="404"/&gt;
+         &lt;/map:transform&gt;
+         &lt;map:serialize type="text" status-code="404"/&gt;
+       &lt;/map:when&gt;
+      &lt;/map:select&gt;
+    &lt;/map:handle-errors&gt;
+'&gt;</pre>
+<p>
+          Some exception selectors are configured in webapp/sitemap.xmap file
+          at the "map:selectors" section.
+          Please send patches for others if you need them to be added.
+        </p>
+<p>
+          See further <a href="http://s.apache.org/b8V">explanation</a>.
+        </p>
 <a name="svn-eol-style"></a>
-<h3 class="underlined_5">3.22. Why are there SVN diffs for some documents, even though
they have not changed?</h3>
+<h3 class="underlined_5">3.23. Why are there SVN diffs for some documents, even though
they have not changed?</h3>
 <p>
           These un-necessary differences happen because the comitter who did 'svn add' for
those files
           did not have their Subversion client configured properly for the "svn:eol-style"
setting.

Modified: forrest/site/docs_0_100/faq.xml
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_100/faq.xml?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
--- forrest/site/docs_0_100/faq.xml (original)
+++ forrest/site/docs_0_100/faq.xml Wed Dec 11 14:06:32 2013
@@ -1056,7 +1056,47 @@ X [0]         /docs_0_80/upgrading_08.ht
           file into your project symbols file and edit the entity declaration.
           Re-start Forrest.
         </p>
-      </section><section id="svn-eol-style"><title>3.22. Why are there
SVN diffs for some documents, even though they have not changed?</title>
+      </section><section id="handle-errors"><title>3.22. How to enable
Cocoon error handling?</title>
+        <p>
+          When Cocoon encounters an exception then it will present a default
+          page to explain the error. Better error handling can be configured
+          by adding a "map:handle-errors" section to each sitemap from which
+          such exceptions might arise.
+        </p>
+        <p>
+          That is easily added directly to your project sitemap for any
+          special processing.
+          However for many cases it needs to be added to the main
+          webapp/sitemap.xmap file.
+        </p>
+        <p>
+          Do this by adding a "handle-errors" xml entity to your project
+          "symbols" file (<link href="#sitemap-entities">explained above</link>).
+          For example:
+        </p>
+        <source xml:space="preserve">
+&lt;!ENTITY handle-errors '
+     &lt;map:handle-errors&gt;
+      &lt;map:select type="exception"&gt;
+       &lt;map:when test="resourceNotFound"&gt;
+         &lt;map:generate type="exception"/&gt;
+         &lt;map:transform src="{lm:transform.exception.text}"&gt;
+           &lt;map:parameter name="type" value="404"/&gt;
+         &lt;/map:transform&gt;
+         &lt;map:serialize type="text" status-code="404"/&gt;
+       &lt;/map:when&gt;
+      &lt;/map:select&gt;
+    &lt;/map:handle-errors&gt;
+'&gt;</source>
+        <p>
+          Some exception selectors are configured in webapp/sitemap.xmap file
+          at the "map:selectors" section.
+          Please send patches for others if you need them to be added.
+        </p>
+        <p>
+          See further <link href="http://s.apache.org/b8V">explanation</link>.
+        </p>
+      </section><section id="svn-eol-style"><title>3.23. Why are there
SVN diffs for some documents, even though they have not changed?</title>
         <p>
           These un-necessary differences happen because the comitter who did 'svn add' for
those files
           did not have their Subversion client configured properly for the "svn:eol-style"
setting.

Modified: forrest/site/dtdx/document-v13.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v13.pdf?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/dtdx/document-v20.pdf
URL: http://svn.apache.org/viewvc/forrest/site/dtdx/document-v20.pdf?rev=1550142&r1=1550141&r2=1550142&view=diff
==============================================================================
Binary files - no diff available.



Mime
View raw message