是否有可能将由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输出,并且对这种方法感兴趣,我会很乐意进一步提供帮助。