Difference between revisions of "Setup of a new project"

From translatewiki.net
Jump to navigation Jump to search
(link to Gerrit identifier for repo)
Line 10: Line 10:
 
== Repository configuration ==
 
== Repository configuration ==
   
Edit repoconfig.json and repoconfig.commit.json, bin/EXTERNAL-PROJECTS bin/REPONG-PROJECTS in the translatewiki repository. See [[phabricator:rGTWN3f936d51c10a356415f08183ec1d2e5e7680b29a|an example of the needed patch]].
+
Edit repoconfig.json and repoconfig.commit.json, bin/EXTERNAL-PROJECTS bin/REPONG-PROJECTS in the [https://gerrit.wikimedia.org/r/#/admin/projects/translatewiki translatewiki repository]. See [[phabricator:rGTWN3f936d51c10a356415f08183ec1d2e5e7680b29a|an example of the needed patch]].
   
 
Resources:
 
Resources:

Revision as of 23:12, 30 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. See an example of the needed patch.

Resources:

Personal notes:

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

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

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 to Template:Support and relevant categories

See also