Tag: sandcastle

什么规则适用于SHFB的IntelliSenseComponent的输出文件夹？: 野田时间有一个问题反对它，它的XML文档文件包含所有的内部和私人成员也 – 这是一个耻辱。幸运的是， Sandcastle帮助文件生成器有一个自定义生成组件 – IntelliSenseComponent – 理论上完成正确的事情…。不幸的是，我无法弄清楚如何正确configuration它。文档给出了这个例子： <output includeNamespaces="false" namespacesFile="Namespaces" folder="{@OutputFolder}" /> 并指出：上面的例子是从Sandcastle帮助文件生成器的configuration文件中获取的。与它一起使用时，将使用replace标记{@SHFBFolder}和{@OutputFolder}将帮助文件构build器的文件夹和项目的输出文件夹插入到文件path中。这些在构build时被replace为适当的值。如果在您自己的构build脚本中使用该组件，请分别用相对或绝对pathreplace组件组件和输出文件夹的标签。那么，我正在使用SHFB，所以我期望这个工作。但是，除了绝对的工作path以外，我什么都得不到。我试过了： folder="." folder="{@OutputFolder}" folder="{@OutputFolder}XYZZY" folder="{@OutputFolder}\XYZZY" folder="{@OutputFolder}/XYZZY" folder="{@OutputFolder}/XYZZY/" （我只是使用XYZZY作为一个很容易search的东西。）看着源代码，我希望我可以使用一个环境variables，但是这不起作用： folder="%CD%\XYZZY" 虽然这样做… folder="%USERPROFILE%\XYZZY" 这工作： folder="c:\users\jon\test\xyzzy" …但我真的不想在那里有一个绝对的path名称。文件表明，所有这一切应该很容易…我错过了什么？涉及的版本： SHFB：1.9.3.0 沙堡：2.6.10621.1

如何找出造成Sandcastle文档的不同之处？: 在Noda时间，我们使用Sandcastle和SHFB生成我们的文档。然后我们将文档提交到源代码库 – 主要是因为这使得查看最新（和历史）文档变得容易。我是该项目的主要开发人员，但是我使用了两台计算机 – 不幸的是，目前他们正在构build不同的文档，即使它们都被更新为相同的源文件。这两台电脑在我所能想到的每一个重要方面都是一样的： Sandcastle 2.7.2.0 SHFB 1.9.6.0 VS 2012 Professional（均在“程序”中报告了版本11.0.50727.1，“关于”页面中的版本11.0.51106.01更新1）适用于.NET Framework 4.5的本地帮助内容的最新版本（对于其他框架版本没有本地帮助内容）采取了一些步骤来确保构build清晰：删除SHFBcaching文件夹（ C:\Users\Jon\AppData\Local\EWSoftware\Sandcastle Help File Builder\Cache ）删除文档生成到的文件夹删除了与SHFB项目文件相关的用户设置文件在Visual Studio中删除了符号caching 仍然存在差异。它们似乎仅限于从MSDN本身inheritance的文档，特别是Object.Finalize 。版本1（在机器上生成“Chubby”）： <div class="summary">Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.</div> 版本2（在“Sandy”机器上生成）： […]