From a065e04d529da1d847b5062a12c46d916408bf32 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 21:46:22 -0500 Subject: update based on https://github.com/mdn/yari/issues/2028 --- files/ja/writing_localizable_code/index.html | 51 ---------------------------- 1 file changed, 51 deletions(-) delete mode 100644 files/ja/writing_localizable_code/index.html (limited to 'files/ja/writing_localizable_code') diff --git a/files/ja/writing_localizable_code/index.html b/files/ja/writing_localizable_code/index.html deleted file mode 100644 index ba20e1df2d..0000000000 --- a/files/ja/writing_localizable_code/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: ローカライズ可能なコードを記述する -slug: Writing_localizable_code -tags: - - Internationalization - - Localization -translation_of: Mozilla/Localization/Writing_localizable_code ---- -

{{ Draft() }}

- -

このページでは、ローカライズを意識した UI コードを扱う際の最善の実践とガイドラインを提供します。Mozilla と拡張機能の開発者を対象としています。

- -

技術的な詳細は XUL_Tutorial:Localization もご覧ください。

- -

ローカライザーについて

- -

ローカライザーと滅多に接しない開発者に向けた、いくつかの注意点:

- - - -

ガイドライン

- -

あなたのコードをより簡単にローカライズするには、従うべきガイドラインがいくつかあります:

- -
-
適切なキー名を選択する
-
キーに選んだ名前は (それが DTD だろうが、属性ファイルだろうが) 説明的でなければなりません。長い変数名と考えましょう。ローカライズした文字列の意味を変える場合、キーも変えます。これは適切なキー名になる可能性が高いでしょうし、変更点が単なるスペル訂正と異なることを、ツールが拾い上げ安くなるでしょう。
-
複合文字列では文法を前提とするのをやめる
-
文をいくつかのキーに分けると、うっかりと文法や文の構造を前提とすることがよくあります。こんな複合文字列はしばしば、翻訳が困難です。複合文字列が必要な時は、翻訳者に "移動する余地" を残してあげてください。適切に複合文字列を使う例は、"Firefox's setting for visited pages"です: 翻訳者は (暗示的に) ぴったりとしたテキストフィールドを配置できるでしょう。
-
プリプロセッサ マクロを使用しない 
-
#if #else #endif #expand を使用しないことを強く推奨します。このルールにはいくつか例外がありますが、一般にローカライズされたファイルは標準に従うべきで、整形にビルド ツールが不要であるべきです。ローカライズされたファイルにビルドする処理を追加したい場合は、l10n@ からフィードバックをリクエストすることを検討してください。多くの場合は、同様に処理をコンテントコードに移動して、l10n 内の別のキー・バリュー・ペアを参照できます。
-
適切なソース ディレクトリ構造を使用 
-
ローカライズできるファイルを正しい場所に置いているかを確認します。最上位階層にディレクトリを追加することは、cvsroot リポジトリ内のモジュール所有権と、ローカライゼーションの簡単さとの間の妥協点です。
-
適切な chrome ディレクトリ構造を使用 
-
あるモジュール mod 用に、ターゲットパスを jar:ab-CD.jar!/locale/ab-CD/mod/foo.dtd とすることは広くテストされていて、は chrome://mod/locale/foo.dtd としてファイルを参照するのに適切な場所です。このようなディレクトリ構造を使うことは、ソースコードのないローカライゼーション処理が簡単になり、特に拡張の作者にとって推奨します。 JAR Manifests を使うと簡単になります。
-
- -

l10n impact

- -

凍結したツリーでは、l10n-impact の変更はチェックインしないというルールがあります。これはどういう意味でしょう？ l10n-impact とは

- - - -

{{ languages( { "de": "de/Lokalisierbaren_Code_schreiben", "en": "en/Writing_localizable_code", "es": "es/Escribir_c\u00f3digo_localizable", "fr": "fr/\u00c9criture_de_code_localisable" } ) }}

-- cgit v1.2.3-54-g00ecf