Help:Extension:Translate/翻訳をCSV経由でインポート
このページでは翻訳者が 訳文を CSV 形式でシステム管理者に提出する方法と、それをインポートする方法を述べます。 タスク T309517
段階
CSVへエクスポート
まずCSV形式を経て翻訳したいページを特定。 サンプルに使用するページ:開発ガイドライン。
Special:ExportTranslations を開き、そのページをフランス語(fr)の CSV 形式でエクスポート。
エクスポートした CSV ファイルは以下の形式のはずです。
- 画像内の強調表示その1 - メッセージを翻訳元言語で定義
- 画像内の強調箇所その2 - 訳文はエクスポート先の言語。この場合はフランス語
翻訳をCSVに追加
前の段階でエクスポートしたファイルは、訳文を作って既存の翻訳の更新改訂や拡張に使えます。
下記の画像はCSVファイルにスペイン語訳(es)とオランダ語訳(nl)が部分ごとに加えてあります。
次の処理としてこのファイルを翻訳管理者に提出、訳文をシステムにインポートするよう依頼します。
注記
- 翻訳の空欄は無視します。 CSV に空きセルがあっても、実際に翻訳が除去されることはありません。
- 翻訳に何も修正を加えないと、翻訳の変更履歴には新しいエントリは増えません。
CSV経由で翻訳をインポート
翻訳者が提出したファイルをインポートするには翻訳拡張機能importTranslationsFromCsv.php
で次のようにコマンドラインのスクリプトを使います:
スクリプトは以下のパラメータを使います。
- CSV ファイルのパス
--user
- インポートした利用者名--summary
- 訳文を更新した時に使う編集要約--really
- 実際のインポート作業をします。さもなければ事前の判断(ドライラン)をします。
作業の例
まず、何をインポートするのか、(ドライランとして)事前に対象を判断します。
$ 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.
ここで実際に以下のようにインポートします。
$ 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