apache > cocoon
 
Font size:      

Augment Transformer (2.1 legacy document)

Warning
This document was copied as is from the Cocoon 2.1 documentation, but has not yet been fully reviewed or moved to its new home.

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".

Comments

add your comments