2008-08-03 103 views
14

是否有一种简单的方法从Visual Studio XML输出生成MSDN样式的文档?
我并不耐心为它设置好的xslt,因为我知道我不是第一个穿越这座桥的人。.Net XML注释到API文档

而且,我想最近设立沙塔,但它真的让我的目光交错。要么我在这个过程中失去了一些重要的东西,要么就是太牵扯其中。

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

,因为我觉得我的格式制作的那款非邀请阅读我在这里重申:

我给沙塔一试,但有一个很艰难的时期得到它成立。 我真正想到的是更简单的事情。

也就是说,除非我只是不了解sandcastle过程。对我来说,这似乎是一个额外的包袱,只是为了让测试人员能够合作创造一些好东西。

回答

5

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

3

我刚刚建立了沙堡。尝试安装它(2008年5月发行)并搜索SandcastleGui.exe或类似的东西(它在示例文件夹左右)。

单击添加程序集并添加您的程序集或程序集,添加任何.xml文档文件(如果启用该选项,则由编译器生成)。

这将需要一些时间,但结果是值得的努力。它实际上会查找MSDN中的东西,因此您的结果文档也会将类继承一直引导到System.Object,并指向MSDN和其他东西。

沙堡看起来有点复杂,特别是当你想在自动化构建中使用它时,但我绝对相信它是值得的。

也看看Sandcastle Help File Builder,这是一个更先进的图形用户界面。