Skip to content

Acquire the Maven Skin configuration from a Velocity template.

License

Notifications You must be signed in to change notification settings

Bernardo-MG/velocity-config-tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Velocity Config Tool

Acquire the Maven site skin configuration from a Velocity template.

This way any custom setting from the site.xml file can be used when generating the site pages.

It was created to be used by Docs Maven Skin.

Maven Central

[Release docs][site-release] [Development docs][site-develop]

Features

  • No additional configuration, just add the dependency
  • Read Maven Skin data from the custom tag inside a Velocity template
  • Read general Maven Skin data, such as the current page id, easily inside a Velocity template

Acknowledgement

The code comes from adapting the tools includes inside the Reflow Maven Skin.

Usage

The tools are meant to be used through Velocity, by making use of Maven Site autofinder feature. Just include the project as a dependency on any Maven Skin, and then the tool will be accessible.

Having a keywords tag set as follows in the site.xml:

<custom>
   <skinConfig>
      ...
      <keywords>Velocity tool, configuration</keywords>
      ...
   </skinConfig>
</custom>

Just invoke the tool like this:

<html>
   <head>
      ...
      <meta name="keywords" content="$config.keywords.getValue()">
      ...
   </head>
   ...
<html>

And the keywords will be set into the template.

More information can be found in the documentation pages.

Prerequisites

The project has been tested on the following Java versions:

  • JDK 7
  • JDK 8
  • OpenJDK 7

All other dependencies are handled through Maven, and noted in the included POM file.

Installing

The recommended way to install the project is by setting it up as a dependency. To get the configuration information for this check the Maven Central Repository.

If for some reason manual installation is necessary, just use the following Maven command:

$ mvn install

Collaborate

Any kind of help with the project will be well received, and there are two main ways to give such help:

  • Reporting errors and asking for extensions through the issues management
  • or forking the repository and extending the project

Issues management

Issues are managed at the GitHub project issues tracker, where any Github user may report bugs or ask for new features.

Getting the code

If you wish to fork or modify the code, visit the GitHub project page, where the latest versions are always kept. Check the 'master' branch for the latest release, and the 'develop' for the current, and stable, development version.

License

The project has been released under the MIT License.