1

好吧，标题问了一切。

我有 Sandcastle 帮助文件生成器 GUI。我可以生成帮助文件，但我想知道除了重新编译整个帮助文件之外，是否有更快的方法来查看结果。

我询问了 Sandcastle，因为我尝试过的其他提供预览功能的工具不会像 Sandcastle 那样将帮助文件编译成确切的规范。他们中的大多数都需要完全合格的参考资料，这很麻烦。

4

2 回答 2

2

不，没有预览功能，但有一些 SHFB 设置可以让您显着减少构建时间。就我而言，我 16 到 18 分钟的构建时间缩短到了 3 分钟。

您要调整的是Cached Build Components。不用担心，调整这 3 个组件不需要神秘的操作或复杂的旋转。

  1. 只需转到 SHFB GUI 中的Build部分，然后在顶部附近找到标有ComponentConfigurations的行。
  2. 单击值字段以显示隐藏的省略号 (...) 按钮。
  3. 单击该按钮以打开“选择并配置构建组件”对话框。
  4. 依次选择以Cached...开头的三个条目中的每一个，然后选择 Add 操作。
  5. 这些不需要配置，因此关闭对话框，如果成功，主 SHFB 窗口现在应该指示3 个自定义构建组件。

请务必查看上述链接中的文档以获取更多详细信息。

只是为了完整起见，另外两个感兴趣的项目：

查看此论坛帖子（Sandcastle 构建需要数小时才能完成），其中讨论了您的硬件如何对 Sandcastle 构建时间产生巨大影响。

看看我的文章Taming Sandcastle: A .NET Programmer's Guide to Documenting Your Code on Simple-Talk.com 讨论了 Sandcastle 和 SHFB 的很多技巧和陷阱——具有讽刺意味的是，我在这里发现了关于缓存构建组件的技巧之后那篇文章已经出版，所以你不会在那里找到它！

于 2011-07-13T00:42:48.817 回答
1

在 SandCastle GUI 中，转到菜单 Window 并打开 Topic Previewer Window。

如果您安装了 Visual Studio 和 Sandcastle VSiX 扩展，请转到 Visual Studio 菜单视图 > 其他窗口，然后单击主题预览器窗口。

请参阅https://ewsoftware.github.io/SHFB/html/d3c7584d-73c0-4725-87f8-51e4ad956694.htm。

于 2017-04-28T12:24:04.010 回答