総エージェント/インストールツール統合

バベルタは統合された setup.py スクリプト、ベース distutils Python標準ライブラリまたはサードパーティに属するパッケージ setuptools 小包です。

Babelが正しくインストールされている場合、これらのコマンドはデフォルトで利用可能であり、 setup.py 使用中です setuptools それがそうです。一般的な旧型を使ったプロジェクトでは distutils 例えば、明示的な登録コマンドが必要である。

from distutils.core import setup
from babel.messages import frontend as babel

setup(
    ...
    cmdclass = {'compile_catalog': babel.compile_catalog,
                'extract_messages': babel.extract_messages,
                'init_catalog': babel.init_catalog,
                'update_catalog': babel.update_catalog}
)

compile_catalog

♪the compile_catalog 命令はGNUに似ている msgfmt ツールは、POファイルからメッセージディレクトリを取得し、バイナリMOファイルにコンパイルするからである。

コマンドが正しくインストールまたは登録されている場合、項目の setup.py スクリプトでは、コマンドを使用することができます：

$ ./setup.py compile_catalog --help
Global options:
  --verbose (-v)  run verbosely (default)
  --quiet (-q)    run quietly (turns verbosity off)
  --dry-run (-n)  don't actually do anything
  --help (-h)     show detailed help message

Options for 'compile_catalog' command:
   ...

このコマンドを実行すると、バイナリMOファイルが生成されます：

$ ./setup.py compile_catalog --directory foobar/locale --locale pt_BR
running compile_catalog
compiling catalog to foobar/locale/pt_BR/LC_MESSAGES/messages.mo

オプション

♪the compile_catalog コマンドは、以下のオプションを受け取ります。

選択権.	説明する.
--domain	注文ファイルを購入するドメイン(デフォルトは小書項目名)
--directory (-d)	基目録の名称
--input-file (-i)	ファイルの名前を入力する
--output-file (-o)	出力ファイルの名前
--locale (-l)	新しいローカル化文字列の領域設定
--use-fuzzy (-f)	“曖昧”の翻訳も含まれています
--statistics	翻訳に関する統計データを印刷する

もし directory 指定されていますが、 output-file いいえ、出力ファイルのデフォルトファイル名は：

<directory>/<locale>/LC_MESSAGES/<domain>.mo

もしそうでなければ input_file そうでもない locale オプションの場合，この命令は，与えられたドメインにマッチするすべての抄録ファイルをベースディレクトリで探し，各ディレクトリを同一ディレクトリ中のMOファイルにコンパイルする.

これらのオプションはコマンドラインで指定することもできますし、 setup.cfg ファイルです。

extract_messages

♪the extract_messages 命令はGNUに匹敵する xgettext プログラム：様々な異なるソースファイルから局所化可能なメッセージを抽出し，収集したメッセージからPO(携帯オブジェクト)テンプレートファイルを生成することができる.

コマンドが正しくインストールまたは登録されている場合、項目の setup.py スクリプトでは、コマンドを使用することができます：

$ ./setup.py extract_messages --help
Global options:
  --verbose (-v)  run verbosely (default)
  --quiet (-q)    run quietly (turns verbosity off)
  --dry-run (-n)  don't actually do anything
  --help (-h)     show detailed help message

Options for 'extract_messages' command:
   ...

このコマンドを実行するとPOテンプレートファイルが生成されます：：

$ ./setup.py extract_messages --output-file foobar/locale/messages.pot
running extract_messages
extracting messages from foobar/__init__.py
extracting messages from foobar/core.py
...
writing PO template file to foobar/locale/messages.pot

方法マッピング

属性指向プロファイルは、ファイルパターンの抽出方法(およびオプション)へのマッピングを指定することができる --mapping-file 選択肢は以上のとおりである.あるいは、マッピングを中で直接構成することもできます setup.py キーワードパラメータを使って setup() 機能：

setup(...

    message_extractors = {
        'foobar': [
            ('**.py',                'python', None),
            ('**/templates/**.html', 'genshi', None),
            ('**/templates/**.txt',  'genshi', {
                'template_class': 'genshi.template:TextTemplate'
            })
        ],
    },

    ...
)

オプション

♪the extract_messages コマンドは、以下のオプションを受け取ります。

選択権.	説明する.
--charset	出力ファイルで使用する文字セット
--keywords (-k)	デフォルト値以外に検索したスペースで区切られたキーワードリスト
--no-default-keywords	デフォルトキーワードは含まれていません
--mapping-file (-F)	プロファイルのパスをマッピングする
--no-location	ファイル名や行番号に位置注釈を含まないでください
--omit-header	タイトルにmsgid“”エントリを含まないでください
--output-file (-o)	出力ファイルの名前
--width (-w)	出力線幅の設定(デフォルト値76)
--no-wrap	出力行幅よりも長いメッセージ行をいくつかの行に分割してはいけない.
--input-dirs	スキャンすべきメールのディレクトリ
--sort-output	ランキング出力を生成する(デフォルトでFalseとする)
--sort-by-file	出力をファイル位置ごとにソートする(デフォルトでFalseとする)
--msgid-bugs-address	メールエラー報告のメールアドレスを設定する
--copyright-holder	出力に著作権者を設定する
--add-comments (-c)	出力ファイルにラベル付きインタプリタ(または前のキーワード行)を置く.複数のマーカをコンマ(，)で区切る

これらのオプションはコマンドラインで指定することもできますし、 setup.cfg ファイルです。後者の場合、上記のオプションは、その部分のエントリとなる [extract_messages] そして、オプション名は、例えば、破れ番号ではなく、下線文字を使用するように変更されます。

[extract_messages]
keywords = _ gettext ngettext
mapping_file = mapping.cfg
width = 80

これは，命令行から命令を呼び出すことに相当し，以下のようになる.

$ setup.py extract_messages -k _ -k gettext -k ngettext -F mapping.cfg -w 80

どのパス名も setup.py ファイルです。ブールオプションの場合は、“true”または“false”値を使用してください。

init_catalog

♪the init_catalog 命令はGNUとほぼ同じだ msginit プログラム：POテンプレートファイル(POT)に基づいて新しい翻訳ディレクトリを作成します。

コマンドが正しくインストールまたは登録されている場合、項目の setup.py スクリプトでは、コマンドを使用することができます：

$ ./setup.py init_catalog --help
Global options:
  --verbose (-v)  run verbosely (default)
  --quiet (-q)    run quietly (turns verbosity off)
  --dry-run (-n)  don't actually do anything
  --help (-h)     show detailed help message

Options for 'init_catalog' command:
  ...

このコマンドを実行するとPOファイルが生成されます：

$ ./setup.py init_catalog -l fr -i foobar/locales/messages.pot \
                         -o foobar/locales/fr/messages.po
running init_catalog
creating catalog 'foobar/locales/fr/messages.po' based on 'foobar/locales/messages.pot'

オプション

♪the init_catalog コマンドは、以下のオプションを受け取ります。

選択権.	説明する.
--domain	注文ファイルを購入するドメイン(デフォルトは小書項目名)
--input-file (-i)	ファイルの名前を入力する
--output-dir (-d)	出力ディレクトリの名前
--output-file (-o)	出力ファイルの名前
--locale	新しいローカル化文字列の領域設定

もし output-dir 指定されていますが、 output-file いいえ、出力ファイルのデフォルトファイル名は：

<output_dir>/<locale>/LC_MESSAGES/<domain>.po

これらのオプションはコマンドラインで指定することもできますし、 setup.cfg ファイルです。

update_catalog

♪the update_catalog 命令はGNUとほぼ同じだ msgmerge プログラム：POテンプレートファイル(POT)に基づいて既存の翻訳ディレクトリを更新する.

コマンドが正しくインストールまたは登録されている場合、項目の setup.py スクリプトでは、コマンドを使用することができます：

$ ./setup.py update_catalog --help
Global options:
  --verbose (-v)  run verbosely (default)
  --quiet (-q)    run quietly (turns verbosity off)
  --dry-run (-n)  don't actually do anything
  --help (-h)     show detailed help message

Options for 'update_catalog' command:
  ...

このコマンドを実行すると、POファイルが更新されます：：

$ ./setup.py update_catalog -l fr -i foobar/locales/messages.pot \
                            -o foobar/locales/fr/messages.po
running update_catalog
updating catalog 'foobar/locales/fr/messages.po' based on 'foobar/locales/messages.pot'

オプション

♪the update_catalog コマンドは、以下のオプションを受け取ります。

選択権.	説明する.
--domain	注文ファイルを購入するドメイン(デフォルトは小書項目名)
--input-file (-i)	ファイルの名前を入力する
--output-dir (-d)	出力ディレクトリの名前
--output-file (-o)	出力ファイルの名前
--locale	新しいローカル化文字列の領域設定
--ignore-obsolete	出力に時代遅れのメッセージを含んではいけない
--no-fuzzy-matching (-N)	ファジィマッチングを使わないでください
--previous	翻訳後のメッセージを保持する以前のmsgid

もし output-dir 指定されていますが、 output-file いいえ、出力ファイルのデフォルトファイル名は：

<output_dir>/<locale>/LC_MESSAGES/<domain>.po

もしそうでなければ input_file そうでもない locale オプションの場合，このコマンドは，与えられたドメインにマッチするすべての抄録ファイルをベースディレクトリで検索し，各ディレクトリを更新する.

これらのオプションはコマンドラインで指定することもできますし、 setup.cfg ファイルです。