Help:Extension:Translate/翻訳をCSV経由でインポート
翻訳者 (メインヘルプページ )
翻訳管理者
システム管理者と開発者
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