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
_______________________________________________
devs mailing list
[email protected]
http://lists.xwiki.org/mailman/listinfo/devs
