是否有可能将由SandCastle创build的两个页面合并成一个主页面?

对于项目中的每个class级,SandCastle都会创build(其中包括)两个页面:

  • 主页面,称为T_class_full_name ,带有说明,语法,inheritance层次结构和另请参见
  • 成员页面,称为AllMembers_T_class_full_name ,带有构造函数,方法,字段等

有没有办法将这两者合并 – members page被添加到主页面?

我无法为此提供一个可行的答案,但是如果有人愿意破解它,我可以提供一些可能有效的想法:

1.configurationhtmlBody.xsl定义了一些结构,包括一个testing成员的部分: <xsl:if test="$subgroup='members'">如果这是在类级别打开(或者设置为真的,它可能会给你一个关于如何产生输出的想法。(我不认为这里会有一个神奇的子弹设置)。

2.这里是(我认为)在哪里添加成员子群组的链接,我也会玩这个:

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

3.我还有其他的想法,试图结构,但我需要破解它提供任何明确的答案。 我甚至不确定htmlBody.xsl是做这个的地方。 如果我真的有这个需要,我想我可以通过以下方法达到目标:

  • 以标准方式生成文档
  • parsing生成的文档,并使用DOM / XMLparsing器合并两者(即将两者合并到代码中,并输出新的单页HTML文档,并将URL更新为当前页面上的锚点)

好的是,在生成的文件和链接中使用了一致的命名scheme,所以我认为编写这个过程会更容易,并且将所有链接更新为锚点,而不是使用模板混淆太多。 实际上,对于那些经历过这种types的文档操作的人来说,实现这个目标是相当容易的。

警告:我甚至没有接近SandCastle的专家,只是在一年之内就使用了它。 我以前也没有花时间在考虑如何破解它,只是开箱即用。 除了没有其他答复之外,我甚至没有回应。 有可能是一个支持的configuration方式来完成这一点,但我作为一个偶然的用户甚至不能考虑如何处理它。

我在这里也会根据我对SHFB的经验,对HTML输出的外观做一些假设。 我也可能在那里过度。 我不再有一个可以生成sandcastle文档的项目,但是如果有人可以发布一个链接到SandCastle的一些HTML输出,并且对这种方法感兴趣,我会很乐意进一步提供帮助。