良好的替代品，以沙堡生成MSDN样式文档 [英] Good alternatives to Sandcastle to generate MSDN-style documentation
问题描述
我已经用沙堡2年来产生一个开放源码库的文档是。但现在我正在寻找一个替代方案，因为：
I've been using Sandcastle for 2 years to generate the documentation for an open-source library. But now I'm looking for an alternative, because:
- 即使使用沙堡帮助文件生成器，沙堡是我的口味太复杂。生成的文件应该是简单，只要点击在Visual Studio中的一个按钮或菜单。
- 似乎该项目并没有维持了;最新版本发布于2010年6月，有似乎没有被任何人仍在工作就可以了。错误不再被固定，这对我来说（我的图书馆大量使用扩展方法，并这个bug是一个大问题打乱了一切）
- 由于这将是一个开源项目，商业产品如VSdocman和文档！ X的出了问题对我来说。
- Even when using Sandcastle Help File Builder, Sandcastle is too complex for my taste. Generating documentation should be as simple as clicking a button or menu in Visual Studio.
- The project doesn't seem to be maintained anymore; the latest version was released in June 2010, and there doesn't seem to be anyone still working on it. Bugs are not fixed anymore, which is a big issue for me (my library makes heavy use of extension methods, and this bug messes up everything)
- Since it will be an open-source project, commercial products such as VSdocman and Document! X are out of the question for me.
目前已经有<一href="http://stackoverflow.com/questions/1205621/whats-the-most-widely-used-documentation-tool-for-c">several <一href="http://stackoverflow.com/questions/48381/generating-documentation-from-c-sharp-xml-comments">similar <一href="http://stackoverflow.com/questions/986741/sandcastle-still-the-right-thing-to-use-or-are-there-alternatives">questions对SO，但他们都比较老了，建议的替代品不适合我的需要。 NDoc的是pretty的不错，但它不能维持了，不支持最新的功能（扩展方法，附加属性...）。我不喜欢用实况和Doxygen的产生的文档的风格，我在寻找一个能产生MSDN风格的文档工具。
There are already several similar questions on SO, but they're all quite old, and the suggested alternatives don't fit my needs. NDoc was pretty good, but it's not maintained anymore and doesn't support recent features (extension methods, attached properties...). I don't like the style of the documentation produced by Docu and Doxygen, I'm looking for a tool that produces MSDN-style documentation.
那么，有没有我可以用其他的工具？还是我坚持与沙堡？
So, is there any other tool I could use? Or am I stuck with Sandcastle?
推荐答案
有能力这几个商业产品，如
There are several commercial products capable of this, such as
http://www.doc-o-matic.com/features.html
不过，我个人认为可以考虑Monodoc，
But personally I think you may consider Monodoc,
http://www.mono-project.com/Monodoc
它仍然是积极地使用单声道（MonoTouch的/单声道为Android），这样就不会落得像沙堡。
It is still actively being used by Mono (MonoTouch/Mono for Android) so it won't end up like Sandcastle.
这篇关于良好的替代品，以沙堡生成MSDN样式文档的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！
