21

有没有一种从 Visual Studio XML 输出生成 MSDN 样式文档的简单方法?
我没有足够的耐心来为它设置一个好的 xslt,因为我知道我不是第一个跨过这座桥的人。

另外,我最近尝试设置沙堡,但它确实让我的眼睛交叉。要么我在这个过程中遗漏了一些重要的东西,要么就是太投入了。

我知道有人有一个非常好的非常简单的解决方案。

我在这里重申,因为我认为我的格式使该段落不宜阅读:

我尝试了沙堡,但设置起来非常困难。我真正想到的是更简单的事情。

也就是说,除非我只是不了解沙堡过程。对我来说,仅仅为测试人员提供一些可以使用的好东西,这似乎是一大堆额外的包袱。

4

6 回答 6

12

你在找沙堡

项目页面:沙堡发布

博客:沙堡博客

.NET 的 NDoc 代码文档生成器曾经是首选工具,但几乎停止了支持。

于 2008-08-03T22:12:52.820 回答
5

看看Sandcastle,它就是这样做的。它也是目前更简单的解决方案之一,它或多或少是首选工具,所以从长远来看,如果您指定在设置过程中遇到的问题,也许我们可以帮助您设置 Sandcastle?

于 2008-08-03T22:14:55.453 回答
5

我刚刚再次设置了 Sandcastle。尝试安装它(2008 年 5 月版本)并搜索 SandcastleGui.exe 或类似的东西(它在示例文件夹中)。

单击 Add Assembly 并添加您的 Assembly 或 Assemblies,添加任何 .xml 文档文件(如果您启用了该选项,则由编译器生成的文件)然后构建。

这将需要一些时间,但结果是值得的。它实际上会从 MSDN 中查找内容,因此您生成的文档也将具有一直到 System.Object 的类继承以及指向 MSDN 和内容的链接。

一开始 Sandcastle 似乎有点复杂,尤其是当您想在自动构建中使用它时,但我绝对相信这将是值得的。

还可以看看Sandcastle Help File Builder,这是一个更高级的 GUI。

于 2008-08-04T10:27:05.270 回答
5

您还应该使用 Sandcastle 帮助文件生成器。它为您提供了一个类似于 GUI 的 ndoc 来生成帮助文件,因此您无需从命令提示符处执行任何操作。

欢迎来到 Sandcastle 帮助文件生成器项目

于 2008-09-19T15:22:17.057 回答
4

按照这个简单的 5 步文章,你就大功告成了。作为奖励,您可以使用H2Viewer查看 Html Help 2.x 文件。

于 2008-08-04T10:31:33.220 回答
2

我使用NDoc3

于 2010-02-21T22:12:47.673 回答