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？