web-dev-qa-db-ja.com

VS 2010 C#XMLドキュメントからHTML /ヘルプファイルを生成する

私のVS2010 XMLドキュメントから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. サンドキャッスルにはいくつかのソースがあります。私が見つけた最新バージョンはここにあります: http://sandcastle.codeplex.com/
  4. MsHelp2を生成するには、hscomp.exeを含むVS 2008 SDKをインストールする必要がありました。バージョン1.0と1.1がありますが、バージョン1.0にはコンパイラが含まれていることがわかっています。詳細については、 Helixsoft および Social MSDN を参照してください。
  5. 私の場合、生成されたWebHelpはChromeで正しく動作しません。常にindex.htmlページをリロードします。
  6. ここのトピック は、サンドキャッスルのドキュメントに名前空間情報を追加する方法を示しています。
  7. 2012年11月現在の更新:小規模なプロジェクトでは Doxygen を使用しています-設定が少し簡単だと思います。
26
Horst Walter

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

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

19
jb_

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

3
KristoferA

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

3
Tim Lloyd