2009-07-06 81 views
2

我正在寻找一个体面的C#代码文档生成器,可以直接从源代码创建html格式的文档。来自源代码的C#文档?

我不想使用沙堡,因为它太繁琐了,我不使用VS来做我的工作,尽管Sandcastle的输出正是我所需要的。

我还需要Doxygen的功能 - 只需保存一个文件,按一个按钮,然后出现文档。问题是Doxygen不会产生类似MSDN的输出。

定制的风格将是一个加号,以及用于很多其他的样式,比如原型,花,VS2005等支持

回答

0

您没有指定是否需要开源代码,所以我会建议一个商业软件包Doc-o-matic(来自toolsfactory.com)。它高度可配置,并处理源代码中的注释(xdoc或javadoc样式)。它将生成.chm,.html,.pdf和Help2格式(将与Visual Studio集成)。我认为有免费试用。用户界面有点笨拙,整理所有设置需要一段时间,但总的来说,它工作得很好。我用它来记录.NET API(使用C++)和COM API(使用VB)。

12

由于沙堡的输出为“你想要什么”,我可能会问,如果你熟悉Sandcastle Help File Builder?这是一个GUI,可以将大部分烦人的事情自动化。

+0

好吧,Sandcastle从程序集生成文档,我需要它直接从我的.cs源文件生成(我正在构建一个框架)。 – Aethex 2009-07-06 17:51:51

0

我可以虚心地建议尝试ImmDoc.NET - 我前段时间开发的一个简单项目,最近发布在CodePlex上。它重量轻,使用非常简单,并支持.NET 2.0。它也可以创建CHM输出。

1

我们已经使用了DocumentX和HelpStudio从InnovaSys好几年来为我们的.NET组件生成文档。按照InnovaSys网站,DocumentX用于通过多项领先组件供应商:

领先的组件供应商,包括Infragistics的,剑锋,数据动态,登打士,的SpreadsheetGear和Telerik的生产他们的商业技术文档中使用

我最喜欢的DocumentX功能是相当全面的WYSIWYG编辑器,它可以在Visual Studio中正常工作。我唯一的抱怨是,建筑帮助有点慢 - 但这些好处肯定弥补了这一点。

我对InnovaSys没有兴趣,除了我是他们产品的快乐用户。