将Sandcastle Assembly文档分成多个导航TOC

时间:2016-06-08 19:55:57

标签: sandcastle shfb

我维护多个.NET程序集,每个程序集都有自己独立的发布周期。我打算为所有这些程序集生成一个帮助网站,同时将概念内容和命名空间文档分成不同的组。

以下是我希望完成的简化结构:

Overview Library A --Overview --Release notes --**Library A generated Namespace/Assembly documentation** Library B --Overview --Release notes --**Library B generated Namespace/Assembly documentation** Library C --Overview --Release notes --**Library C generated Namespace/Assembly documentation**

就目前而言,这是我能够成功制作出来的所有内容:

Overview Library A --Overview --Release notes Library B --Overview --Release notes Library C --Overview --Release notes **Library A, B, and C generated Namespace/Assembly documentation**

我已经有了自定义的演示风格(基于现有的VS2013),因此可以选择自定义表示层。我也不反对编写自定义组件/插件,但到目前为止还无法理解如何更改默认行为。

提前感谢任何见解。

1 个答案:

答案 0 :(得分:0)

经过进一步研究并直接向Sandcastle的首席开发人员提出这个问题,没有简单的解决方案。

可以找到完整的对话框on the project website

简而言之,我最好的办法是为每个汇编库开发一个单独的帮助网站,并从父网站链接到它们。共享令牌文件有助于在一个位置维护反向引用路径并将其注入内容。