26

VS2010XMLドキュメントからHTML/ヘルプファイルを作成するための優れたツールを探しています。私は次のようないくつかの商用ツールを見つけました

もっとたくさんあると思います。例としてこれら2つをリストします。また、XMLをHTMLドキュメントに変換するための単純なXSLTスタイルシートがあります。

何を使用していますか。たとえば、アドインとして、変換を行うための無料のツールがあります。明確にするために、基本的に私は2つのタイプのツールを見つけました：

  1. XMLドキュメントファイルをさまざまなターゲット形式に変換するもの、これが私が探しているものです。
  2. ソースコードでXMLドキュメントを生成するのに役立つツール。これは私が探しているものではありません（！）。

ご協力いただきありがとうございます。

サンドキャッスル/SHFBコンボは素晴らしい働きをします。助けてくれたすべての人に感謝します。

いくつかの意見：

  1. NDocは古くなっているようです。最後の更新は2005年のものです。そのため、これをスキップしました。
  2. 同様のスレッドも非常に詳細です。https ：//stackoverflow.com/questions/3082044/how-to-turn-c-xml-doc-comments-into-something-usefulヒントをありがとうございます。
  3. Sandcastleにはいくつかのソースがあり、私が見つけた最新バージョンはここにあります：http ://sandcastle.codeplex.com/
  4. 生成するMsHelp2には、を含むVS2008SDKをインストールする必要がありましたhscomp.exe。バージョン1.0にはコンパイラが含まれていることがわかる限り、バージョン1.0と1.1があります。詳細については、 HelixsoftおよびSocialMSDNを参照してください。
  5. 私の場合、生成されたWebHelpはChromeで正しく機能しません。常にindex.htmlページをリロードします。
  6. ここのトピックは、名前空間情報をサンドキャッスルドキュメントに追加する方法を示しています。
  7. 2012年11月現在の更新：小規模なプロジェクトでは、Doxygenを使用しています-構成が少し簡単だと思います。
4

3 に答える 3

19

変換にはSandcastleを使用し、ヘルププロジェクトを管理するためのユーザーインターフェイスとしてSandcastleヘルプファイルビルダーを使用しています。私の意見では、SandcastleとSHFBの美しさは、「平均的な」ソースコードのドキュメントに加えて、プログラムのアーキテクチャ、従う必要のあるパターン、または結び付けられていないプロジェクトの概念的なコンテンツなどの追加情報を追加できることです。プログラム内の1つのクラスに直接。これは、Microsoftオーサリングスキーマを使用して追加のxmlファイルを作成することで実行できます（xmlファイルとそのスキーマが利用可能であるため、Visual Studioで編集できます）。これらの両方のツールから始めて、MSDNのようなドキュメントを作成するのは非常に簡単です。

ずっと前に、技術面でほぼ同じdocbookを試しました（情報を含むxmlファイルとさまざまな出力タイプに変換するためのxsltファイル）。しかし、Visual Studioで生成されたxmlドキュメントを使用できる変換がないため、これは私たちにとって選択肢ではありませんでした（さらに、概念コンテンツの変換は私たちにとってかなり苦痛でした）。

于 2011-01-24T12:17:53.603 に答える
3

Xmlコメントからドキュメントを作成できる2つの無料ツール：

于 2011-01-24T12:13:25.227 に答える
3

サンドキャッスル+SHFBは素晴らしいコンボです。無料でhtml、chmなどを生成します

于 2011-01-24T12:15:55.633 に答える