sandcastle - 将 Sandcastle 装配文档分成多个导航目录

Question

我维护多个 .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），所以表示层的自定义是一个选项。我也不反对编写自定义组件/插件，但到目前为止还无法理解如何更改默认行为。

提前感谢您的任何见解。

Answer 1

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

完整的对话可以在项目网站上找到。

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