Decoration

This is a reference for the site decoration descriptor used in Doxia Sitetools, also known as site.xml: it is used to configure a site template (aka skin).

An XSD is available at:

<project xmlns="http://maven.apache.org/DECORATION/1.8.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/DECORATION/1.8.1 http://maven.apache.org/xsd/decoration-1.8.1.xsd"
  name=.. combine.self=.. >
  <bannerLeft>
    <name/>
    <src/>
    <alt/>
    <href/>
    <border/>
    <width/>
    <height/>
    <title/>
  </bannerLeft>
  <bannerRight>
    <name/>
    <src/>
    <alt/>
    <href/>
    <border/>
    <width/>
    <height/>
    <title/>
  </bannerRight>

  <publishDate position=.. format=.. timezone=.. />
  <version position=.. />
  <edit/>
  <poweredBy>
    <logo name=.. href=.. img=.. position=.. alt=.. border=.. width=.. height=.. target=.. title=.. />
  </poweredBy>

  <skin>
    <groupId/>
    <artifactId/>
    <version/>
  </skin>

  <body>
    <head/>
    <links>
      <item name=.. href=.. img=.. position=.. alt=.. border=.. width=.. height=.. target=.. title=.. />
    </links>
    <breadcrumbs>
      <item name=.. href=.. img=.. position=.. alt=.. border=.. width=.. height=.. target=.. title=.. />
    </breadcrumbs>

    <menu name=.. inherit=.. inheritAsRef=.. ref=.. img=.. alt=.. position=.. border=.. width=.. height=.. title=.. >
      <item collapse=.. ref=.. name=.. href=.. img=.. position=.. alt=.. border=.. width=.. height=.. target=.. title=.. >
        <description/>
        <item>...recursion...<item>
      </item>
    </menu>
    <footer/>
  </body>

  <custom/>
</project>

project

The <project> element is the root of the site decoration descriptor.

Attribute Type Since Description
name String The full name of the project.
combine.self String 1.6.0 Whether to inherit configuration from a parent project site descriptor (merge) or not (override).

Default value: merge

Element Type Since Description
bannerLeft Banner Banner logo on the masthead of the site to the left.
bannerRight Banner Banner logo on the masthead of the site to the right.
publishDate PublishDate Modify the date published display properties.
version Version Modify the version published display properties.
edit String 1.8.0 The base url to edit Doxia document sources. In general, ${project.scm.url} value should do the job.
poweredBy/logo* List<Logo> (Many) Powered by logos list.
skin Skin The artifact containing the skin for the site.
body Body The main site content decoration.
custom DOM Custom configuration for use with customized Velocity templates. Data from this field are accessible in Velocity template from $decoration.custom variable as DOM content. Example: $decoration.custom.getChild( 'customElement' ).getValue()

bannerLeft

Banner logo on the masthead of the site.

Element Type Since Description
name String The name of the banner.
src String The source location of an image for the banner.
alt String The alt description for the banner image.
href String The href of a link to be used for the banner image.
border String 1.0.1 The border to use for the banner image.
width String 1.0.1 The width to use for the banner image.
height String 1.0.1 The height to use for the banner image.
title String 1.3.0 The title for the banner image.

bannerRight

Banner logo on the masthead of the site.

Element Type Since Description
name String The name of the banner.
src String The source location of an image for the banner.
alt String The alt description for the banner image.
href String The href of a link to be used for the banner image.
border String 1.0.1 The border to use for the banner image.
width String 1.0.1 The width to use for the banner image.
height String 1.0.1 The height to use for the banner image.
title String 1.3.0 The title for the banner image.

publishDate

Modify display properties for date published.

Attribute Type Since Description
position String Where to place the date published (left, right, navigation-top, navigation-bottom, bottom).

Default value: left

format String Date format to use.

Default value: yyyy-MM-dd

timezone String 1.8.1 The timezone to use. Use system for the default locale for this instance of the Java Virtual Machine. Refer to java.util.TimeZone for details.

Default value: Etc/UTC

version

Modify display properties for version published.

Attribute Type Since Description
position String Where to place the version published (left, right, navigation-top, navigation-bottom, bottom).

Default value: left

logo

Power by logo on the navigation.

Attribute Type Since Description
name String The name to display for the link.
href String The href to use for the link.
img String The source location of an image.
position String 1.0.1 Where to place the image regarding the displayed name (left or right).

Default value: left

alt String 1.0.1 The alt to use for the image.
border String 1.0.1 The border to use for the image.
width String 1.0.1 The width to use for the image.
height String 1.0.1 The height to use for the image.
target String 1.0.1 Where the new document will be displayed when the user follows a link, i.e. _blank opens the new document in a new window.
title String 1.3.0 The title to use for the image.

skin

A skin artifact declaration.

Element Type Since Description
groupId String The skin group ID.
artifactId String The skin artifact ID.
version String The skin version.

body

The main content decoration.

Element Type Since Description
head String 1.7.0 Additional content (like JavaScript) to include in the HEAD block of the generated pages.
links/item* List<LinkItem> (Many) A list of links to display in the navigation.
breadcrumbs/item* List<LinkItem> (Many) A list of breadcrumbs to display in the navigation.
menu* List<Menu> (Many) A list of menus to include in the navigation.
footer String 1.7.0 If present, the contained text will be used instead of the generated copyright text.

item

A link in the navigation.

Attribute Type Since Description
name String The name to display for the link.
href String The href to use for the link.
img String The source location of an image.
position String 1.0.1 Where to place the image regarding the displayed name (left or right).

Default value: left

alt String 1.0.1 The alt to use for the image.
border String 1.0.1 The border to use for the image.
width String 1.0.1 The width to use for the image.
height String 1.0.1 The height to use for the image.
target String 1.0.1 Where the new document will be displayed when the user follows a link, i.e. _blank opens the new document in a new window.
title String 1.3.0 The title to use for the image.

menu

A menu in the navigation.

Attribute Type Since Description
name String The name to display for the menu.
inherit String The way in which the menu is inherited. Can be one of : top, bottom.
inheritAsRef boolean If this is a reference, setting to true means that it will be populated in the project, whereas if it is false, it is populated in the parent and then inherited.

Default value: false

ref String Mark this menu as reference to a pre-defined menu: reports, modules or parent. It will be populated at runtime with corresponding pre-defined content.
img String The source location of an menu image.
alt String 1.0.1 The alt description for the image.
position String 1.0.1 Where to place the image regarding the displayed name (left or right).

Default value: left

border String 1.0.1 The border to use for the menu image.
width String 1.0.1 The width to use for the menu image.
height String 1.0.1 The height to use for the menu image.
title String 1.3.0 The title for the image.
Element Type Since Description
item* List<MenuItem> (Many) A list of menu item.

item

A menu item.

Attribute Type Since Description
collapse boolean Whether to collapse children elements of an item menu (by default).

Default value: false

ref String A reference to a pre-defined menu item, such as a report (specified by the report goal name). Any elements explicitly given override those from the pre-defined reference.
name String The name to display for the link.
href String The href to use for the link.
img String The source location of an image.
position String 1.0.1 Where to place the image regarding the displayed name (left or right).

Default value: left

alt String 1.0.1 The alt to use for the image.
border String 1.0.1 The border to use for the image.
width String 1.0.1 The width to use for the image.
height String 1.0.1 The height to use for the image.
target String 1.0.1 Where the new document will be displayed when the user follows a link, i.e. _blank opens the new document in a new window.
title String 1.3.0 The title to use for the image.
Element Type Since Description
description String A description of the menu item. This is used on any summary pages for a menu.
item* List<MenuItem> (Many) A list of menu item.