ダウンロード

The Java2HTML Tool

項目

• 導入
• 特徴
• Ant
• API
• インストール
• 必要条件
• オプション
• 使用例 -
  • 例1
  • 例2
  • 例3 TreeDemo.java.html#80
• 認知済みの制限事項と将来の拡張
• サポート
• 変更履歴
• ライセンス同意事項
• 著作権表示
• 支払い

導入

Java2HTMLはJavaのソースコードのまとまりを、カラー化されてブラウジング可能なHTML表現へ変換するシンプルなツールです。このツールを手に入れ(または)サンプル結果を見るためにdownloadへ今すぐ行ってください。このソフトウェアをダウンロードする前にライセンス協定を必ず読んでください。

Java2HTMLの出力は、NTとSolaris上でのMicrosoft Internet Explorer 4, 5, 6とNetscape Navigator 4でテスト済みです。

Java2HTMLはソースコードをインターネット上で発行するために、Sun Microsystems(Java Pet Store Demo 1.3.1)とOracle(XML Example)を含めた何千の団体で使用されています。

Java2HTMLに関する議論のために私たちのメーリングリストを購読して下さい -

• 購読
• 購読中止
  

特徴

主な特徴は -

• Javaコードをカラー化されたHTMLファイルに変換する。
• タブスペースを指定する。
• すべてのJavaキーワードの種類を標準的なCSSに通して、スタイルと色を指定する。
• JavaDocのルック&フィール。
• クラス定義のソースコードへクラスリファレンスをリンクする。
• 'JavaDoc'の出力結果へ外部のクラスリファレンスをリンクする。
• オプション行数
• API

Ant

Java2HTMLはAntの内部から使用できます。これの使い方を知るにはJava2HTML Task文書を見てください。

API

Java2HTMLはJava2HTMLのAPIを使って書かれたJavaプログラムの内部から使用できます。これは1.3Beta以降で有効です。

これの使い方を知るにはJava2HTML API サンプルを見てください。

インストール

インストールは一定の技術的知識がある事を仮定しています。

• Java2HTML.zipをWinZIPかJDK jar tool("jar -xf Java2HTML.xip"とする)のどちらかを使ってテンプディレクトリに解凍してください。
  
  
• j2h.jarとスクリプトの1つをあなたのファイルシステムの適当な場所(例えばC:\Tools\Java2HTML)にコピーしてください。
  
  
• インストールディレクトリをPATHに設定してください。
  
  
• スクリプトをインストールディレクトリを反映するために編集するか、あるいはDOS/UnixベースのOSを使用していなければ適切なスクリプトを作成するために編集してください。
  
  
• スクリプトの使用法は二者択一です。j2h.jarの場所をパスに設定出来れば、"java j2h"とタイプできますし、もしあなたがJava2を使っているなら、"java -jar j2h.jar"ともタイプできます。
  
  
• "j2h"とタイプして、あなたのインストールが成功しているか見てください。成功していれば使用説明を見るはずです。
  
• あるいはAntの内部からJava2HTMLを使う事もできます。
  

必要条件

• Java2HTMLはJavaで書かれていて、そのためJava1.1かそれ以上の互換のあるJVMが必要です。

オプション

引数なしで"j2h"(もしスクリプトを使っているなら)とタイプすれば、 オプションのリストを得ることができます。

さらに、Java2HTMLは、出力ディレクトリに色やスタイルのスキーマを編集可能な "stylesheet.css"を作成します。（警告::あなたがj2hを実行する時それが既に存在すれば、上書きされます。)

使用例

Java2HTMLの実行結果を見直すために、あなたのお気に入りのブラウザで出力ディレクトリにある生成された index.htmlを参照してください。

-jdオプションの使用をおおいに推薦します。 あなたはほとんどいつも、標準Javaライブラリにリンクしたいはずです。ですから、通常以下のパラメータ、"-jd C:\JDK1.2\DOCS\API"を与えてください。 あなたがアクセスしたことのあるJava Docのセットのついてそれぞれ-jdオプションを使ってください。

あなたが"j2h.bat"や"j2h"といったDosやUnixのスクリプトを使用しているのなら、指定された効果をもたらすサンプルをタイプしてください。

• j2h -js C:\JDK1.2\src
  
  カレントディレクトリのoutput以下に、JDK1.2の公開されているソースコードを表現したHTMLを生成します。
  
  
• j2h -js \home\billgates\dev\cooljavaproject -jd \usr\jdk1.2\docs\api \www\docs\jdk1.2\docs\api
  
  output以下に、JDK1.2ライブラリの標準Java Docにリンクされた、cooljavaprojectのソースコードを表現したHTMLを生成します。
  
  
• j2h -n COOL_PROJECT -t 8
  
  output以下に、カレントディレクトリのJavaソースを、タブを8つ分の空白としてさらにCOOL_PROJECTというタイトルを付けて表現したHTMLを生成します。
  
  
• j2h -m 4 COOL_PROJECT
  
  output以下に、カレントディレクトリのJavaソースを、行番号とCOOL_PROJECTというタイトルを付けて表現したHTMLを生成します。
  
  
• j2h -js C :\dev\project1 -js C: \dev\project2 -jd C :\jdk1.2\docs\api -jd C: \JavaXML\docs\api
  
  output以下に、C:\dev\project1 かC:\dev\project2以下のJavaソースを、標準JDK1.2 APIとSUN MicrosystemsのXMLライブラリにリンクして表現されたHTMLを生成します。
  
  

出力例

例はSUN MicrosystemsのJDK 1.3デモからの出典です。もしあなたがこれらのリンクをブラウジングしている間に変わった問題を経験したことがあるなら、問題の詳細をsupport@java2html.comまでメールしてください。

• 出力例1
  
  公開されているJDK 1.3のJava 2Dデモのソースは、以下のコマンドで生成されました -

  j2h -js C:\jdk1.3.1\demo\jfc\Java2D -d examples\Java2D_demo -jd C:\jdk1.3.1\docs\api http://java.sun.com/products/jdk/1.3/docs/api -n JAVA2D_DEMO
   

• 出力例2(行番号付き)
  
  公開されているJDK 1.3のSwing Set2デモのソースは、以下のコマンドで生成されました -

  j2h -js C:\jdk1.3.1\demo\jfc\SwingSet2 -d examples\SwingSet_demo -jd C:\jdk1.3.1\docs\api http://java.sun.com/products/jdk/1.3/docs/api -n SwingSet_DEMO -m 4
  
  

• 出力例3 - TreeDemo.java.html#80

注意: これらの例は、Sun Javaのウェブサイトのドキュメントを指すために、-jdオプションのweb_referenceの特徴を使っています。あなたのローカルディスクのコピーされたドキュメントのリファレンスを指す方がより一般的です。

認知済みの制限事項と将来の拡張

さらなる強化のリクエストはsupport@java2html.comまで送ってください。もし私があなたのアイディアを使用すれば、あなたにこのドキュメントのクレジットを与えます。

• AppleのMacのサポートとJavaの特性の指定オプションへのファイル化。
  
  
• メソッドとオブジェクトインスタンスのハイパーリンク。
  
  
• 適切な使用法のインストーラパッケージの作成。
  
  
• コメントと文字列を含んだリファレンスへのハイパーリンク。
  
  
• カスタマイズされたスタイルシートの上書きを防ぐ、スタイルシートオプションの作成。
  
  
• 構造化されていないJavaコードのより適切な処理。（訳注：原文ではconformantとありますが、conformatの間違いだと思います）
  
  
• JSP、SQLJ、XML、SQL scripts、PerlやC/C++などの他の言語を処理したJava2HTMLの拡張、さらに（または）、追加された言語のソースを実装したサードパーティを考慮したアーキテクチャの拡張。
  
  
• あるいは、適当なライセンスを持ったソースコードの発行。
  
  
• 検索サイトを追従するHTML。
  
  
• Tony O'HaganはURLからJavaDocをリンクできる-linkオプションを提案した。

サポート

バグがありましたらsupport@java2html.comまで報告してください。 メールを送る前に認知済みの制限事項と将来の拡張にそのバグが掲載されていないか確認してください。

変更履歴（訳注：未翻訳です）

interface A {
    class B {};  // <-- ';' is problematic
}

class Foo {
  SomeObject thing = something;; // <-- Extra semi-colon
}

ライセンス同意事項

あなたは、以下の条件を注意深く読んで、ソフトウェアパッケージを使用する前に調整しなくてはなりません。このソフトウェアの使用することは、このライセンス同意事項を承諾したことを示します。これは、あなた（個人や団体）とこのソフトウェアの権利所有者との間の法的な同意(この"同意事項")です。この同意事項はソフトウェアパッケージの一部です。

1. 実施権の許諾：権利所有者は本同意事項によって、あなたに個人的な（独占的でなく、また、譲渡不能な）このソフトウェアのコピーの一つを使用するライセンスを与えます。このライセンスの授与は、あなたのコンピュータ上でソフトウェアを使用する権利を与えます。あなたはこのソフトウェアを逆コンパイルしたり、逆アセンブルしたり、リバースエンジニアリングしたりしてはいけません。また、このソフトウェアの派生物を作成してもいけません。 あなたは生成されたHTMLコードを修正したり、翻訳したり、編集したりしても構いません。あなたには、この同意事項の承諾によって与えられるソフトウェアの使用権利以外のいかなる権利も与えられません。

2. 再配布：ソフトウェアのZIPファイルの再配布は、シャウェアとフリーウェアのサイトやCD-ROM、また、それに類似したものによって、権利所有者の許可なしに認められています。商用目的や転売のための再配布は許可されていません。

3. 保証：このソフトウェアと付属するファイルは、いかなる種類の保証もない"無保証"の状態で供給されます。

4. 著作権：著作権はPolygon Enterprisesに帰し、イギリスの著作権法と国際協定規定によって保護されています。

5. ライセンスの終了：ライセンスは、もしあなたがこのライセンスのいかなる規定にも従わなければ、権利所有者の通告なしに速やかに終了します。ライセンスが終了した場合は、あなたはこのソフトウェアのいかなるコピーと、いかなる、また全ての形態のメディア上のコンポーネントを破壊しなければなりません。

6. 責任の限定：版権所有者並びに供給者は、いかなる事象においても、このソフトの使用、 もしくは使用出来ないことから生じるいかなる収益や利益の損失、または 直接的、特殊的、間接的、必然的、二次的、あるいは懲罰的な損害に対して も責任を負わない。これはたとえ版権所有者がそのような損害の可能性を 知らせられていたとしても、その利益の損失・損害がいかなる状況で生じたと しても、また責任の見解に関係無く適用される。

7. 準拠法：この同意事項はイギリスの法律のもとに作られ、それに準拠し、また、それによって解釈されるものとする。

著作権表示

• Sun MicroSystems, Javaの作成に感謝します。
  
  
• Java FAQの保守管理者であり、"Just Java 1.2" などの多くの優れた本の著者であるPeter Van der Linden。
  
  
• JavaCCを共に解釈した人々、特にSiram Sankarの助けには感謝します。
  
  
• Java 1.2を拡張したDavid Williamsを含めた、JavaCCニュースグループの皆。
  
  
• JARSの人々には、このツール（version 1.0.3）を与えてくれたことを感謝しています。"標準ではJARSは25%を上回る"と言っていたけれど、実際は1000のうち895を出していました。プレゼンテーションでの損の跡です。
  
  
• Java2HTMLの原版の作成者、Jason Shattu。
  
  
• この製品の所有者であるPolygon Enterprises。
  
  
• 他の優れた製品として -
  
  • Bruce BlackshawのJava FTP Client 
  • David ShattuのEasy Password Manager

支払い

Java2HTMLはフリーのソフトウェアとして配布されていますが、ユーザーや企業はそれを使うのに有意義な事をするべきです。登録状態を与えられ、将来の開発費用の助けとなる50ドルの寄付をすることを勧めます。 以下のリンクをクリックしてください。