対応するファイル形式#

Weblate supports a wide range of translation formats. Each format is slightly different and provides a different set of capabilities.

ヒント

アプリケーションで使うファイル形式を選択するときは、使用するツールキット/プラットフォームで実績のある形式を使用することをお勧めします。そうすれば、翻訳者は慣れ親しんだツールを追加で使用でき、プロジェクトに貢献する可能性が高まります。

参考

Translation Related File Formats

自動検出#

Weblate tries to detect file format during 翻訳プロジェクトとコンポーネントの追加. The detection might be wrong for different variants of the same serialization format (JSON, YAML, properties) or file encoding, so please verify that ファイル形式 is correct before creating the component.

翻訳の種類別の機能#

ファイル形式が対応するすべての機能#
ファイル形式	ファイル種別 [1]	複数形 [2]	説明 [3]	コンテキスト [4]	文字列位置 [5]	フラグ [8]	追加の状態 [6]
GNU gettext	バイリンガル	yes	yes	yes	yes	yes [9]	要編集
モノリンガルの gettext	モノリンガル	yes	yes	yes	yes	yes [9]	要編集
XLIFF	両方	yes	yes	yes	yes	yes	要編集、承認済
Java プロパティ	両方	no	yes	no	no	no
mi18n 言語ファイル	モノリンガル	no	yes	no	no	no
GWT プロパティ	モノリンガル	yes	yes	no	no	no
Joomla の翻訳	モノリンガル	no	yes	no	yes	no
Qt Linguist .ts	両方	yes	yes	no	yes	yes	要編集
Android 文字列リソース	モノリンガル	yes	yes [7]	no	no	yes
Apple iOS 文字列	両方	no	yes	no	no	no
PHP 文字列	モノリンガル	no [10]	yes	no	no	no
JSON ファイル	モノリンガル	no	no	no	no	no
i18next JSON files	モノリンガル	yes	no	no	no	no
go-i18n JSON ファイル	モノリンガル	yes	yes	no	no	no
gotext JSON ファイル	モノリンガル	yes	yes	no	yes	no
ARB ファイル	モノリンガル	yes	yes	no	no	no
WebExtension JSON	モノリンガル	yes	yes	no	no	no
RESX .NET resource files	モノリンガル	no	yes	no	no	yes
ResourceDictionary ファイル	モノリンガル	no	no	no	no	yes
CSV ファイル	両方	no	yes	yes	yes	no	要編集
YAML ファイル	モノリンガル	no	no	no	no	no
Ruby YAML ファイル	モノリンガル	yes	no	no	no	no
DTD ファイル	モノリンガル	no	no	no	no	no
フラット化した XML ファイル	モノリンガル	no	no	no	no	yes
Windows RC ファイル	モノリンガル	no	yes	no	no	no
Excel Open XML	モノリンガル	no	yes	yes	yes	no	要編集
アプリストアのメタデータファイル	モノリンガル	no	no	no	no	no
字幕ファイル	モノリンガル	no	no	no	yes	no
HTML ファイル	モノリンガル	no	no	no	no	no
OpenDocument 形式	モノリンガル	no	no	no	no	no
IDML 形式	モノリンガル	no	no	no	no	no
INI の翻訳	モノリンガル	no	no	no	no	no
Inno Setup INI の翻訳	モノリンガル	no	no	no	no	no
TermBase eXchange 形式	バイリンガル	no	yes	no	no	yes
テキストファイル	モノリンガル	no	no	no	no	no
Stringsdict 形式	モノリンガル	yes	yes	no	no	no
Fluent 形式	モノリンガル	no [11]	yes	no	no	no

バイリンガル形式とモノリンガル形式#

モノリンガルとバイリンガルの両方の形式に対応しています。バイリンガル形式は一つのファイルの中に二つの言語、原文と翻訳文が保存されます（典型例は GNU gettext、XLIFF や Apple iOS 文字列）。一方、モノリンガル形式は文字列を ID で識別し、それぞれの言語のファイルには各 ID に対応するその言語への翻訳のみが含まれます（典型例は Android 文字列リソース）。ファイル形式によっては、どちらの形式にも使用されます。詳細は、下記の説明で確認してください。

モノリンガルファイルを正しく使用するには、原文とともに翻訳する文字列の完全なリストを含むファイルを編集することが必要です。このファイルは、Weblate 内ではモノリンガル用の、基礎となる言語ファイルと呼ばれますが、命名は項目により変化することがあります。

さらに中間言語ファイルを使用して、開発者が提供するが、最終的には使われない文字列を組み込むようにワークフローを拡張できます。

翻訳フラグ#

Translation flags allow customizing Weblate behavior. Some formats support defining those in the translation file (you can always define them in the Weblate interface, see フラグを使用した動作の設定).

This feature is modelled on flags in GNU gettext.

Additionally, for all XML based format, the flags are extracted from the non-standard attribute weblate-flags. Additionally max-length:N is supported through the maxwidth attribute as defined in the XLIFF standard, see 翻訳フラグの指定.

参考

フラグを使用した動作の設定, PO files documentation

Pluralized strings#

Plurals are necessary to properly localize strings with variable count. The rules depend on a target language and many formats follow CLDR specification for that.

ヒント

Pluralizing strings need proper support from the application framework as well. Choose native format of your platform such as GNU gettext, Android 文字列リソース or Stringsdict 形式.

翻訳禁止の文字列#

バージョン 3.10 で追加.

翻訳ファイル中の翻訳禁止の文字列は Weblate に読み込まれますが、編集はできません。この機能はいくつかのフォーマット（XLIFF および Android 文字列リソース）では公式に対応していますが、その他のフォーマットでは read-only フラグを追加して再現しています（参照: フラグを使用した動作の設定）。

他の形式への対応#

ほとんどの、translate-toolkit に対応するファイル形式では、シリアル化への対応は簡単にできます。（まだ）テストはしていませんが。多くの場合は、translate-toolkit ストレージの動作の違いに対応するため、Weblate に対応させるプログラムの実装が必要です。

新しいファイル形式に対応するには、まず translate-toolkit に対応するプログラムから実装すべきです。

参考

Translation Related File Formats