68

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

  • 主页，称为T_class_full_name，带有描述、语法、继承层次结构和另见
  • 成员页面，称为AllMembers_T_class_full_name，带有构造函数、方法、字段等。

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

4

1 回答 1

2

我无法为此提供有效的答案，但如果有人愿意破解它，我可以提供一些可能有用的想法：

<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 是否适合执行此操作。如果我在这里真的有需要，我想我可以通过执行以下操作最容易地实现您的目标：

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

好消息是在生成的文件和链接中使用了一致的命名方案，所以我认为编写这个过程并将所有链接更新为锚点比用模板弄乱太多更容易. 实际上，我认为对于有此类文档操作经验的人来说，这将很容易完成。

警告：我什至没有接近 SandCastle 专家，一年多以前只使用过它。在今天之前，我也没有花任何时间考虑如何破解它，只是开箱即用。我什至不会对此做出回应，除非没有其他回应。可能有一种受支持的配置方式可以实现这一点，但作为一个普通用户，我什至无法想到如何处理它。

根据我对 SHFB 的经验，我还在这里对 HTML 输出的外观做出了一些假设。我也可能在那儿做得过火。我不再有可以从中生成沙堡文档的项目，但是如果有人可以发布指向 SandCastle 的某些 HTML 输出的链接并且对这种方法感兴趣，我将很乐意提供进一步的帮助。

于 2013-01-28T22:13:29.723 回答