blob: ff999e098ab24ed536bb2f389a640efdfc516d76 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN" "../../dtd/document-v10.dtd">
<document>
<header>
<title>LinkTranslatorMapAction in Cocoon</title>
<version>0.9</version>
<type>Technical document</type>
<authors>
<person name="Your Name" email="your-email"/>
</authors>
<abstract>This document describes the LinkTranslatorMapAction of Cocoon.</abstract>
</header>
<body>
<s1 title="LinkTranslatorMapAction">
<table>
<tr>
<td>NAME</td><td>link-translator-map</td>
</tr>
<tr>
<td>WHAT</td><td>The <code>LinkTranslatorMapAction</code> component is used
setup a simple link rewriting.
</td>
</tr>
<tr>
<td>TYPE</td><td>Action, Sitemap Component</td>
</tr>
<tr>
<!-- choose Core, the block name, or Scratchpad
depending on where LinkTranslatorMapAction sources live
-->
<td>BLOCK</td><td>Block-Mail/Scratchpad</td>
</tr>
<tr>
<td>CLASS</td><td>org.apache.cocoon.acting.LinkTranslatorMapAction</td>
</tr>
<!-- uncomment folling tr iff LinkTranslatorMapAction is deprecated -->
<!--tr>
<td>DEPRECATED</td><td>Cocoon 2.0, 2.1</td>
</tr-->
<tr>
<td>SINCE</td><td>Cocoon 2.1</td>
</tr>
<tr>
<td>CACHEABLE</td><td>not applicable</td>
</tr>
</table>
</s1>
<s1 title="Description">
<p>
The <code>LinkTranslatorMapAction</code> sets up a simple link rewriting
mapping.
</p>
</s1>
<s1 title="Usage">
<p>
Keeping outbounding links independing from its publishing URI
is a simple usage scenario of <code>LinkTranslatorMapAction</code>.
</p>
<s2 title="Sitemap pipeline examples">
<p>
</p>
<source><![CDATA[
<map:match pattern="mail/*.html">
<map:action type="link-translator-map">
<!-- sitemap parameters -->
<map:parameter name="main.css" value="../main.css"/>
</map:action>
</map:match>
]]></source>
</s2>
<s2 title="Sitemap component configuration example">
<p></p>
<source><![CDATA[
<map:actions...
<map:action name="link-translator-map"
src="org.apache.cocoon.acting.LinkTranslatorMapAction"
logger="sitemap.action.link-translator-map"
/>
...
</map:actions>
...
]]></source>
</s2>
<s2 title="Configuration">
<p>
Explain the sitemap action configuration, options when declaring template action
</p>
</s2>
<s2 title="Setup">
<p>
Explain the sitemap action setup, ie options when using template action
</p>
</s2>
<s2 title="Effect on Object Model and Sitemap Parameters">
<p>
</p>
</s2>
</s1>
<s1 title="Bugs/Caveats">
<p>
Describe limitation, bugs of LinkTranslatorMapAction
</p>
</s1>
<s1 title="History">
<p>
01-05-02: initial creation
</p>
</s1>
<s1 title="Copyright">
<p>
Copyright (C) 1999-2003 The Apache Software Foundation. All rights reserved.
</p>
</s1>
<s1 title="See also">
<p>
Links to related components pages.
</p>
</s1>
</body>
</document>