i18n:parserXml

Nom complet :

org.nuiton.i18n:i18n-maven-plugin:4.1:parserXml

Description :

To obtain i18n keys from xml files using the userRulesFiles (and an optional coreRuleFile if any serves your purpose). Note: this goal must always be invoked before the process-resources phase, otherwise all files will be considered as uptodate.

Attributs :

  • Exige un projet Maven pour être exécuté.
  • The goal is not marked as thread-safe and thus does not support parallel builds.
  • Depuis la version : 2.0.
  • S'associe par défaut dans la phase du cycle de vie : generate-resources.

Paramètres requis

Nom Type Depuis Description
<basedir> File 2.0 Default directory where to look for files.
Valeur par défaut : ${basedir}/src/main/resources.
Propriété utilisateur : i18n.xmlBasedir.
<bundles> String 2.0 Locales to treate, separated by comma. Example :
fr_FR,en_GB

Valeur par défaut : fr_FR,en_GB.
Propriété utilisateur : i18n.bundles.
<encoding> String 2.0 Encoding used to load and store properties.
Valeur par défaut : ${project.build.sourceEncoding}.
Propriété utilisateur : i18n.encoding.
<includes> String 2.0 Defines files to parse.
Propriété utilisateur : i18n.xmlIncludes.
<out> File 2.0 Directory where to generate i18n files.
Valeur par défaut : ${basedir}/target/generated-sources/i18n.
Propriété utilisateur : i18n.out.
<outputGetter> String 2.0 Defines the file name of the getter where to put detected i18n keys while getter phase.
Valeur par défaut : xmlUser.getter.
Propriété utilisateur : i18n.outputGetter.
<src> File 2.0 Directory where to find project i18n files.
Valeur par défaut : ${basedir}/src/main/resources/i18n.
Propriété utilisateur : i18n.src.

Paramètres optionnels

Nom Type Depuis Description
<acceptKeyFormat> String 2.5 A regex pattern to accept incoming keys. Only incoming keys which match the pattern will be kept.
Propriété utilisateur : i18n.acceptKeyFormat.
<backupGetter> boolean 1.0.2 Flag to save previous getter in a backup before doing parsing. Note: by default, do not perform backup (but it was here originaly so let it possible...)
Valeur par défaut : false.
Propriété utilisateur : i18n.backupGetter.
<coreRuleFile> String 2.0 Defines an optional files which contain xpath rules to obtain i18n keys in xml files and is defined in plugin.
Propriété utilisateur : i18n.coreRuleFiles.
<cp> File 2.0 Build directory (used to know if files in sources are up-to-date).
Valeur par défaut : ${basedir}/target/classes.
Propriété utilisateur : i18n.cp.
<entries> I18nSourceEntry[] 2.0 Source entries (src+includes+excludes) to process.
Propriété utilisateur : i18n.entries.
<force> boolean 1.2 To force reparse of all sources.
Valeur par défaut : false.
Propriété utilisateur : i18n.force.
<namespaces> Map 2.0 Defines namespaces mapping if needed. Example :
<namespaces>
<s>http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd</s>
</namespaces>

<showTouchedFiles> boolean 0.9 Flag to display touched files while parsing. Note: the value will be always true if verbose is set at true.
Valeur par défaut : ${maven.verbose}.
Propriété utilisateur : i18n.showTouchedFiles.
<silent> boolean 1.0.0-rc-5 Silent flag to see only errors in console.
Valeur par défaut : false.
Propriété utilisateur : i18n.silent.
<strictMode> boolean 2.0 Strict mode to only keep in user i18n detected i18n keys and remove obsolete keys. Note : By default not active. Use this with care since it can delete keys. Moreover if this flag is activated, then all files will be parsed.
Valeur par défaut : false.
Propriété utilisateur : i18n.strictMode.
<treateDefaultEntry> boolean 2.0 To treat default entry offered by the mojo.
Valeur par défaut : true.
Propriété utilisateur : i18n.treateDefaultEntry.
<userRulesFiles> String[] 2.0 Extra rules files to use for detecting i18n keys in xml validation files. Note : If the coreRulesFile is not defined, then you must fill this parameter.
<verbose> boolean 2.0 Verbose flag. Note : if not setted, we used the maven.verbose property.
Valeur par défaut : ${maven.verbose}.
Propriété utilisateur : i18n.verbose.

Détails des paramètres

<acceptKeyFormat>

A regex pattern to accept incoming keys. Only incoming keys which match the pattern will be kept.
  • Type : java.lang.String
  • Depuis : 2.5
  • Exigé : Non
  • Propriété utilisateur : i18n.acceptKeyFormat

<backupGetter>

Flag to save previous getter in a backup before doing parsing. Note: by default, do not perform backup (but it was here originaly so let it possible...)
  • Type : boolean
  • Depuis : 1.0.2
  • Exigé : Non
  • Propriété utilisateur : i18n.backupGetter
  • Défaut : false

<basedir>

Default directory where to look for files.
  • Type : java.io.File
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.xmlBasedir
  • Défaut : ${basedir}/src/main/resources

<bundles>

Locales to treate, separated by comma. Example :
fr_FR,en_GB
  • Type : java.lang.String
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.bundles
  • Défaut : fr_FR,en_GB

<coreRuleFile>

Defines an optional files which contain xpath rules to obtain i18n keys in xml files and is defined in plugin.
  • Type : java.lang.String
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.coreRuleFiles

<cp>

Build directory (used to know if files in sources are up-to-date).
  • Type : java.io.File
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.cp
  • Défaut : ${basedir}/target/classes

<encoding>

Encoding used to load and store properties.
  • Type : java.lang.String
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.encoding
  • Défaut : ${project.build.sourceEncoding}

<entries>

Source entries (src+includes+excludes) to process.
  • Type : org.nuiton.i18n.plugin.parser.I18nSourceEntry[]
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.entries

<force>

To force reparse of all sources.
  • Type : boolean
  • Depuis : 1.2
  • Exigé : Non
  • Propriété utilisateur : i18n.force
  • Défaut : false

<includes>

Defines files to parse.
  • Type : java.lang.String
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.xmlIncludes

<namespaces>

Defines namespaces mapping if needed. Example :
<namespaces>
<s>http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd</s>
</namespaces>
  • Type : java.util.Map
  • Depuis : 2.0
  • Exigé : Non

<out>

Directory where to generate i18n files.
  • Type : java.io.File
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.out
  • Défaut : ${basedir}/target/generated-sources/i18n

<outputGetter>

Defines the file name of the getter where to put detected i18n keys while getter phase.
  • Type : java.lang.String
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.outputGetter
  • Défaut : xmlUser.getter

<showTouchedFiles>

Flag to display touched files while parsing. Note: the value will be always true if verbose is set at true.
  • Type : boolean
  • Depuis : 0.9
  • Exigé : Non
  • Propriété utilisateur : i18n.showTouchedFiles
  • Défaut : ${maven.verbose}

<silent>

Silent flag to see only errors in console.
  • Type : boolean
  • Depuis : 1.0.0-rc-5
  • Exigé : Non
  • Propriété utilisateur : i18n.silent
  • Défaut : false

<src>

Directory where to find project i18n files.
  • Type : java.io.File
  • Depuis : 2.0
  • Exigé : Oui
  • Propriété utilisateur : i18n.src
  • Défaut : ${basedir}/src/main/resources/i18n

<strictMode>

Strict mode to only keep in user i18n detected i18n keys and remove obsolete keys. Note : By default not active. Use this with care since it can delete keys. Moreover if this flag is activated, then all files will be parsed.
  • Type : boolean
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.strictMode
  • Défaut : false

<treateDefaultEntry>

To treat default entry offered by the mojo.
  • Type : boolean
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.treateDefaultEntry
  • Défaut : true

<userRulesFiles>

Extra rules files to use for detecting i18n keys in xml validation files. Note : If the coreRulesFile is not defined, then you must fill this parameter.
  • Type : java.lang.String[]
  • Depuis : 2.0
  • Exigé : Non

<verbose>

Verbose flag. Note : if not setted, we used the maven.verbose property.
  • Type : boolean
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.verbose
  • Défaut : ${maven.verbose}