I18nモジュール

このモジュールは、国際化およびローカリゼーション機能を提供します。

使用方法

このモジュールを使用するには、i18n = import('i18n')を実行するだけです。これにより、i18nという名前のオブジェクトのメソッドとして、以下の関数が利用できるようになります。もちろん、i18nという名前は他の名前に置き換えることができます。

i18n.gettext()

gettextローカリゼーションを設定します。このローカリゼーションでは、翻訳が生成され、インストール中に適切な場所に配置されます。1つの位置指定引数を取り、これはgettextモジュールの名前になります。

  • args: pot ファイルを生成するときに xgettext に渡す追加引数のリスト
  • data_dirs: (0.36.0で追加) GETTEXTDATADIRS環境変数に設定されるディレクトリのリスト (gettext 0.19.8以上が必要)。ローカル its ファイルに使用されます。
  • languages: 生成する言語のリスト。0.37.0以降では、これはオプションであり、LINGUASファイルが読み取られます。
  • preset: (0.37.0で追加) 引数のプリセットリストの名前。現在のオプションは'glib'です。値については、ソースを参照してください。
  • install: (0.43.0で追加) falseにした場合、作成した翻訳をインストールしません。
  • install_dir: (0.50.0で追加) デフォルトのインストール場所を上書きします。デフォルトはlocaledirです。

この関数は、メンテナーが使用するためのターゲットも定義します: 注意:これらはソースディレクトリに出力されます。

  • <project_id>-pot: pot ファイルを再生成するためにxgettextを実行します。
  • <project_id>-update-po: 現在の.potファイルから.poファイルを再生成します。
  • <project_id>-gmo: 翻訳をインストールせずにビルドします。

(0.60.0以降) 次を含むリストを返します。

  • 作成された.moファイルのリスト
  • メンテナー-potターゲット
  • メンテナー-update-poターゲット

i18n.merge_file()

msgfmtを使用して翻訳をテキストファイルにマージします。通常のキーワードについては、custom_target()を参照してください。さらに、次のキーワードを受け付けます。

  • output: custom_targetと同じですが、アイテムは1つしか受け付けません。
  • install_dir: custom_targetと同じですが、アイテムは1つしか受け付けません。
  • install_tag: custom_targetと同じですが、アイテムは1つしか受け付けません。
  • data_dirs: (0.41.0で追加) its ファイル用のディレクトリのリスト (i18n.gettext()も参照)
  • po_dir: 翻訳が含まれるディレクトリで、現在のディレクトリからの相対パス
  • type: ファイルのタイプ。有効なオプションは'xml' (デフォルト) と'desktop'です。
  • args: (0.51.0で追加) msgfmt に渡す追加引数のリスト

0.37.0で追加

i18n.itstool_join()

itstoolを使用して翻訳をXMLファイルに結合します。通常のキーワードについては、custom_target()を参照してください。さらに、次のキーワードを受け付けます。

  • output: custom_targetと同じですが、アイテムは1つしか受け付けません。
  • install_dir: custom_targetと同じですが、アイテムは1つしか受け付けません。
  • install_tag: custom_targetと同じですが、アイテムは1つしか受け付けません。
  • its_files: explicitly 使用する ITS ファイルのファイル名 (それ以外の場合は XML 翻訳ルールが自動検出されます)。
  • mo_targets 必須: i18n.gettext() によって返される mo ファイル生成ターゲット。

0.62.0 で追加

検索結果は次のとおりです。