Almost every extension's i18n.php file has
/** Message documentation (Message documentation) * @author Some Person */ $messages['qqq'] = array( ...
Why repeat it?
Is it because the header for each language section is "/** French (français)" , so Qqq is being consistent? But the English header is just /** English.
Does some undocumented tool in maintenance/language rely on the format of these headings?
Thanks for any insight.
On 12 June 2013 07:03, S Page spage@wikimedia.org wrote:
Almost every extension's i18n.php file has
/** Message documentation (Message documentation)
- @author Some Person
*/ $messages['qqq'] = array( ...
Why repeat it?
Is it because the header for each language section is "/** French (français)" , so Qqq is being consistent? But the English header is just /** English.
You are on the right track. English language sections are not managed by translatewiki.net (Translate extension) so they retain the original formatting.
For all other languages the tools regenerates the sections from scratch which makes them all use consistent format. I don't see the little repeating a worth of special casing it.
Does some undocumented tool in maintenance/language rely on the format of these headings?
Not there as far as I know, but Translate extension is picky about the formatting of the i18n files. But the language names are ignored on reading, only the language code matters.
-Niklas
On Tue, Jun 11, 2013 at 11:53 PM, Niklas Laxström niklas.laxstrom@gmail.com wrote:
For all other languages the tools regenerates the sections from scratch which makes them all use consistent format.
Ahh, so it more or less doesn't matter what's in the i18n.php section headings since the tools rebuild the file. I expanded this step in https://www.mediawiki.org/wiki/Localisation#Update_of_localisation. I'm not sure it's worth telling people not to worry about something they may never notice :-) .
Another question: I add my name in @author comments to the 'en' and 'qqq' section headings. Should I instead just put it in the doc comments at the top of the file? (I authored the file so obviously I did those sections.) Presumably "the tools" add other names when they generate from translatewiki.
Thanks, it's a huge piece of infrastructure that works so well we don't think about it.
-- =S Page software engineer on E3
On 15 June 2013 00:11, S Page spage@wikimedia.org wrote:
On Tue, Jun 11, 2013 at 11:53 PM, Niklas Laxström niklas.laxstrom@gmail.com wrote:
For all other languages the tools regenerates the sections from scratch which makes them all use consistent format.
Ahh, so it more or less doesn't matter what's in the i18n.php section headings since the tools rebuild the file. I expanded this step in https://www.mediawiki.org/wiki/Localisation#Update_of_localisation. I'm not sure it's worth telling people not to worry about something they may never notice :-) .
Another question: I add my name in @author comments to the 'en' and 'qqq' section headings. Should I instead just put it in the doc comments at the top of the file? (I authored the file so obviously I did those sections.) Presumably "the tools" add other names when they generate from translatewiki.
Usually people add themselves to 'en' and 'qqq' if they bother at all. The tool will add user names from translatewiki.net automatically and retain existing @author tags.
Thanks, it's a huge piece of infrastructure that works so well we don't think about it.
Awesome.
-Niklas
mediawiki-i18n@lists.wikimedia.org