wicketmessages-maven-plugin

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

License

License

Categories

Categories

Maven Build Tools Wicket User Interface Web Frameworks
GroupId

GroupId

com.pingunaut.maven.plugin
ArtifactId

ArtifactId

wicketmessages-maven-plugin
Last Version

Last Version

0.2.0
Release Date

Release Date

Type

Type

maven-plugin
Description

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

Source Code Management

https://github.com/pingunaut/wicketmessages-maven-plugin.git

Download wicketmessages-maven-plugin

How to add to project

<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
0.1.1
0.1.0
0.0.3
0.0.2
0.0.1