Sandcastle生成MSDN样式文档的好替代方法
我已经使用Sandcastle 2年来生成一个开源库的文档。 但现在我正在寻找替代品,因为:
- 即使在使用Sandcastle帮助文件生成器时 ,Sandcastle对我来说太复杂了。 生成文档应该与在Visual Studio中单击button或菜单一样简单。
- 该项目似乎不再被维护; 最新版本于2010年6月发布,目前似乎还没有人正在进行这项工作。 错误不再是固定的,这对我来说是一个很大的问题(我的程序库大量使用扩展方法,而这个错误弄糟了所有的东西)
- 由于它将是一个开源项目,商业产品如VSdocman和Document! X对我来说是不可能的。
关于这个问题 ,已经有几个 类似的 问题 ,但是都已经很老了,build议的scheme也不适合我的需求。 NDoc是相当不错的,但它不再被维护,不支持最近的function(扩展方法,附加属性…)。 我不喜欢Docu和Doxygen生成的文档样式,我正在寻找一种可以生成MSDN样式文档的工具。
那么,有没有其他工具可以使用? 还是我坚持与Sandcastle?
有几个商业产品能够做到这一点,例如
http://www.doc-o-matic.com/features.html
但是我个人认为你可能会考虑Monodoc,
http://www.mono-project.com/Monodoc
Mono(MonoTouch / Mono for Android)仍在积极使用它,所以它不会像Sandcastle一样。
对于C# : Innovasys文档! X代表C#文档
MSDNtypes的文档。 我相信还有很多其他好的select,价格依赖。
示例 (很不错的用户界面)
帮助工作室 : Innovasys HelpStudio 2011
跨平台的帮助生成器。 多输出格式。 允许导入。
另外 :
- 你有没有尝试过这篇文章: C#和XML源代码文档
- 修改Doxygen输出样式: 修改Doxygen样式表
由Roland Weigelt提供的GhostDoc Pro :
build立帮助文件 – CHM,MS帮助2,MS帮助查看器和网站
Sandcastle帮助文件生成器对我很好。
另一个替代是Helixoft VSdocman :
以多种本地化格式创build专业技术文档 – HTML,CHM,Microsoft帮助查看器(VS 2013/2012/2010帮助),MS Help 2(VS 2002 – 2008帮助),Docx(MS Word中使用的OOXML格式,可以是轻松导出为PDF),RTF,帮助和手册,XML和其他。
ApiStack.net处于testing阶段。 这是一个网站,而不是一个独立的工具来生成独立的文档,但这不应该是一个开源项目的问题。 它旨在支持F#,但作者声称它应该适用于包括C#在内的其他.net语言。
目前在apistack.net上公开的项目很less有完整的文档,请参阅F#的核心库,以获取有关该网站function的有趣示例。
我是新的文件生成。净,但显然Sandcastle 2012年4月v2.7.0.0完整版已经出来,可以从下面的链接下载,
http://sandcastlestyles.codeplex.com/releases/view/86091
它声明此构build修复了以前所有已知的错误。 所以可能值得探索。