Jump to content

帮助:扩展:翻译:通过CSV翻译/导入翻译

From mediawiki.org
This page is a translated version of the page Help:Extension:Translate/Import Translations via CSV and the translation is 39% complete.

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

步骤

导出CSV

首先确定您希望通过CSV提交翻译的页面。 示例页面:开发指南。

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

向CSV添加翻译

可以修改上一步中导出的文件以更新现有翻译或添加更多翻译。

请参见CSV文件中的下图,该文件添加了西班牙语(ES)和荷兰语(NL)的翻译:

然后,可以将该文件提供给管理员,以便将翻译导入系统。

注意

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

通过CSV导入翻译

The file received from the translator can be imported via a command line script made available in the translate extension importTranslationsFromCsv.php:

The script expects the following parameters:

  • Path to the CSV file
  • --user - Name of the user performing the import
  • --summary - Edit summary to be used when updating the translations
  • --really - 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:

$ php extensions/Translate/scripts/importTranslationsFromCsv.php ~/Projects/html/mediawiki/groups/page-Development\ Guidelines_to_import.csv --user Admin --summary "Importing translations from CSV"

* 3 translation(s) to import for Translations:Development Guidelines/Page display title/en
* 2 translation(s) to import for Translations:Development Guidelines/1/en
* 2 translation(s) to import for Translations:Development Guidelines/2/en
* 2 translation(s) to import for Translations:Development Guidelines/3/en
* 2 translation(s) to import for Translations:Development Guidelines/4/en
* 2 translation(s) to import for Translations:Development Guidelines/5/en

Use option --really to perform the import.

Now perform the actual import:

$ php ./extensions/Translate/scripts/importTranslationsFromCsv.php ~/Projects/html/mediawiki/groups/page-Development\ Guidelines_to_import.csv --user Admin --summary "Importing translations from CSV" --really

* 3 translation(s) to import for Translations:Development Guidelines/Page display title/en
* 2 translation(s) to import for Translations:Development Guidelines/1/en
* 2 translation(s) to import for Translations:Development Guidelines/2/en
* 2 translation(s) to import for Translations:Development Guidelines/3/en
* 2 translation(s) to import for Translations:Development Guidelines/4/en
* 2 translation(s) to import for Translations:Development Guidelines/5/en

Proceeding with import...

(1/6) Imported translations for Translations:Development Guidelines/Page display title/en with 0 failure(s) and 3 successful import(s) ...
(2/6) Imported translations for Translations:Development Guidelines/1/en with 0 failure(s) and 2 successful import(s) ...
(3/6) Imported translations for Translations:Development Guidelines/2/en with 0 failure(s) and 2 successful import(s) ...
(4/6) Imported translations for Translations:Development Guidelines/3/en with 0 failure(s) and 2 successful import(s) ...
(5/6) Imported translations for Translations:Development Guidelines/4/en with 0 failure(s) and 2 successful import(s) ...
(6/6) Imported translations for Translations:Development Guidelines/5/en with 0 failure(s) and 2 successful import(s) ...

Success: Import done