Solprovider Apache Lenya


		Lenya Process for Displaying Documents

<< Apache Lenya >>
Start
Basics
Contents
Document
XMAPs (Sitemaps)
Nesting
Breakpoints
Usecase Sitemaps
Lenya Process
DocTypes
Variables
Language
Site Design
XSP
Advanced
Search
Flow
CMS GUI
Kupu
Suggestions
Other
Sitemap

This article follows the process Lenya uses to turn standard Lenya documents into HTML with navigation.

It starts in publication-sitemap.xmap:

      <map:match pattern="**.html">

<map:generate src="cocoon:/lenyabody-view/

{page-envelope:publication-id}/{page-envelope:area}/

{page-envelope:document-type}{page-envelope:document-url}"

/>

                 <map:serialize type="html"/>

       </map:match>

Notice the {page-envelope:document-type}. That is when Lenya checks parameter-doctype.xmap to get a value. Each numbered variable is set to the * in the match pattern:
{1} = "view"
{2} = publication-id
{3} = area
{4} = document-type
{5} = document-url with first slash removed.
2, 3, and 4 could (or should) have been added to the code later rather than passed as parameters. Doing it in the match pattern accomplishes:
1. Getting document-type requires some processing, so this calls that code once.
2. It allows shorter names in the src parameters.
3. It confuses everybody because they have to remember which number refers to which variable.
4. It allows other pipelines to call this pipeline overriding these variables. This is very useful for things like my Website Map because they can change the body without repeating the code for formatting.

      <map:match pattern="lenyabody-*/*/*/*/**">

        <map:aggregate element="cmsbody">

          <map:part src="cocoon://navigation/{2}/{3}/breadcrumb/{5}.xml"/>

          <map:part src="cocoon://navigation/{2}/{3}/tabs/{5}.xml"/>

          <map:part src="cocoon://navigation/{2}/{3}/menu/{5}.xml"/>

          <map:part src="cocoon://navigation/{2}/{3}/search/{5}.xml"/>

          <map:part src="cocoon:/lenya-document-{1}/{3}/{4}/{page-envelope:document-path}"/>

        </map:aggregate>

        <map:transform src="xslt/page2xhtml-{4}.xsl"/>

        <map:serialize type="xml"/>

      </map:match>

Skip to the content, since the navigation pulls from other files. The parameters are:

      <map:match pattern="lenya-document-*/*/*/**.xml">

        <map:mount check-reload="true" reload-method="synchron" src="doctypes.xmap" uri-prefix="lenya-document-"/>

      </map:match>

doctypes.xmap
{1} = "view"
{2} = area
{3} = document-type
{4} = document=path with final ".xml" removed

      <map:match pattern="*/*/*/**.xml">

        <map:generate src="content/{2}/{4}.xml"/>

        <map:transform src="xslt/{3}2xhtml.xsl">

          <map:parameter name="rendertype" value="{1}"/>

          <map:parameter name="nodeid" value="{page-envelope:document-node-id}"/>

          <map:parameter name="language" value="{page-envelope:document-language}"/>

        </map:transform>

        <map:serialize type="xml"/>

      </map:match>

This pulls the XML from {pub}/content, and performs a transformation xslt/{document-type}2xhtml.xsl.

Navigation

You probably do not need to understand this, but here is how the navigation XML is generated:

global-sitemap.xmap
The navigation elements come from here, passing the parameters after removing the first.
<map:match pattern="navigation/**">
<map:mount uri-prefix="navigation" src="lenya/navigation.xmap" check-reload="true" reload-method="synchron"/>
</map:match>

navigation.xmap
{1} = publication-id
{2} = area
{3} = navigation element name
{4} = document-url with first slash and final ".xml" removed

    <!-- pattern: {pub-id}/{area}/{nav-element}/{url}.xml -->

    <map:match pattern="*/*/*/**.xml">

      <map:generate src="cocoon:/{1}/{2}/sitetree/{4}.xml"/>

      <map:call resource="fallback-transformation">

        <map:parameter name="publication-id" value="{1}"/>

        <map:parameter name="url" value="{4}"/>

        <map:parameter name="stylesheet" value="{3}"/>

      </map:call>

    </map:match>

The XML source comes from pubs/{publication-id}/content/{area}/sitetree.xml, and is passed through sitetree2nav.xsl:
{1} = publication-id
{2} = area
{3} = document-url with first slash and final ".xml" removed

    <map:match pattern="*/*/sitetree/**.xml">

      <map:generate src="pubs/{1}/content/{2}/sitetree.xml"/>

      <map:call resource="fallback-transformation">

        <map:parameter name="publication-id" value="{1}"/>

        <map:parameter name="url" value="{3}"/>

        <map:parameter name="stylesheet" value="sitetree2nav"/>

      </map:call>    

    </map:match>

<< Usecase Sitemaps

DocTypes >>

Contact Solprovider

Lenya Process for Displaying Documents

Navigation

Paul Ercolino