我维护多个.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),因此可以选择自定义表示层。我也不反对编写自定义组件/插件,但到目前为止还无法理解如何更改默认行为。
提前感谢任何见解。
答案 0 :(得分:0)
经过进一步研究并直接向Sandcastle的首席开发人员提出这个问题,没有简单的解决方案。
可以找到完整的对话框on the project website。
简而言之,我最好的办法是为每个汇编库开发一个单独的帮助网站,并从父网站链接到它们。共享令牌文件有助于在一个位置维护反向引用路径并将其注入内容。