MergeDoc

Fork

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pleiades
──────────────────────────────────────────────────
URL : http://mergedoc.sourceforge.jp/
MAIL : cypher256 @ users.sourceforge.jp
AUTHOR : Shinji Kashihara (柏原 真二)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Pleiades は Eclipse プラグイン日本語化プラグインです。
実行時にメモリ上で Eclipse 本体と多くのプラグインを日本語化します。

対応プラグイン一覧
http://sourceforge.jp/projects/mergedoc/wiki/Pleiades%E5%AF%BE%E5%BF%9CEclipse%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E4%B8%80%E8%A6%A7



謝辞
──────────────────────────────────────────────────

次の方々に翻訳提供や協力をいただきました。感謝いたします。(敬称略、順不同)

かぬ、kutakuta、いがぴょん (IGA Tosiki) [*1]、ymoto [*1]、orihalcon、ちんちろりん、You＆I、
asachin、遊、manila、Holy、yuizumi、yamamoto、いずも、samu、a man、muimy、yuki358、Pepe、same、
yujirockets、inaba
[*1] 本プロジェクト・メンバー (翻訳に関する機能リクエスト管理者)

CodeGear from Borland、エンバカデロ・テクノロジーズ (CodeGear)、NTT データビジネスブレインズ、
キヤノンソフトウェア株式会社

(c) 19-10 - Eclipse 3.5 Galileo スプラッシュ画像



特徴
──────────────────────────────────────────────────

・翻訳対象のプラグインやバージョン（Eclipse 本体含む）に依存しません。
・リソースが外部化されていないプラグインでも日本語化されます。
・対象プラグインのプロパティファイルやクラスファイルは書き換えません。
・言語パックを入れた場合、その部分に関しては言語パックが優先(*1)されます。
・JDK の標準 API Javadoc ホバーを日本語化します(*2)。
・ヘルプは日本語化されません。
・実際はプラグインではなく、AOP を利用した翻訳コンテナです。


(*1) Pleiades は基本的に Eclipse.org が配布する言語パックをすべて取り込み済みですが、言語パックが
持つ明らかにおかしいと思われる訳は修正しています。言語パックを入れた場合、それらの恩恵は受け
られません。なお、言語パックをインストール済みでも優先したくない場合は、Eclipse の起動時に
-nl en_us（これは Eclipse が持つオプションです）を指定することですべて Pleiades 側で訳されます。

(*2) Eclipse 3.2以降、Pleiades 1.2.1 以降。jar に日本語の API 日本語ドキュメントを設定した場合のみ
（自動的にデフォルトで日本語版の URL が設定されます）。Eclipse 3.2 では jar に設定した API
ドキュメントをホバー表示できますが、ソースを添付していた場合はそれが優先されてしまいます。
Pleiades はその優先度を逆転させています。JDK などのソース自体を日本語化したい場合は MergeDoc
を使用する必要があります。



動作環境
──────────────────────────────────────────────────

・JRE 5 以上
・Eclipse 3.1 以上



インストール / アンインストール
──────────────────────────────────────────────────

1. pleiades_x.x.x.zip を解凍し、plugins、features ディレクトリーを <ECLIPSE_HOME> ディレクトリーに
コピー。

2. eclipse.ini の最終行に以下の記述を追加。
-javaagent:plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar
（Windows 以外の場合は後述の Eclipse 起動オプション参照）

(Eclipse 3.3 以降)
3. Pleiades スプラッシュ画像を使う場合は
eclipse.ini の 1、2 行目の -showsplash org.eclipse.platform を削除。


Pleiades をバージョンアップした場合や他のプラグインをインストールした場合は起動オプションに -clean
を指定してください。Windows の場合は同梱している "eclipse.exe -clean.cmd" で -clean 起動できます。
初回起動時は自動的に -clean モードで起動します。-clean での起動は、現在の環境に合わせて次回以降の
実行速度を Pleiades が最適化しますが、通常よりかなり遅くなるため、-clean の常用は避けてください。
-clean 起動の後、5～6 回 通常起動すると、不要な辞書をロードしなくなるため軽くなります。

Windows の場合、デフォルトのフォントが Courier New 10 ポイントになっていますが ＭＳ ゴシック
9 ポイントをオススメします。下記から設定できます。メニューから
[ウィンドウ] - [設定] を開き、[一般] - [外観] - [色とフォント] の [基本] - [テキスト・フォント]
で設定してください。


Pleiades を一時的に無効にしたい場合は -javaagent 指定を除去してください。完全にアンインストールす
る場合は、-javaagent 指定を除去し、以下のディレクトリを削除してください。

plugins/jp.sourceforge.mergedoc.pleiades/
features/jp.sourceforge.mergedoc.pleiades/
configuration/jp.sourceforge.mergedoc.pleiades/

上記の 3 つ目は Pleiades の構成やログが出力される <Pleiades configuration ディレクトリー> です。
Linux、Mac OSX の場合、デフォルトでは下記になります。ただし config.ini の osgi.configuration.area
を指定している場合は、それが優先されます。

$HOME/.eclipse/jp.sourceforge.mergedoc.pleiades/<インストールパス名>/



FAQ
──────────────────────────────────────────────────

Q. 起動しない / 起動しなくなった / 強制終了させたらおかしくなった(※)

1. Eclipse 起動オプション -clean を指定して起動してみてください。
2. configuration/jp.sourceforge.mergedoc.pleiades/ ディレクトリーを削除して起動してみてください。
3. コマンドラインから起動し、出力されるエラーを確認してください。Windows の場合は eclipse.exe
ではなく eclipsec.exe を使用してください。<Pleiades configuration ディレクトリー>/pleiades.log、
<ワークスペース>/.metadata/.log も確認してみてください。

※強制終了させた場合は、必ず -clean 起動してください。初回起動や -clean での起動はマシンによって
は数分かかる場合があります。


Q. 起動はするけど、まったく日本語化されない

1. Eclipse 実行環境が JRE 5 以上になっているか確認してください。メニューの
Help -> About Eclipse Platform -> Configuration Details に表示される -vm の値で確認できます。


Q. なんかあんまり日本語化されない / ところどころ英語になってしまった

1. Eclipse 起動オプション -clean を指定して起動してみてください。
2. configuration/jp.sourceforge.mergedoc.pleiades/ ディレクトリーを削除して起動してみてください。


Q. Pleiades を入れたら WTP のプロジェクト・エクスプローラーに動的 Web プロジェクトなどが表示されな
くなってしまった

1. ワーキング・セットの設定を開いてチェックを入れなおしてください。



Eclipse 起動オプション
──────────────────────────────────────────────────

Pleiades を有効にするには、Eclipse の起動オプションに、-javaagent を追加してください。pleiades.jar
へのパス指定は、Windows、Mac OS、Linux いずれの場合も、カレント・ディレクトリーからの相対パス、
または絶対パスを指定してください。


◆方法 1: eclipse.ini 最終行に以下の指定を追加

* Windows での設定例

-javaagent:plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar


* Mac OS での設定例

Mac OS では eclipse.ini は Eclipse.app/Contents/MacOS/ にあります。
また、後述の no.mnemonic オプションは自動的に有効になります。

相対パスで指定する場合
-javaagent:../../../plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar

絶対パスで指定する場合
-javaagent:/Applications/eclipse/plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar


◆方法 2: 起動引数に直接 pleiades.jar を指定

例）eclipse -vmargs -javaagent:plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar -Xms40m -Xmx256m

* 起動引数に -vmargs を指定している場合は eclipse.ini の -vmargs は無効になるため、ヒープサイズ
も指定してください。



Pleiades 起動オプション
──────────────────────────────────────────────────

Pleiades のオプションは -javaagent 指定の末尾に指定します。複数のオプションを
指定する場合はカンマで区切ってください。

例）-javaagent:plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar=option,,,
~~~~~~~~~~

default.splash

Pleiades はスプラッシュ画像を変更します。Eclipse デフォルトのスプラッシュ画像を使用したい場合は
このオプションを指定してください。

Eclipse 3.3 以降、eclipse.ini にデフォルトで -showsplash org.eclipse.platform が指定されています
が、この -showsplash は見かけ上の速度を上げるため、VM 起動前にスプラッシュを表示する Eclipse
起動オプションです。つまり、Pleiades を使用しない場合、-showsplash を指定有無に関わらず、表示
されるスプラッシュは同じです。Pleiades 側では VM 起動前の処理を制御できないため、default.splash
オプションは Eclipse 起動オプションの -showsplash が未指定の場合のみ有効です。


no.mnemonic

メニューの "ファイル(F)" 末尾の (F) のようなニーモニックを表示しないようにします。Mac OS では
自動的にこのオプションが有効になります。


enabled.not.found.log

訳が見つからなかった場合に、ログをプロパティー形式で
configuration/jp.sourceforge.mergedoc.pleiades/translation-notfound.properties に出力します。
ただし、-clean で起動しないとキャッシュされているものは出力されません。

このプロパティーから訳したい行をコピーし、Pleiades の /conf/additions ディレクトリーに適当なファ
イル名でプロパティー・ファイル (.properties) を作成することで、オリジナルの訳を追加することがで
きます。


log.level=debug

ログ・レベルを指定します。指定しない場合のデフォルトは info です。指定できる値は、
debug, info, warn, error, fatal のいずれかです。



Eclipse 始動時間の表示
──────────────────────────────────────────────────

付加的な機能として、Eclipse 始動後、ステータスバーに始動時間が表示されるようになります。
ただし、始動時にワークスペース選択ダイアログを表示するようになっている場合は、正しく計測できない
ため、表示されません。



PDE での利用
──────────────────────────────────────────────────

PDE などから Eclipse アプリケーションを起動して Pleiades を有効にするには
一旦起動して起動構成を作成後、起動構成ダイアログの [引数]タブ - [VM 引数] に
以下を指定してください。

-javaagent:plugins/jp.sourceforge.mergedoc.pleiades/pleiades.jar



最新 Integration Build の取得
──────────────────────────────────────────────────

http://svn.sourceforge.jp/cgi-bin/viewcvs.cgi/trunk/Pleiades/build/?root=mergedoc



Pleiades を Eclipse プロジェクトとして zip からインポート
──────────────────────────────────────────────────

[ファイル] - [インポート] - [既存プロジェクトをワークスペースに] で[アーカイブ・ファイルの選択] を
チェックし pleiades_x.x.x-src.zip を選択してインポートしてください。



Pleiades を Eclipse プロジェクトとして SVN からチェックアウト
──────────────────────────────────────────────────

http://sourceforge.jp/projects/mergedoc/wiki/Pleiades%E3%82%92Eclipse%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%A8%E3%81%97%E3%81%A6%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%82%A2%E3%82%A6%E3%83%88%E3%81%99%E3%82%8B



翻訳ポリシー
──────────────────────────────────────────────────

こちらで策定しています。
http://wiki.eclipse.org/%E7%BF%BB%E8%A8%B3%E3%83%AB%E3%83%BC%E3%83%AB



ライセンス
──────────────────────────────────────────────────

Copyright (c) 2005- Shinji Kashihara. All rights reserved.

This program and the accompanying materials except for /lib directory are
made available under the terms of the Eclipse Public License v1.0 which
accompanies this distribution, and is available at /epl-v10.html.

This product includes software developed by
The Apache Software Foundation (http://www.apache.org/) and
Shigeru Chiba, Tokyo Institute of Technology
(http://www.csg.is.titech.ac.jp/~chiba/javassist/).

Please read the different license files present in the /lib directory of
this distribution.



Pleiades の辞書について
──────────────────────────────────────────────────

Pleiades の辞書には eclipse.org によって配布されてきた下記の言語パックの訳が含まれています。なお、
これらの訳は Pleiades により修正されている部分があります。

- birt-1.0.1
- birt-2.1.1
- cdt.sdk-2.0.2
- cdt.sdk-3.1.1
- dtp-sdk_0.9.1
- emf-sdo-SDK-2.1.1
- emf-sdo-SDK-2.2.1
- GEF-ALL-3.1.1
- GEF-ALL-3.2
- GMF-sdk-1.0.1
- tptp.sdk-TPTP-3.3.0
- tptp.sdk-TPTP-4.0.1
- tptp.sdk-TPTP-4.2.0
- uml2-SDK-1.1.1
- uml2-SDK-2.0.1
- VE-SDK-1.1.0.1
- VE-SDK-1.2.1
- wtp-sdk-0.7.1
- wtp-sdk-1.5.0
- wtp-sdk-1.5.1
- eclipse-SDK-2.1.2.1
- eclipse-SDK-3.0.1
- eclipse-SDK-3.1.1a
- eclipse-SDK-3.2.0
- eclipse-SDK-3.2.1

また、これらの言語パックは以下の Copyright（有効年範囲省略）が含まれています。

# Copyright (c) Actuate Corporation.
# Copyright (c) IBM Corporation and others.
# Copyright (c) Intel Corporation and others.
# Copyright (c) Nokia and others.
# Copyright (c) QNX Software Systems and others.
# Copyright (c) Rational Software Corporation and others.
# Copyright (c) Scapa Technologies Limited and others
# Copyright (c) Texas Instruments Inc. and others.

1.3.0 - 2009.03.16

[機能拡張]
・始動後、ステータスバーに始動時間を表示するようにした
・Mac で no.mnemonic オプションが自動的に有効になるように変更
・Ant コンソール・エンコーディング未設定時は OS デフォルト (Windows は MS932) を使用するようにした
・翻訳キャッシュが破損していた場合の自己復元機能を追加
・非国際化プラグイン対応で Combo を直接訳していたが除外が多いため翻訳を廃止し、必要に応じて
includeTrace などで対応する方向にした。
・pleiades-config.xml の excludeTrace 要素の className 属性の前方一致対応
・句点解析分割により辞書データ量を削減、かつ多くの未知の訳に対応

[高速化]
・メモリー使用量低減（辞書遅延ロード、翻訳キャッシュ圧縮など）
・辞書は必要なエントリーのみロード (初回 -clean 起動と、その後、数回通常起動が必要)

[バグ対応]
・WTP でサーバーにプロジェクトが追加できなくなる問題を修正
・ワークスペース選択ダイアログでデフォルト以外の場所を選ぶと自動設定が機能しない問題を修正
・CDT Makefile 実行時標準出力文字化け回避のために、自動生成 Makefile は訳さないように修正
・ユーザーによる追加辞書 conf/additions/*.properties 読み込み時にニーモニックを除去するように修正
(内部で保持する辞書はニーモニックを保持しないため)
・SVN 同期化ウィザードでプロジェクト名が訳される問題を修正
・インポート時のプロジェクト名が訳される問題を修正
・同期化ビューのメッセージに含まれるプロジェクト名が訳される問題を修正
・& を含むパラメーター付き URL が含まれる場合は翻訳しないように修正
・eclipse.ini_sample.win.3.4 から -Dfile.encoding 指定を削除
・コード断片をパッケージエクスプローラにコピペすると、「スニペット.java」になる問題を修正
・Web Performer の訳されすぎ問題に対応
(キヤノンソフトウェア株式会社が設定提供、同社によるテスト実施済み)
・DBViewer のテーブル・エディターで「Where:」が訳される問題を修正 (ZIGEN)

[新規対応したプラグイン]
・Cypal Studio for SWT、XMind、jsLex
・EMecha (プロジェクト名が翻訳される問題を修正)

[訳の調整]
・Publishing=公開中 -> 公開
・Monitoring=モニター中 -> モニター
・GEF、Aptana、Dolteng、AnyEdit ツール、CDT、PyDev、QuickREx、FindBugs、NTail、
Eclipse 3.5、Aptana RadRials の未訳分追加
・eclipse.org の旧言語パック (15 プロジェクト) のヘルプから約 34,000 個をプロパティーとして抽出。
このうち、HTML 非依存の約 20,000 個を暫定追加。

[リクエスト]
・[#14249] Mylyn 3.1 翻訳 (hiroyuki_inaba 提供)
・[#14249] Mylyn 3.1 翻訳 (hiroyuki_inaba)
・[#14410] 翻訳確認: runtime (ymoto)
・[#14477] ECF 3.0 翻訳 (hiroyuki_inaba)
・[#14517] 翻訳: org.eclipse.team.svn - 4件 (iga, ymoto)
・[#14557] 翻訳: org.eclipse-jee-ganymede - 2件 (iga, ymoto)
・[#14559] 翻訳: org.eclipse-SDK_3.4 - 8件 (iga, ymoto)
・[#14699] 試験: Pleiades 開発版: 1.3.0.N20090119 (iga, ymoto)
・[#14700] 試験: Pleiades 開発版: 1.3.0.N20090119 (2) (iga, ymoto)
・[#14774] 試験: Pleiades 開発版: 1.3.0.N20090122 (iga, ymoto)
・[#14776] 試験: Pleiades 開発版: 1.3.0.N20090122 (2) (iga, ymoto)
・[#14796] 試験: Pleiades 開発版: 1.3.0.N20090123 (iga, ymoto)
・[#14797] 試験: Pleiades 開発版: 1.3.0.N20090123 (2) (iga, ymoto)
・[#14799] 試験: Pleiades 開発版: 1.3.0.N20090123 (3) (iga, ymoto)
・[#14800] 試験: Pleiades 開発版: 1.3.0.N20090123 (4) (iga, ymoto)
・[#14801] 試験: Pleiades 開発版: 1.3.0.N20090123 (5) (iga)
・[#14802] 試験: Pleiades 開発版: 1.3.0.N20090123 (6) (iga)
・[#14837] 試験: Pleiades 開発版: 1.3.0.N20090127 (iga)
・[#14838] 試験: Pleiades 開発版: 1.3.0.N20090127 (2) (iga)
・[#14839] 試験: Pleiades 開発版: 1.3.0.N20090127 (3) (iga)
・[#14840] 試験: Pleiades 開発版: 1.3.0.N20090127 (4) (iga)
・[#14841] 試験: Pleiades 開発版: 1.3.0.N20090127 (5) (iga)
・[#14842] 試験: Pleiades 開発版: 1.3.0.N20090127 (6) (iga)
・[#14843] 試験: Pleiades 開発版: 1.3.0.N20090127 (7) (iga)
・[#14844] 試験: Pleiades 開発版: 1.3.0.N20090127 (8) (iga)
・[#14844] 試験: Pleiades 開発版: 1.3.0.N20090127 (8) (iga)
・[#14845] 試験: Pleiades 開発版: 1.3.0.N20090127 (9) (iga)
・[#14862] 試験: Pleiades 開発版: 1.3.0.N20090128 (iga)
・[#14863] 試験: Pleiades 開発版: 1.3.0.N20090128 (2) (iga)
・[#14864] 試験: Pleiades 開発版: 1.3.0.N20090128 (3) (iga)
・[#14865] 試験: Pleiades 開発版: 1.3.0.N20090128 (4) (iga)
・[#14866] 試験: Pleiades 開発版: 1.3.0.N20090128 (5) (iga)
・[#14867] 試験: Pleiades 開発版: 1.3.0.N20090128 (6) (iga)
・[#14868] 試験: Pleiades 開発版: 1.3.0.N20090128 (7) (iga)
・[#14869] 試験: Pleiades 開発版: 1.3.0.N20090128 (8) (iga)
・[#14870] 試験: Pleiades 開発版: 1.3.0.N20090128 (9) (iga)
・[#14883] 試験: Pleiades 開発版: 1.3.0.N20090128 (10) (iga)
・[#14887] 試験: Pleiades 開発版: 1.3.0.N20090128 (11) (iga)
・[#14888] 試験: Pleiades 開発版: 1.3.0.N20090128 (12) (iga)
・[#14889] 試験: Pleiades 開発版: 1.3.0.N20090128 (13) (iga)
・[#14890] 試験: Pleiades 開発版: 1.3.0.N20090128 (14) (iga)
・[#14891] 試験: Pleiades 開発版: 1.3.0.N20090128 (15) (iga)
・[#14901] 試験: Pleiades 開発版: 1.3.0.I20090201: 句点の処理 (iga)
・[#14902] 試験: Pleiades 開発版: 1.3.0.I20090201: 句点(2) (iga)
・[#14944] 試験: Pleiades 開発版: 1.3.0.N20090202 (iga)
・[#14945] 試験: Pleiades 開発版: 1.3.0.N20090202 (2) (iga, yamoto)
・[#14946] 試験: Pleiades 開発版: 1.3.0.N20090202 (3) (iga)
・[#14947] 試験: Pleiades 開発版: 1.3.0.N20090202 (4) (iga)
・[#14954] 試験: Pleiades 開発版: 1.3.0.N20090202 (5) (iga)
・[#14955] 試験: Pleiades 開発版: 1.3.0.N20090202 (6) (iga)
・[#14980] 翻訳: org.eclipse.team.svn.ui - 4件 (iga, yamoto)
・[#15186] 試験: Pleiades 開発版: 1.3.0.I20090217 (iga)
・[#15193] 試験: Pleiades 開発版: 1.3.0.I20090217 (2) (iga)
・[#15277] 試験: Pleiades 開発版: 1.3.0.I20090225 (iga)
・[#15279] 翻訳: org.eclipse-SDK_3.4.2 - 4件 (iga、ymoto)
・[#15375] 翻訳: org.eclipse-jee-ganymede - 25件 (iga, ymoto)
・[#15376] 翻訳: org.eclipse-jee-ganymede - 23件 (iga, ymoto)
・[#15498] 翻訳: org.eclipse-jee-ganymede - 1件 (iga)