検索可能なヘルプを Java (Swing) アプリケーションに統合しようとしています。現在、pdf ヘルプを生成するために docbook を使用していますが、JavaHelp を生成できることはわかっています。ただし、JavaHelp のデフォルトのビューアはかなり魅力的ではないと思います (特に Windows では、Windows L&F を使用している場合でも)。見栄えの良いビューアーは見つかりませんでしたが、知っているかどうか、またはアプリケーション内でヘルプのより良い代替手段があるかどうかに興味があります.
2 に答える
JavaHelpのデフォルトのコンテンツ ビューアー (HTML レンダラー)はHTMLEditorKitです。このコンポーネントはあまり印象的ではありません。HTML 3.2 のみをサポートし、CSS 機能が制限されています。JavaHelp に別のコンテンツ ビューアをプラグインすることができます。
Oracle Helpを試してみてください。JavaHelp に非常に似ていますが、より積極的にメンテナンスされています。Oracle Help に付属しているデフォルトのコンテンツ ビューアも、より機能的です。DocBook-XSL JavaHelp スタイルシートは、Oracle Help で機能する出力を生成するために微調整が必要になる場合があります (このページを参照)。
これらのテクノロジのステータスと将来の計画に関する決定的な情報を見つけることは困難です。JavaHelp の最新リリースは 2007 年 10 月で、Oracle Help 11.1.2.1.0 は 2011 年 9 月にリリースされました。フォーラム (こことここ) はありますが、活動は低調です。
Web/ブラウザベースのヘルプ システムに興味があるかもしれません。その場合は、DocBook コンテンツの新しい出力形式の 1 つであるWebHelpを見てください。
私はすべてのドキュメントのニーズにSphinxを使用しており、優れた HTML テンプレートを備えています。Sphinx サイト自体は、テンプレートの 1 つに基づいています。基本の sphinx プロジェクトをセットアップし、エディターとして機能するEclipse プラグインもあります。利点
- wiki に似た ReST 構文を使用してドキュメントを作成します。
- 見栄えの良い html テンプレート/
- epub、pdf などの他のフォーマットを生成する機能。
- バージョン管理可能