将 Sandcastle 程序集文档分成多个导航目录
Separating Sandcastle Assembly Documentation into Multiple Navigation TOCs
我维护多个 .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),所以表示层的自定义是一个选项。我也不反对编写自定义 component/plugin,但到目前为止还无法理解如何更改默认行为。
提前感谢您的任何见解。
经过进一步研究并直接向 Sandcastle 的首席开发人员提出这个问题,没有简单的解决方案。
可以找到完整的对话框 on the project website。
简而言之,我最好的办法是为每个程序集库开发一个单独的帮助网站,并 link 从父网站向它们提供帮助。共享令牌文件有助于在一个地方维护反向引用路径并将它们注入内容。
我维护多个 .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),所以表示层的自定义是一个选项。我也不反对编写自定义 component/plugin,但到目前为止还无法理解如何更改默认行为。
提前感谢您的任何见解。
经过进一步研究并直接向 Sandcastle 的首席开发人员提出这个问题,没有简单的解决方案。
可以找到完整的对话框 on the project website。
简而言之,我最好的办法是为每个程序集库开发一个单独的帮助网站,并 link 从父网站向它们提供帮助。共享令牌文件有助于在一个地方维护反向引用路径并将它们注入内容。