Tag: 沙堡

.Net项目上的命名空间文档(Sandcastle)?

我前段时间开始使用Sandcastle来为我们的一个项目生成文档网站。 它工作的很好,但是我们总是只为我们的项目中的类,方法,属性(…)编写文档,并且已经完全分离了整个项目和项目部分/模块/名称空间的文档。 这将是很好,如果我可以将文档合并在一起,并将相应的文档添加到生成的帮助文件,但我不知道如何做到这一点。 只是将注释添加到名称空间声明似乎不起作用(C#): /// <summary> /// My short namespace description /// </summary> namespace MyNamespace { … } 有谁知道如何做到这一点? 我知道这是可能的,这将是非常好的有… 🙂

是否有可能将由SandCastle创build的两个页面合并成一个主页面?

对于项目中的每个class级,SandCastle都会创build(其中包括)两个页面: 主页面,称为T_class_full_name ,带有说明,语法,inheritance层次结构和另请参见 成员页面,称为AllMembers_T_class_full_name ,带有构造函数,方法,字段等 有没有办法将这两者合并 – members page被添加到主页面?

Sandcastle生成MSDN样式文档的好替代方法

我已经使用Sandcastle 2年来生成一个开源库的文档。 但现在我正在寻找替代品,因为: 即使在使用Sandcastle帮助文件生成器时 ,Sandcastle对我来说太复杂了。 生成文档应该与在Visual Studio中单击button或菜单一样简单。 该项目似乎不再被维护; 最新版本于2010年6月发布,目前似乎还没有人正在进行这项工作。 错误不再是固定的,这对我来说是一个很大的问题(我的程序库大量使用扩展方法,而这个错误弄糟了所有的东西) 由于它将是一个开源项目,商业产品如VSdocman和Document! X对我来说是不可能的。 关于这个问题 ,已经有几个 类似的 问题 ,但是都已经很老了,build议的scheme也不适合我的需求。 NDoc是相当不错的,但它不再被维护,不支持最近的function(扩展方法,附加属性…)。 我不喜欢Docu和Doxygen生成的文档样式,我正在寻找一种可以生成MSDN样式文档的工具。 那么,有没有其他工具可以使用? 还是我坚持与Sandcastle?