我使用Doxygen为我的SDK制作了文档.它包含文件,名称空间,类,类型等的列表 - 我在代码中作为Doxygen注释放置的所有内容.现在我想写一些关于SDK(介绍类型)的一般信息,它与任何代码元素都没有直接关系.我想将此介绍放在文档起始页面上.我怎样才能做到这一点？
我想添加自定义(非项目)文件以使用Doxygen生成一些额外的页面.
我(实际上)不确定应该如何命名这些文件以及如何格式化它们的内容.
我目前正在使用Sandcastle,Doxygen和JavaDoc为我编写的代码生成文档.是否可以使用这些包记录XML模式？如果没有,是否有任何(最好是免费!)包可以做到这一点？我可以自己编写文档作为Doxygen或Sandcastle中的额外概念主题,但我宁愿为我做一个工具!
一个例子是(虽然我不是XML Schema的专家!):
/// <summary>Top Node</summary>
<xs:element name="TopNode">
/// <summary>Child Node</summary>
<xs:element name="ChildNode" type="xs:string"/>
</xs:element>