Chapter 13. The Maven Skin

Table of Contents

13.1. Source Code Repository
13.2. Build the Skin
13.3. Deploying the Skin
13.3.1. Prerequisites
13.3.2. Deploy
13.4. Using the Skin

Abstract

This chapter describes how to release the Maven skin. It is only applicable if you have been given admin permissions to release code for the Star Objects project. If you are contributing site documentation to other sister projects then you probably want to look at Chapter 8, Writing Site Documentation (which will reference this site skin from its released location).

Maven provides the ability to automatically create a website holding various reports, such as Checkstyle, PMD, test results and code coverage. Furthermore this site can be skinned using an artifact which provides a set of CSS styles and supporting icons.

So that there is a common look-n-feel for sister projects, we use a single Maven skin. Like the corporate POM, this is managed under the Star Objects project, and is released to the Star Objects Maven repository on the web. Generally then the sister projects simply pick up the skin from this repository.

This part of the document describes how to build this skin. It is applicable only for those (such as administrators) who will be modifying and re-releasing the skin itself.

13.1. Source Code Repository

The Maven skin resides in the Star Objects sourceforge repository under trunk/skin. Use Subversion to check out:

svn co https://starobjects.svn.sourceforge.net/svnroot/starobjects/trunk/skin ~/starobjects/trunk/skin