Difference between revisions of "Setup of a new project"

From translatewiki.net
Jump to navigation Jump to search
Line 32: Line 32:
 
TranslateSettings.php needs updated to register the yaml file, possibly new namespace as well if none of the existing ones fit.
 
TranslateSettings.php needs updated to register the yaml file, possibly new namespace as well if none of the existing ones fit.
   
Translating:projectname needs to be created (copy template from Translating:FreeCol) for example.
+
Translating:projectname needs to be created (copy template from [[Translating:FreeCol]]) for example.
 
Logo needs to be in Commons or uploaded to translatewiki.net
 
Logo needs to be in Commons or uploaded to translatewiki.net
   
Description needs to be added to https://translatewiki.net/wiki/Group_descriptions and page marked for translation.
+
Add descriptions to [[Group descriptions]] and mark the page for translation.
   
 
Other misc things:
 
Other misc things:

Revision as of 08:02, 29 September 2016

Verify the project

Requirements and process: Translating:New project for details. Best practices we usually enforce (main pain point): Translating:Localisation for developers.

  • License
  • Quality of strings
  • Message documentation
  • Activity and interest (releases, contact person)
  • File format
  • Push access: ensure push-access is given either to L10n-bot (wikimedia gerrit) or Niklas and Siebrand (GitHub or BitBucket).

Repository configuration

Edit repoconfig.json and repoconfig.commit.json, bin/EXTERNAL-PROJECTS bin/REPONG-PROJECTS in the translatewiki repository.

Also update-externals.sh for myself, not currently in version control.

Read-only mirror link: https://phabricator.wikimedia.org/diffusion/GTWN/

Some documentation exists at Repository management, but it is mostly outdated by the new repong framework, where most projects have already been converted to.

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 letter 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.

Wiki configuration

TranslateSettings.php needs updated to register the yaml file, possibly new namespace as well if none of the existing ones fit.

Translating:projectname needs to be created (copy template from Translating:FreeCol) for example. 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 to Template:Support and relevant categories

See also