Changes between Version 1 and Version 2 of TracJa

Timestamp:

Dec 31, 2005, 5:43:43 PM (18 years ago)

Author:

trac

Comment:

--

TracJa

@@ -2 +2 @@
 '''このファイルはオリジナル Trac の配布物には含まれません。'''
 
+Trac-Ja は Trac の日本語ローカライズバージョンです。
+
+
 == Trac の I18N 対応状況 ==
 Trac は Python で記述されているため、内部コードは Unicode です。
-また、 Wiki ページやレポート、チケットなどは SQLite データベースに格納する時点で
+また、 Wiki ページやレポート、チケットなどはデータベースに格納する時点で
 UTF-8 に変換されるため、これらは基本的にオリジナル配布のままでも日本語が使用できます。
 
-添付ファイルやリポジトリブラウザの表示が文字化けする場合、
-Subversion リポジトリに格納するテキストファイルで使用している文字コードを
-TracIni ファイルのパラメータ [trac] default_charset に設定してください。
+添付ファイルやリポジトリブラウザの表示が文字化けする場合、適切な文字コードを
+TracIni ファイルのパラメータ `[trac]` `default_charset` に設定してください:
+{{{
+[trac]
+default_charset = Shift_JIS
+}}}
+大抵の場合、この設定だけで文字化けは解消します。
 
-(ほとんどのプログラムもそうですが)ファイルごとに文字コードが違うという状況は、完全には対応されていません。[[BR]]
-Subversion では svn:mime-type 属性に charset を設定するという手法がありますが、
-Trac ではハンドリングが不完全であるため、プログラムに変更を行う必要があります。[[BR]]
-添付ファイルの文字コードは基本的に default_charset に固定されます。プログラム内でファイルのエンコードを
-iso-8859-15 として解釈している箇所にパッチすれば多少は改善されます。
+Subversion リポジトリに格納しているファイルのエンコードが、ファイルごとに違う場合、
+Subversion 側で各ファイルの `svn:mime-types` 属性に `charset` を
+正しく設定することで解消します (trac-0.8.2 以降):
+{{{
+PROMPT$ svn propset 'svn:mime-type' 'text/x-csrc; charset=Shift_JIS' *.c
+}}}
+
+添付ファイルの文字コードは TracIni の `default_charset` に固定されます。
+
 
 == Trac の L10N 対応状況 ==
 オリジナル配布ではユーザ入力以外の表示メッセージは全て英語です。
 
-プレゼンテーション層の処理が、ほぼ全て templates ディレクトリ配下の !ClearSilver テンプレートに
-集約されているため、テンプレートを変更することで各国語でのメッセージ表示を行うことが出来ます。
-Wiki ページとして同梱されているオンラインマニュアルは、wiki-defaults ディレクトリにある
+プレゼンテーション層の処理は、 `templates` ディレクトリ配下の !ClearSilver テンプレートに
+集約されているのですが、実際に表示される用語などが `trac` ディレクトリ配下の Python コード内に
+ハードコードされているため、 Trac が gettext() などの多言語 API に対応しない限り、
+ソースに直接パッチを行わないと翻訳できません。
+
+Wiki ページとして同梱されているオンラインマニュアルは、 `wiki-default` ディレクトリにある
 ファイルを翻訳すれば地域化することが出来ます。
+(マニュアルについてはロケールを指すディレクトリを作成して、その下にマニュアルを
+置くという [http://projects.edgewall.com/trac/wiki/TracGuideTranslations 案] も出ていましたが、
+差分翻訳が難しいなど実用上に問題があるため放置されています。)
 
-しかし、これらのディレクトリを環境によって切り替える機能がないため、現状では Trac をインストールする
-前にファイル(ディレクトリ)の差し替えをする必要があります。
-また、一部のメッセージは Trac のコード内に直接記述されています。これらは、 Trac が gettext() などの
-言語切り替え機能に対応しない限り、コードに直接パッチをあてなければ日本語化できません。
+レポートやカスタムクエリの検索結果画面での、チケット属性の列名は
+検索に使用した SQL の列名がそのまま表示されます。
+そのため SQL の SELECT 句で `AS` によって列名を日本語化することが出来ます。
+ただし、 `modified` や `description` など特定の用途に使用される列名
+(See TracReports) は変更すると表示形式が変わってしまいます。
 
-レポートの検索結果画面やチケット閲覧画面での、チケット属性名称および属性の値については、
-データベースの列名をそのまま使用している箇所があるため、翻訳することが困難です。
+レポートの検索結果画面やチケット閲覧画面での、チケット属性の値については、
+データベースの値をそのまま使用しているため、一部の属性は翻訳することが困難です。
+ * ステータス (Status): チケットの状態遷移がハードコードされている
+その他の属性は、 `trac-admin` コマンドで変更することで日本語化できますが、
+プロジェクト毎に必要となる用語は異なるでしょうから、 Trac-Ja では翻訳対象と
+していません。
+
 
 == Trac-Ja の概要 ==
-Trac 配布物のうち templates ディレクトリおよび wiki-default ディレクトリのファイルについて、
-日本語への翻訳を行いました。
-ただし表形式で表示の一部の文字列は、レイアウトを維持するために原語のままとしている箇所があります。
+Trac 配布物を日本語に翻訳しました。Trac の用語は TracTermsJa に示した通りとなっています。
+
+配布は [http://www.i-act.co.jp/project/products/products.html InterAct Web サイト公開資料ページ] で
+行っています。
+
+
+== Trac のバグ ==
+オリジナル配布に存在するバグについて記載しておきます。
+
+ * `LC_TIME` にマルチバイト文字が含まれるロケールを使用すると、
+   タイムラインやマイルストーンでの日付入力がエラーになる。[[BR]]
+   ([http://projects.edgewall.com/trac/ticket/2182 本家チケット 2182] に
+   パッチがあります)
+ * utf-8 以外の charset を使用するコンソール (Windowsを含む) では、
+   `trac-admin` コマンドでの非 ASCII 文字の表示が文字化けする。[[BR]]
+   ([http://projects.edgewall.com/trac/ticket/2394 本家チケット 2394] に
+   パッチがあります)
+ * コンポーネント名などに半角空白文字を 2 つ以上続けて書くと動作がおかしくなる。
+ * `priority` を全て削除すると、ロードマップでの iCalendar 出力に
+   スタックトレースが含まれ、不正フォーマットになる。
+ * チケットの概要で 1 文字目の空白文字が削除される。
+   [http://projects.edgewall.com/trac/ticket/2285 本家チケット 2285 参照][[BR]]
+   (trac-0.9.1 で対応されましたが、trac-0.9 で作成したチケットでは、
+   データベース登録時に1文字目の空白文字を削除しているので、この現象は解消されません。）
+ * マルチバイト文字列の折り返しや切り取りで境界文字が文字化けすることがある。
+ * 0.9 で作ったプロジェクト環境では、優先度 (priority) のデフォルト値が
+   0.8.x 以前と異なる。[[BR]]
+   ([http://projects.edgewall.com/trac/ticket/1861 本家チケット 1861] によると、
+   今後はこれがデフォルトになるようです)
+
+これらのバグは、今後のオリジナルのリリースや、 Trac-Ja のリリースで解消されるかもしれませんが、
+現状では修正されていません。
+
 
 ----
-参考: TracTermsJa -- 対訳用語集
+See also: TracTermsJa -- 対訳用語集