wicketmessages-maven-plugin

This is a maven plugin which converts wicket's properties.xml files into an excel file and back.

License	The Apache Software License, Version 2.0
Categories	Maven Build Tools Wicket User Interface Web Frameworks
GroupId	com.pingunaut.maven.plugin
ArtifactId	wicketmessages-maven-plugin
Last Version	0.2.0
Release Date	Jun 27, 2017
Type	maven-plugin
Description	wicketmessages-maven-plugin This is a maven plugin which converts wicket's properties.xml files into an excel file and back.
Source Code Management	https://github.com/pingunaut/wicketmessages-maven-plugin.git

Download wicketmessages-maven-plugin

Filename	Size
wicketmessages-maven-plugin-0.2.0.pom
wicketmessages-maven-plugin-0.2.0.jar	24 KB
wicketmessages-maven-plugin-0.2.0-sources.jar	13 KB
wicketmessages-maven-plugin-0.2.0-javadoc.jar	64 KB

How to add to project

Apache Maven

<plugin>
    <groupId>com.pingunaut.maven.plugin</groupId>
    <artifactId>wicketmessages-maven-plugin</artifactId>
    <version>0.2.0</version>
</plugin>

Dependencies

compile (5)

Group / Artifact	Type	Version
org.apache.maven : maven-plugin-api	jar	3.5.0
org.codehaus.plexus : plexus-utils	jar	3.0.24
org.apache.poi : poi-ooxml	jar	3.16
org.apache.commons : commons-lang3	jar	3.5
commons-io : commons-io	jar	2.5

provided (1)

Group / Artifact	Type	Version
org.apache.maven.plugin-tools : maven-plugin-annotations	jar	3.5

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

wicketmessages-maven-plugin

This is a maven plugin which converts wicket's properties.xml files into an excel file and back.

About

For i18n in our wicket apps, we use *.properies.xml files like described in https://ci.apache.org/projects/wicket/guide/7.x/guide/i18n.html. Unfortunatelly it is a bit hard to keep the xml files synced between different locales. Another problem is that they are often not user friendly enough to be maintained by the business, so developers have to take care about translations by themsevles. To address this problem we use this maven plugin which basically

• scans sources for *.properties.xml files
• merges them into an xlsx file with one column for every locale
• reads updated xlsx and turns it into properties.xml files again

With the Excel file, it's easy to sort and filter keys, spot missing translations, and it's also more comfortable to use for the business department.

Usage

help

shows goals and possible parameters

mvn com.pingunaut.maven.plugin:wicketmessages-maven-plugin:help

listFiles

lists all message files found in your maven project

parameters

• fileExtension default: .properties.xml
• basedir default: ${project.basedir}

mvn com.pingunaut.maven.plugin:wicketmessages-maven-plugin:listFiles

generateXls

merges all message files found in your maven project into one xlsx file ([PROJECT_DIR]/messages.xlsx by default)

parameters

• fileExtension default: .properties.xml
• basedir default: ${project.basedir}
• append default: false
• outputFile default: messages.xlsx

mvn com.pingunaut.maven.plugin:wicketmessages-maven-plugin:generateXls

generateXml

reads translations out of an excel file and writes them back into wicket's properties.xml files.

parameters

• fileExtension default: .properties.xml
• basedir default: ${project.basedir}
• append default: false
• inputFile default: messages.xlsx // the excel file to read messages from

mvn com.pingunaut.maven.plugin:wicketmessages-maven-plugin:generateXml

Versions

Version
0.2.0 Jun 27, 2017
0.1.1 May 8, 2017
0.1.0 Mar 8, 2017
0.0.3 Sep 8, 2016
0.0.2 Jul 25, 2016
0.0.1 Jul 18, 2016