Setup of a new project
Verify the project
- Quality of strings
- Message documentation
- Activity and interest (releases, contact person)
- File format
- Commit access for delivering translation updates:
- Wikimedia Gerrit: Give push access to L10n-bot (C+2, V+2 and Submit)
- GitHub: Give push access to @translatewiki (Create and merge commits; pull requests are not supported) [Legacy projects have access for @Nikerabbit and @Siebrand]
- BitBucket: Give push access to Nikerabbit and Siebrand
- Other: Discuss with Nikerabbit and Siebrand
- Read-only mirror link for configuration for currently enabled projects: https://phabricator.wikimedia.org/diffusion/GTWN/
- Repository management (currently quite outdated) may describe details on how to point to the VCS.
Message group configuration
Lots of examples under groups/ in translatewiki repo. Old but mostly still valid documentation: https://www.mediawiki.org/wiki/Help:Extension:Translate/Group_configuration_example
Need some info such as logo and message group description done in the next section.
Choosing a group id:
- Practice is to use lowercase letters with dashes as level separators in case of multiple groups.
- Prefix "out-" is deprecated and should not be used for new projects.
- In case of multiple groups, the aggregate group should get the top level name, i.e. "blockly", and contain all groups named "blockly-*". Suffixes like "-0-all" are deprecated.
- Do not use comma or asterisk or question mark! These have special meaning in places which accept group patterns.
- Also avoid characters which are invalid in MediaWiki titles, as that breaks shortcuts such as Special:MessageGroupStats/foo (which may be used by the people, but not generated by Translate itself).
All message keys should be prefixed with mangler if it is likely that multiple message groups (remember that one file + its translations is one group).
Update TranslateSettings.php to register the yaml file, possibly add a new namespace (if none of the existing ones fit).
Translating:projectname needs to be created (copy template from Translating:FreeCol or other). Logo needs to be in Commons or uploaded to translatewiki.net.
Add descriptions to Group descriptions and mark the page for translation.
Other misc things:
- Add babel templates (this is forgotten very often - the whole thing should be automatized)
- Add support categories and an alias if needed