c# - リフレクションとxmlコメントからmediawiki対応のドキュメントを生成する方法

Question

誰かが良いワークフローを提案できますか、

• 必要となる可能性のある異種ツールの数とは関係なく
• そして、どれだけの手作業を実行する必要があるか、

プロジェクトのドキュメント（リフレクション+ xmlコメント）をmediawiki構文に組み込むことができますか？それを使用して開発チームのwikiaに組み込むことができますか？

Answer 1

手作業が必要になりますが、以下に概説するリソースを使用して実行できるはずです。

私の最初の考えは、グーグルをすることでした。それによって、 http：//www.mediawiki.org/wiki/Alternative_parsersに出くわしました。これらのパーサーはすべて、データを取得してXMLからではなくXMLに変換するようです。また、.NETベースではないため、コーディングが含まれていなければ、長期的にはそれほど重要ではない可能性があります。しかし、誰が知っているか、ここで一見の価値がある何かがあるかもしれません。

次に、http：//www.mediawiki.org/wiki/Manual： Importing_XML_dumpsを見つけました。XML形式でデータをインポートできる場合、実際に知っておく必要があるのは、データを適切な方法で再形式化できるようにスキーマが何であるかだけです。最良の点は、このページにhttp://www.mediawiki.org/wiki/Manual:XML_Import_file_manipulation_in_CSharpへのリンクがあることです。これは、Media Wiki XMLインポートファイルの操作方法のC＃の例です。この例を考えると、必要なxmlを最初から生成し、データをダンプするために必要なクラスを作成するのはほんの小さなステップのようです。公式スキーマドキュメントへのリンクは次のとおりです。http：//www.mediawiki.org/xml/ export-0.3.xsd。

PHPを作成するかどうかに応じて、別のオプションが表示されます。ここで説明されているように、XMLTransform拡張機能を作成できます：http ：//www.ehartwell.com/TechNotes/MediaWikiXmlExtension.htm 。このサイトでは、XMLをネイティブ形式で保持し、カスタムXSLシートを作成してコンテンツを目的の形式で表示できると言っているようです。

幸運を！

Answer 2

sandcastleを使用して、ソースコードhttp://documentation.sandcastle.codeplex.comからWebページを作成できます。

プロジェクト設定でプロジェクトのXML生成を有効にする必要があります。生成されたXMLは、サンドキャッスルで使用して、たとえばWebページとしていくつかのクールなドキュメントを生成できます。

Answer 3

doxygenを使用してXMLを生成し、結果のXML（XSLTまたは選択したツール）をニーズに適したものに処理することを検討します。

graphvizをインストールしている場合、doxygenはそのdotツールを使用してさまざまな図を生成することもできます。doxygenによって生成されたクラス階層図の例（KDEドキュメントから）は次のとおりです：http：//api.kde.org/playground-api/graphics-apidocs/cirkuit/src/lib/html/inherits.html

もう1つ、少し派手さの少ないもの（IBMから）：http ：//www.icu-project.org/apiref/icu4c/classUMemory.html