このような要件を満たすヘルプ/ドキュメント生成ツールを探しています。
- C# コンパイラによって生成された xmldoc コメントをサポートするか、(さらに良いことに) サンドキャッスルを直接サポートする必要があります。
- MS Word ドキュメントのインポートをサポートする必要があります。
- 概念ドキュメントからソース コードから生成された参照ドキュメントへのリンクの作成をサポートする必要があります。
- MS Word での概念的なドキュメント オーサリングがサポートされているとよいのですが
詳細。私のプロジェクトは、.NET のフレームワーク/ライブラリです。合計で 50 以上の C# プロジェクトを含む複数の VS ソリューションがあります。まず、プロジェクトのソース コードからヘルプ (将来的には chm & help2 & help3) を生成したいと考えています。そのドキュメントを「参照ドキュメント」と呼びます。サンドキャッスル (特にSCFBを使用した場合)）これは非常に良い方法で行うことができます。しかし (非常に一般的な状況だと思います)、フレームワーク/ライブラリに関する追加のドキュメントがあります。そのドキュメントは MS Word ファイル (5 ～ 10 ファイル) です。そのドキュメントを「概念ドキュメント」と呼びます。概念ドキュメントと参照ドキュメント (MSDN など) を備えた堅固なヘルプ システムを作成したいと考えています。また、ヘルプの概念部分には、フレームワーク/ライブラリからのすべての .NET タイプ名のヘルプの参照部分を参照するリンク (URL) が含まれている必要があります。(明らかに、どのヘルプ システムも最終的には単なる HTML です)。
問題は、これらのリンクを作成する方法です。MS Word ファイルは、C# xmldoc について何も知りません。Sandcastle は Word ファイルをサポートしていません。そのため、ヘルプ オーサリング ツール (HAT) を使用する必要があります。今のところ、適切なツールが見つかりません。そして、私はどんな助けにもとても感謝しています!
すべてのツールの障害は、リンクの自動作成です。生成中にリンクが自動的に作成されるようにします (ビルド サーバーで実行できます)。なぜ自動的に？型の名前を簡単に変更できるためです。たとえば。概念ドキュメントにテキストがあります:「リクエスト処理コンテキストにアクセスするには、XOperationContext タイプの静的プロパティ Current を使用します」。ここで XOperationContext は型名です。結果ヘルプシステムの XOperationContext クラスの仕様へのリンク (URL) を、さほど手間をかけずにできるようにしてほしいです。Word（おそらくHATのプラグインがインストールされている）またはHATのエディターで、「可能であればこの単語をリンクする」のようなものとしてマークしたいと思います。生成中に、そのような名前の型名があれば、そのような単語はそれぞれリンクになります。
私はこれらのツールについて知っています：
Doc-o-Matic サポート リンクの自動作成。本当に自動的に。PascalCase の各単語のリンクを作成しようとします - 見事です。ただし、MS Word には対応していません。Innovasys および ComponentOne のソフトウェアは、リンクの自動作成をサポートしていません。Innovasys のソフトウェアは MS Word をサポートしていません (これについては 100% 確信が持てません)。
Innovasys と ComponentOne のフォーラムで質問してみました。これまでのところ運がありません。私のような Innovasys のソフト サポート シナリオ: 別のツール (HelpStudio) で概念的なドキュメントを作成し、別のツール (DocumentX) でソース コードからヘルプを生成する。ただし、リンクを自動的に作成して MS Word ファイルをインポートする機能はありません。
ですから、その一般的なタスクの有効期限を共有してください (一般的なはずです)。
ps 英語の文法の観点から自分の考えを正しく説明できていない場合はお知らせください。もう一度試します。