Help:Extension:Translate/Import Translations via CSV

This page describes the feature that allows translators to submit their translations via CSV to an system administrator, and then have it imported. The related Phabricator

= Steps =

Exporting the CSV
First identify the page that you wish to submit translations via CSV. Example page: Development Guidelines.

Go to Special:ExportTranslations and export that page in CSV format in the French (fr) language.

The CSV file exported will be in the following format:




 * Highlight 1 in image - Message definition in the source language
 * Highlight 2 in image - Translations in the exported language. French in this case

Adding translations to the CSV
The file exported in the previous step can be modified to update existing translations or add more translations.

See the image below from the CSV file that has added a translation in Spanish (es), and some in Dutch (nl):



This file can then be given to the administrator to import the translations into the system.

Note

 * Empty translations will be ignored. Translations will not actually be removed if a cell in the CSV is made empty.
 * If no modification is made to a translation no new entries will be added to the translation change history.

Importing translations via CSV
The file received from the translator can be imported via a command line script made available in the translate extension :

The script expects the following parameters:
 * Path to the CSV file
 * - Name of the user performing the import
 * - Edit summary to be used when updating the translations
 * - Actually perform the import. Without this a dry run will be carried out.

Example run
First, a dry run to see what will be imported:

Now perform the actual import: