是否可以将 SandCastle 创建的两个页面合并到一个主页中？

Question

对于项目中的每个类，SandCastle 创建（除其他外）两个页面：

• 主页面，称为 T_class_full_name，其中包含描述、语法、继承层次结构和另请参阅
• 成员页面，称为 >AllMembers_T_class_full_name，包含构造函数、方法、字段等。

有没有办法将这两者合并在一起 - 将成员页面附加到主页？

Answer 1

我无法为此提供有效的答案，但我可以提供一些想法，如果有人愿意解决这个问题，这些想法可能会起作用：

1。
配置 htmlBody.xsl 定义了一些结构，包括一个包含成员测试的部分： 如果在类级别（或者只是设置为 true 它可能会让您了解如何生成输出。（我不认为这里会有灵丹妙药设置）。2

。
这是（我认为）添加到成员子组的链接的地方，我也会尝试这个：

<!-- add a link to the member list section for this subgroup -->
<a href="#{$elementVisibility}Toggle" onclick="OpenSection({$elementVisibility}Toggle)">

3。
我还有其他想法尝试使用该结构，但我需要对其进行破解才能提供任何明确的答案。我什至不确定 htmlBody.xsl 是否是执行此操作的地方。如果我真的有需要，我想我可以通过执行以下操作最简单地实现您的目标：

• 以标准方式生成文档
• 解析生成的文档并使用 DOM / XML 解析器合并这两个文档（即在代码和输出中合并这两个文档）一个新的单页 HTML 文档，其 URL 更新为当前页面上的锚点）

好的一点是，生成的文件和链接中使用了一致的命名方案，因此我认为编写此过程和更新会更容易所有的链接都是锚点，而不是与模板搞乱太多。实际上，我认为对于具有此类文档操作经验的人来说，这将是相当容易完成的。

警告：我什至都不是 SandCastle 专家，一年多前我只使用过它最少的内容。在今天之前我也没有花时间考虑如何破解它，只是开箱即用。如果没有其他回应，我什至不会回应这一点。可能有一种受支持的配置方法来完成此操作，但作为一个临时用户，我什至不知道如何处理它。

我还根据我使用 SHFB 的经验，对 HTML 输出的外观做出了一些假设。我也可能在这方面做得太过分了。我不再有一个可以生成 sandcastle 文档的项目，但如果有人可以发布 Sandcastle 的一些 HTML 输出的链接，并且对这种方法感兴趣，我将很乐意提供进一步的帮助。