Augment Transformer
The AugmentTransformer
augments all href attributes with the full path to the request.
If a href is already a full HTTP URL, or HTTPS URL the value of
href is not changed.
The AugmentTransformer has serveral configuration options. These options
may be specified by each request.
-
mount -
- If this request parameter is specified it defines the URI relative
to the servlet's context-path. If no mount parameter is specified the
resolution is calculated relative to the request URI.
-
Name : augment
-
Class: org.apache.cocoon.transformation.AugmentTransformer
-
Cacheable: no.
A simple example might help to use the AugmentTransformer effectivly:
Add the AugmentTransformer to the components in your sitemap.xmap
 |  |  |
 |
...
<map:components>
...
<map:transformers default="xslt">
...
<map:transformer name="augment"
src="org.apache.cocoon.transformation.AugmentTransformer">
</map:transformer>
...
|  |
 |  |  |
Next define in your pipeline to use the AugmentTransformer
 |  |  |
 |
<map:match pattern="**book-**.xml">
<map:generate src="docs/{1}book.xml"/>
<map:transform type="augment">
<map:parameter name="mount" value="samples/flow/"/>
</map:transform>
...
|  |
 |  |  |
In the example above all href attributes which do not start with http , or
https are augmented.
Assuming Cocoon is deployed at http://localhost:8080/cocoon a
href href="overview.html" is augmented
to href="http://localhost:8080/cocoon/samples/flow/overview.html" .
|