Site (Decoration) Descriptor 1.x

Site Descriptor 1.x also referred to as Site Decoration descriptor was the format used with Doxia Sitetools 1.x for site.xml. Its most recent version was 1.8.1 but in general it was evolved in a backwards compatible way (i.e. elements/attributes/semantics introduced in earlier version have not changed in later 1.x versions).

Site Descriptor 2.x

With Doxia Sitetools 2.0 a new Site Descriptor 2.0 was introduced which differs in quite some aspects from the older format and is not backwards compatible. The main differences are:

1. A new root element named site
2. Use of XML attributes instead of XML element content for most elements
3. Consolidation of image elements

Not all elements/attributesfrom Site Descriptor 1.x do still exist in 2.x. Further details in GH issue 263.

Although Site Descriptor 1.x is still supported, it will lead to a deprecation warning during build and doesn't allow to use newer features introduced with Doxia Sitetools 2.x, therefore migration to 2.x is strongly recommended.

How to migrate

One should migrate to the most recent 2.x version, which for Doxia Sitetools 2.1.0 is Site Descriptor 2.1.0.

1. Convert root element from <project ...> to <site ...>
2. Convert default namespace to xmlns="http://maven.apache.org/SITE/2.1.0"
3. Optionally convert schema location to xsi:schemaLocation="http://maven.apache.org/SITE/2.1.0 https://maven.apache.org/xsd/site-2.1.0.xsd"
4. Convert XML values to attributes where appropriate. For details refer to Site Descriptor 1.x and Site Descriptor 2.x.
5. Reference a Skin compatible with descriptor 2.0 (e.g. maven-fluido-skin 2.x).