Getting translation strings right/ja: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		このページでは、文字列の作成者（多くはアプリケーション作者と思います）にとっての、翻訳文字列を適切に作成するための基礎的な事項を説明しています。
2	2
3	3		この「翻訳文字列を適切に作成する」とは、翻訳文字列が簡単に修正できるように準備されており、原版が翻訳文字列を用いる条件に合っていることを意味します。
4	4
5	5		（英語版がこの文章のオリジナルなので）このページを書くに当たり、できるだけ言語に中立であろうと勤めていますが、英語を主言語とするものとしての偏りがある可能性もあります。あなたの状況へ当てはまらないものは、自由に修正してください。(また、[[Getting translation strings right\|オリジナル（英語）ページ]] へのフィードバックもお願いします。)
6	6
7	7		### 一般的事項
8	8
9	9		問題を避けるために、元の文字列は正しいことをまず確認してください。この理由は、
10	10
11	11		- 翻訳作業が不必要に難しくなります。「Garbage In, Garbage Out：ゴミを入れると、ゴミが出てくる」原則が完全に当てはまります。
12	12		- 一般的に、元の文字列が翻訳の初期値となるため未翻訳箇所では元の文字列が表示されますので、利用者がその間違いを見つけた場合、悪い印象を与えるかも知れません。
13	13
14	14		したがって、つづり、語句を正確にしてください。不確かな文字は辞書で確認しましょう。
15	15
16	16		また、動作に対する反応などは、一貫した記述で分かりやすくよく知られた単語を利用しましょう。一般的な記述が不確かな場合は、同じようなプログラムが他にあればその動作を参考にすることもよい手段です。他のアプリケーションのヘルプファイルも、特殊用語や説明の仕方についてのよい資料となります。（訳注：私はwindows環境ですので、office（日本語版と英語版）を参考に文字列リソースを作成しています。）
17	17
18	18		語句の選定についても一貫したやり方をしてください。例えば、
19	19
20		-	~~`ファイルを削除（Delete）する？`\~~
21		-	~~`ファイルを消去（Erase）する？`\~~
22		-	~~`ファイルを除外（Remove）する？`\~~
23		-	~~`ファイルを拭い去る（Wipe）？`\~~
24		-	~~`ファイルを抹殺（Zap）する？`~~
	20	+	```text
	21	+	ファイルを削除（Delete）する？
	22	+	ファイルを消去（Erase）する？
	23	+	ファイルを除外（Remove）する？
	24	+	ファイルを拭い去る（Wipe）？
	25	+	ファイルを抹殺（Zap）する？
	26	+	```
25	27
26	28		意味は似ていますが、特に理由が無いのに表現を変えた場合、読み手は間違った解釈をすることがあります。翻訳者はこの間違いを犯しやすく、あるメッセージの正確な文脈（例えば、メッセージの呼び出し元についての情報）を知らなかったり、語句のちょっとした違いを重要な差異として捉え、適切ではない翻訳を選びがちになります。
27	29
28	30		エラーメッセージを出すときは、問題点自身を適切に記述しましょう。問題点の記述とは、エラーメッセージが出たプログラムの状態ではありません（ファイルエラー, 不正な入力など）。　これは、プログラムのデバッグには役立ちますが、ユーザには意味不明です。肩をすくめて無視されるだけならいいですが、あなたの意味不明なアプリケーションを使うのをやめ、他のアプリケーションを探し始めるかもしれません。問題解決につながるメッセージを表示しましょう。
29	31
30	32		また、簡単な分かりやすい書き方を行いましょう。外国語や非常に技術的な用語は、本当の本当に必要なときにのみ使いましょう。
31	33
32	34		多重否定は分かりにくいので、使わないようにしましょう。例えば、
33	35
34		-	~~`This component can not be dropped on non-TControls.`\~~
35		-	~~`このコンポーネントは、非Tcontolにドロップできません。`~~
	36	+	```text
	37	+	This component can not be dropped on non-TControls.
	38	+	このコンポーネントは、非Tcontolにドロップできません。
	39	+	```
36	40
37	41		これは、否定しない文章で書き換えられます。
38	42
39		-	~~`This component can only be dropped on TControls.`\~~
40		-	~~`このコンポーネントは、TControlにのみドロップできます。`~~
	43	+	```text
	44	+	This component can only be dropped on TControls.
	45	+	このコンポーネントは、TControlにのみドロップできます。
	46	+	```
41	47
42	48		こちらのほうが分かりやすいですね。
43	49
44	50		### 技術的項目
45	51
46	52		この節では、既存の翻訳手法などの技術的な項目を説明します。これは、リソース文字列の構築、GNU gettext と format() 関数を含みます。
47	53
48	54		#### リソース文字列と GNU gettext
49	55
50	56		Free Pascalには文字列定数を扱えるようにするいくつかの言語構成体があります。特に、この目的のために導入された "resourcestring" というユニットがあります。
51	57
52	58		詳細は、FPC マニュアルの (prog.pdf, pg. 89ff または [このリンク](http://www.freepascal.org/docs-html/prog/progch9.html#x184-1870009)) の適切な箇所を参照して下さい。
53	59
54	60		GNU gettext は、アプリケーションの翻訳を提供するユーティリティ群です。詳細は、FPC マニュアルの (prog.pdf, pg. 91ff または [このリンク](http://www.freepascal.org/docs-html/prog/progse41.html#x210-2130009.4)) を参照して下さい。
55	61
56	62		注記: GNU gettext の欠点として、単一の元の文字列から多くの翻訳文字列へのマッピングができない点があります。ご注意下さい。
57	63
58	64		#### IDE内のリソース文字列
59	65
60	66		- Lazarus には、文字列定数からリソース文字列を簡単に作るツールがあります。 [[IDE Window: Make ResourceString/ja\|リソース文字列の作成を]]参照してください。
61	67
62	68		- FPC は、各リソース文字列の部分に対して .rst ファイルを生成します。しかし、.rstファイルについての編集ツールはありません。また、Lazarusは自動的に .rst ファイルの .po ファイルを生成することができます。 .po ファイルについては多くの編集ツールがあります。(例えば、 kbabel）
63	69
64	70		パッケージ作成に向けての .po ファイルの生成について、下記の作業を行ってください：
65	71
66		-	~~` * 'languages' や 'local' といった副ディレクトリを生成してください。`\~~
67		-	~~` * パッケージを開き、``オプション -> i18N``、"国際化を有効に"をチェック、PO出力ディレクトリを設定`~~
	72	+	```text
	73	+	* 'languages' や 'local' といった副ディレクトリを生成してください。
	74	+	* パッケージを開き、オプション -> i18N、"国際化を有効に"をチェック、PO出力ディレクトリを設定
	75	+	```
68	76
69	77		次回にパッケージをコンパイルした時に、副ディレクトリに .po ファイルが作成されます。（注: .rst ファイルがパッケージ・ユニットに属する必要があります。そうでない場合、 .rst ファイルはIDEに無視されます。）
70	78
71	79		これはプロジェクトについても同様です。
72	80
73		-	~~` * ``プロジェクト -> プロジェクトオプション -> i18N``、"国際化を有効に"をチェック、PO出力ディレクトリを設定`~~
	81	+	```text
	82	+	* プロジェクト -> プロジェクトオプション -> i18N、"国際化を有効に"をチェック、PO出力ディレクトリを設定
	83	+	```
74	84
75	85		- 例：ドイツ語翻訳の作成: まず、 unit1.po ファイルを unit1.de.po ファイルにコピーします。次に、テキストエディターや .po エディターを用いて、文字列をすべて翻訳してください。
76	86
77	87		- IDEは、インストールされたパッケージ用の .po ファイルがある場合、自動的に読み込みます。例えば、 lazarus/components/projecttemplates/languages/ を見てください。
78	88
79	89		- ToDo: 新しい resourcestrings の追加時に、翻訳された .po ファイルを更新する機能の実装と文書化。
80	90
81	91		- ToDo: 静的にリンクしたパッケージの全 .po ファイルを集める機能の実装と文書化。
82	92
83	93		#### あなたのアプリケーションのリソース文字列
84	94
85	95		リソース文字列の翻訳のために .po ファイルを読み込むことができます。この機能を .lpr ファイルに実装するには:
86	96
87	97		``` pascal
88	98		...
89	99		uses
90	100		...
91	101		Translations, gettext;
92	102
93	103		procedure TranslateLCL;
94	104		var
95	105		PODirectory, Lang, FallbackLang: String;
96	106		begin
97	107		PODirectory:='/path/to/lazarus/lcl/languages/';
98	108		Lang:='';
99	109		FallbackLang:='';
100	110		GetLanguageIDs(Lang,FallbackLang); // in unit gettext
101	111		Translations.TranslateUnitResourceStrings('LCLStrConsts',
102	112		PODirectory+'lclstrconsts.%s.po',Lang,FallbackLang);
103	113		// ... ここに、全ての .po ファイルに対する TranslateUnitResourceStrings 呼び出しを追加する ...
104	114		end;
105	115
106	116		begin
107	117		TranslateLCL;
108	118		Application.Initialize;
109	119		Application.CreateForm(TForm1, Form1);
110	120		Application.Run;
111	121		end.
112	122		```
113	123
114	124		#### format() 関数
115	125
116	126		翻訳において、完全な静的文字列以外を許可するために、sysutilsユニットの [[doc:rtl/sysutils/format.html\|format()]] メソッドを利用できます。 format() は、テキスト内のプレースホルダーを第2パラメーターで置き換えます。
117	127
118	128		（原文：To not only allow completely static strings in translations, you can use the [[doc:rtl/sysutils/format.html\|format()]] method of the sysutils unit. It is able to replace placeholders within a given text by their actual value given as secondary parameter in a set.）
119	129
120	130		例:
121	131
122		-	~~`format('明日は %0:s で、 %1:s でしょう。', ['日曜日', '晴れ'])`~~
	132	+	```text
	133	+	format('明日は %0:s で、 %1:s でしょう。', ['日曜日', '晴れ'])
	134	+	```
123	135
124	136		上記関数は、以下を返します。
125	137
126		-	~~`明日は日曜日で、晴れでしょう。`~~
	138	+	```text
	139	+	明日は日曜日で、晴れでしょう。
	140	+	```
127	141
128	142		ここでは、 %0:s が文字列配列の始めの（インデックスは0）の引数（日曜日）のプレースホルダー、 %1:s が2番目の引数（晴れ）のプレースホルダーとなります。
129	143
130	144		プレースホルダーおよび書式の詳細は、FPCリファレンスマニュアルにあります。
131	145
132	146		format() 関数利用のガイドライン
133	147
134	148		- プレースホルダーにはインデックスを付けましょう。引数の移動が簡単になり、より自然な翻訳が可能になります。
135	149
136	150		- 2つ以上の文字列から文章を構成しないようにしましょう。常にformat()関数を用いて、プレースホルダーを利用した正確な文字列を、実行時に構成してください。翻訳者は常に全ての文を翻訳できるとは限りません。したがって、良い翻訳を行えないかもしれません。考えて見てもください。翻訳データベース内にそのような数百もの文字列があることを...
137	151
138	152		（原文：* Never compose a sentence out of more than one string. Always use the format() method from the sysutils unit to construct the correct string using placeholders during runtime. Translators will usually not be able to reconstruct the whole sentence, therefore not able to give a good translation; only consider that there are often hundreds of such strings within a single translation database...）
139	153
140	154		- 余白を利用した位置あわせはやめましょう。シンプルに、適切な位置にラベルを移動させてください。フォント変更時に問題となるかもしれませんし、翻訳者によって余白が削除される危険性もあります。
141	155
142	156		~~注記: format() は、エスケープされた制御文字(例えば、C言語の "\n" , "\t" など)やなんらかの理由でを翻訳システムとしてGNU gettext (それに基づいたツールはエスケープされていない制御文字を解釈できない) を解釈しないため、プログラムによる改行の挿入が必要になります。~~
143	157
144	158		現バージョンの lazarus では、翻訳された文字列の「\n」および「\t」は newline とタブに置き換えられます。
145	159
146	160		#### 正しい文字セット/コードへ翻訳を変換する
147	161
148	162		例えば、 ISO-8859-1 から UTF-8 へ変換する場合、
149	163
150		-	~~` iconv --from-code=ISO-8859-1 --to-code=UTF-8 oldfile.po > newfile.po`~~
	164	+	```text
	165	+	iconv --from-code=ISO-8859-1 --to-code=UTF-8 oldfile.po > newfile.po
	166	+	```
151	167
152	168		以下の行を、
153	169
154		-	~~` "Content-Type: text/plain; charset=ISO-8859-1\n"`~~
	170	+	``` pascal
	171	+	"Content-Type: text/plain; charset=ISO-8859-1\n"
	172	+	```
155	173
156	174		次のように修正することも忘れないで下さい。
157	175
158		-	~~` "Content-Type: text/plain; charset=UTF8\n"`~~
	176	+	``` pascal
	177	+	"Content-Type: text/plain; charset=UTF8\n"
	178	+	```
159	179
160	180		### 英語に関する項目
161	181
162	182		この節では、特に英語を基本言語とする場合の注意点を説明します。
163	183
164	184		- テキストを出力する場所に十分な広さをとってください。英語は翻訳対象に比較してテキストが短くなりやすい（文字列として）ため、設計時に十分な余白を取るようにしましょう。経験的に、2,3文字の文字列は2倍の広さを取ることが多くあります。文字列が長くなるとこの違いは小さくなります。
165	185
166	186		- 英語の短縮形は避けましょう。ただでさえ短い文字列がさらに短くなることに加え、例えば、表意文字を利用する場合、短縮形がまったく存在しないなどの問題があります。
167	187
168	188		- よく言われることですが、英語の句読法では、記号（full stop（ピリオド）やカンマなど）はその前の語句や、前に語句がない場合（列挙時など）は語句のかたまりの一部になります。特に、セミコロン（；）の後は、続いて空白があるべきです。
169	189
170		-	~~`There was an error ! Please check file settings , compiler settings,... to fix this issue .`~~
	190	+	```text
	191	+	There was an error ! Please check file settings , compiler settings,... to fix this issue .
	192	+	```
171	193
172	194		上記文章は句読法が適当で、見栄えが悪いし読むのも困難です。よくある改行アルゴリズムが空白で改行することを考えてください。　次の行が!やカンマ、ピリオドで始まる可能性もあります。
173	195
174		-	~~`There was an error! Please check file settings, compiler settings, ... to fix this issue.`~~
	196	+	```text
	197	+	There was an error! Please check file settings, compiler settings, ... to fix this issue.
	198	+	```
175	199
176	200		句読法を考慮した場合、上記文章が正しいものとなります。
177	201
178	202		---
179	203		From the Free Pascal wiki, page "Getting translation strings right/ja", as it stood on 2020-02-16 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history