2010-01-12 108 views
68

对于项目中的每个类,沙堡创建(其中包括)两页:是否可以将由SandCastle创建的两个页面合并到一个主页面中?

  • 主页面,称为T_class_full_name,与描述,语法,继承层次结构,请参见
  • 成员页面,被称为AllMembers_T_class_full_name,与构造函数,方法,字段等

有没有办法将这两个合并在一起 - 与members page被附加到主网页?

+5

我也很喜欢这个!原型PresentationStyle可以做到这一点,但我更喜欢vs2005的输出风格。 (Prototype在Firefox中看起来真的很可怕。) – 2010-02-12 16:46:01

+0

谢谢,我会检查出原型。 – 2010-02-14 21:16:18

回答

2

我不能为此提供一个工作的答案,但如果有人愿意来破解它周围,我可以提供一些想法,可能工作:

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更新为当前页面上的锚点)

好的是,在生成的文件和链接中使用了一致的命名方案,所以我认为写这个过程会更容易,并且将所有链接更新为锚点而不是更新o模板太乱了。我其实觉得这对于那些经历过这类文档操作的人来说很容易完成。

警告:我甚至没有接近SandCastle专家,只是在最低限度和一年前使用过它。今天之前,我也没有花时间考虑如何破解它,只是开箱即用。除了缺乏其他答案之外,我甚至都没有回应。可能有支持的配置方式来完成此操作,但作为临时用户,我甚至无法考虑如何处理它。

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

相关问题