18 Jan
2012
18 Jan
'12
5:56 p.m.
On Jan 18, 2012, at 5:50 PM, Thomas Mortagne wrote:
Hi devs,
Right now renaming a key is a pain if we don't want to loose the
existing translations associated to it. Basically it require to rename
the key in all languages and reimport all of them on l10n.xwiki.org.
We already have a section in the translation file to indicate which
translations are deprecated. The idea is to indicate what is the new
name of a deprecated translation key directly in the translation file
so that l10n.xwiki.org can automatically copy the translation to the
new key when it find a new deprecated key while importing default
translation file.
For that we need to decide a syntax to indicate what is the new name of the key.
I propose to do something similar to java and indicate it in a comment
like the following:
new.key.name=Default translation
#@deprecated new.key.name
old.key.name=Default translation
Here are some other alternatives to "deprecated":
* replacedBy
* new
others ?
Here is my +1 for "deprecated", more intuitive for Java developers and
it's clear it's a deprecated translation key.
+1 too for @deprecated (even though @replacedBy is more precise in its meaning)
Thanks
-Vincent
FWIW, here's an real life example I have locally for this:
#######################################
## until 3.4
#######################################
#@deprecated platform.livetable.results
xe.livetable.results=Livetable Results
#@deprecated platform.livetable.resultsMacros
xe.livetable.resultsmacros=Livetable Results Macros
#@deprecated platform.livetable.actions.delete
xe.livetable._actions.delete=delete
#@deprecated platform.livetable.actions.rename
xe.livetable._actions.rename=rename
#@deprecated platform.livetable.actions.rights
xe.livetable._actions.rights=rights
#@deprecated platform.livetable.actions.copy
xe.livetable._actions.copy=copy
#@deprecated platform.livetable.filtersTitle
xe.livetable.filters.title=Filter for the {0} column
#@deprecated platform.livetable.loading
xe.livetable.loading=Loading...
#@deprecated platform.livetable.tagsHelp
xe.livetable.tags.help=Click on one or more tags to filter the list
#@deprecated platform.livetable.tagsHelpCancel
xe.livetable.tags.help.cancel=and click again on a tag to cancel the filter
#@deprecated platform.livetable.environmentCannotLoadTableMessage
xe.livetable.environmentCannotLoadTableMessage=The environment prevents the table from
loading data.
#@deprecated platform.livetable.pagesizeLabel
xe.livetable.pagesize.label=per page of
#@deprecated platform.livetable.selectAll
xe.livetable.select.all=All