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

Question

对于项目中的每个类,SandCastle创建(以及其他)两个页面:

• 主页面,称为T_class_full_name,带有描述,语法,继承层次结构和另请参阅
• 成员页面,称为AllMembers_T_class_full_name,带有构造函数,方法,字段等.

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

Answer 1

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

1. 配置 htmlBody.xsl 定义了一些结构，包括包含成员测试的部分：<xsl:if test="$subgroup='members'">如果在类级别打开此功能（或者只是设置为 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 输出的链接，并且对这种方法感兴趣，我将很乐意提供进一步的帮助。