4

現在取り組んでいる Web アプリケーションについては、さまざまなユーザー グループに展開する方法を事前に検討する必要があります。機能面から見ると、同じソース ファイルからユーザー ガイドと状況依存のヘルプを生成するために使用できるドキュメンテーション システムを用意することが重要です。

私たちは DITA をドキュメンテーション システムとして使用することを計画しており、開発者が状況依存のヘルプを提供し、テクニカル ライターやトレーナーが入力できる要素を指定できる、簡単で拡張可能な方法を検討しています。

DITA に基づいて、PDF のユーザー ガイドと、JSP ベースの Web アプリケーションに統合された状況依存ヘルプを生成したいと考えています。どのような推奨事項がありますか?

以下の機能を備えた商用アプリケーションをすでに評価中です。

  • ヘルプ情報が入力される Web ページ上の要素を識別するためのオーサリング ツール
  • 学習管理システムとの統合
  • Web ベースではないアプリケーションのサポート

フレームワークの推奨事項はありますか? 上記に加えて、以下は素晴らしいでしょう

  • DITA との統合 (考えられるあらゆる方法で)
  • ユーザー グループ固有のコンテンツ (Web アプリケーションから取得したユーザー)
  • シンプルな Web アプリケーション内から (html) ツール ヒントを表示するために使用できます。
  • 次の階層とのヘルプ コンテキストの関連付け: アプリケーション > ページ > 要素 (HTML id?)
4

1 に答える 1

1

DITA はドキュメント アーキテクチャであり、ツールではありません。したがって、オーサリング ツールの選択や、DITA ソースから PDF およびオンライン ヘルプを作成するための選択が制限されることはありません。どのような種類のオンライン ヘルプを念頭に置いているかは明確ではありませんが、CHM のようなトリパンよりも、アプリケーション自体で表示できる HTML ページが必要なようです。

DITA から出力を生成するツールがいくつかあります。DITA-OT (Open Toolkit) は Sourceforge の FOSS ツールで、XSL-FO を作成できます。XSL-FO から PDF や HTML、CHM などを作成できます。次に、無料の DITA2Go http://dita2go.comがあります。これは PDF 作成用の Word RTF を作成するだけでなく、HTML やいくつかの形式のオンライン ヘルプも作成します。トピック ID 属性を HTML ファイル名の一部 (必要に応じてすべて) として使用します。さらに、商用プログラムもありますが、DITA2Go よりも大きなメリットはありません。

PDF をオンライン ヘルプ配信形式と考えるのではなく、顧客が印刷してハード コピーとして使用できるバージョンと考えることをお勧めします。また、ツールチップは、ヘルプを生成するツール以上に、実際には Web アプリケーション次第です。

于 2013-02-16T23:27:12.363 に答える