[[PageOutline]] = Trac-ja について = #abouttracja '''このファイルは Trac のオリジナル配布物には含まれません。''' Trac-ja は Trac の日本語ローカライズバージョンです。 ---- == Trac の I18N 対応状況 == #traci18n Trac はオリジナル配布物のままでも、日本語を使用することができます。 Trac の内部では ([http://trac.edgewall.org/milestone/0.10 0.10] 以降) Python の'Unicode' 形式で文字列を処理し、 Web の表示は `UTF-8`で行われるため、 (対応するフォントがあれば) どのような言語であっても取り扱うことができます。 (See: TracUnicode) === [wiki:TracEnvironment Environment] === #environment [http://trac.edgewall.org/wiki/DatabaseBackend バックエンドのデータベース] には `UTF-8` でデータ (Wiki ページ, チケット) が保存されます。 添付ファイルはデータベースに格納されません。 Environment の `attachments` ディレクトリ配下に、 URL エンコードされたファイル名で保存されます。ブラウザが URL エンコードに `UTF-8` を使用していない場合、ファイル名が文字化けすることがあります。また、ファイル名に日本語を使用すると 1 文字あたり 9 バイトに展開されるので、日本語 20 文字程度でファイルシステムが許容するファイル名の長さの上限に達してしまうので注意してください。 [wiki:TracIni trac.ini ファイル] 他、Environment に配置するファイル ([wiki:TracInterfaceCustomization カスタムテンプレート] や、 [wiki:WikiMacros Wiki マクロ] など) は、 `UTF-8` で作成してください。 `BOM (Byte Order Mark)` が付いていると動かないことがあります。 Windows のメモ帳 (`NOTEPAD.EXE`) で編集しないようにしてください) === [wiki:TracBrowser リポジトリブラウザ] === #browser 今のところ Trac が正式に対応している [http://trac.edgewall.org/wiki/VersioningSystemBackend バックエンドのバージョン管理システム] は、 Subversion だけです。 [http://trac.edgewall.org/browser/sandbox Trac Project の開発ブランチ] や [http://trac-hacks.org Trac Hacks] などには、他のバージョン管理システムを使うためのプラグインがありますが、動作状況等未確認です。 バージョン管理下のファイルは、 MIME Viewer という機能で HTML 変換し、リポジトリブラウザに表示されます: 1. [wiki:TracIni trac.ini ファイル] で `render_unsafe_content` が `false` (デフォルト値) に設定されていれば、安全なファイルだけが Web ページとして表示され、それ以外のファイルはダウンロードへのリンクが表示されます。 `true` に設定されていれば、表示可能な全てのファイルが Web ページとして表示されます。 2. `svn:mime-type` 属性もしくはファイルのサフィックスが、画像のように表示可能なバイナリファイル形式の場合は、 `` 要素として表示されます。 3. 表示できないバイナリファイル (`application/octet-stream` 等) の場合は、ダウンロードへのリンクが表示されます。 4. バイナリファイルと判別されない場合、テキストを HTML に整形します。 1. ファイルに設定された `svn:mime-type` 属性が `text/html; charset=utf-8` のように `charset=` を含む場合は、その文字コードでファイルを読み込みます。 2. ファイルに `BOM (Byte Order Mark)` が付いていれば、適切な `UTF` でファイルを読み込みます。 3. ファイル個別に判定できない場合は、 [wiki:TracIni trac.ini ファイル] の `[trac]` セクション `default_charset` オプションに指定された文字コードでファイルを読み込みます。このコンフィグの初期値は、 `cp932` (日本語版 Windows で通常使われている文字コード。オリジナル配布物では `iso-8859-15` である箇所にパッチしています) なので、 `UTF-8` や `EUC-JP` などの文字コードを使用する場合は、同コンフィグを変更してください。 Python 2.3 配布には、日本語だけで使用されている文字コード(`cp932`, `shift_jis`, `euc-jp` など) の codec が含まれていません。これらの文字コードを使用したい場合は、別途 [http://www.python.jp/Zope/download/JapaneseCodecs JapaneseCodecs] をインストールする必要があります。 Python 2.4 配布では、 !JapaneseCodecs が同梱されています。 Vista 文字を含む Shift_JIS のファイルは `cp932` では変換に失敗することがあります。この場合 `default_charset` 等には `shift_jis_2004` を使用すると改善する可能性が高いです。OS や Python のバージョン、ビルド時のオプションに依存する箇所なので、 100% ということはありません。 === 添付ファイル === #attachment 添付ファイル表示もバージョン管理下のファイルと同じく、 MIME Viewer が行います。 ただし添付ファイルでは、 (`svn:mime-type` 属性のような) ファイル毎の文字コード指定はできないので、 `BOM` による `UTF` の判別ができなければ、 `default_charset` に指定した文字コードに固定されます。 === [wiki:TracAdmin コンソール] === #console [wiki:TracAdmin trac-admin コマンド] の入出力では、使用するコンソールの文字コードが自動判別されます。 ([http://trac.edgewall.org/milestone/0.10 0.10] 以降) === [wiki:TracNotification メール通知] === #notification Trac が送信するメールは `UTF-8` が `Base64` か `quoted-printable` で 7bit-safe な形式にエンコードされています。MUA がこれらのエンコードに対応していない場合、文字化けする可能性があります。 (See: TracNotification) ---- == Trac の L10N 対応状況 == #tracl10n オリジナル配布ではユーザ入力以外の表示メッセージは全て英語です。これを日本語化した手順を記述します。 === コンテンツ === #contents 入力内容はオリジナル配布物でも日本語を使用できます。 [#traci18n 前項] の通りです。日本語化作業で変更した点はありません。 チケット属性について付記します。 ==== チケット属性名 ==== #fieldnames チケット属性の名前は、ほとんどの画面で何もしなくても日本語の属性名が表示されるようになっています。例外は TracReports の検索結果画面です。レポートの検索結果画面でのチケット属性の列名は、検索に使用した SQL の列名がそのまま表示されます。ですので SQL の SELECT 句で `AS` を挿入すれば、列名を日本語化することが出来ます。 0.11 以降、デフォルトのレポートのカラム名は日本語に変更しました。アップグレードした Environment で日本語のレポートを使用したい場合は、 TracReports を参考に変更してください。 ==== チケット属性の値 ==== #fieldvalues チケット属性の値は、データベースにそのま