Jump to content

Help:Extension:Translate/翻訳をCSV経由でインポート

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

このページでは翻訳者が 訳文を 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