是否可以使用 Doxygen、Sandcastle 或其他文档生成器来记录 XML?
我目前正在使用 Sandcastle、Doxygen 和 JavaDoc 为我编写的代码生成文档。是否可以使用这些包来记录 XML 模式?如果没有,是否有任何(最好是免费的!)软件包可以做到这一点?我可以自己编写文档作为 Doxygen 或 Sandcastle 中的额外概念主题,但我宁愿有一个工具为我完成这件事!
一个例子是(尽管我不是 XML 模式方面的专家!):
/// <summary>Top Node</summary>
<xs:element name="TopNode">
/// <summary>Child Node</summary>
<xs:element name="ChildNode" type="xs:string"/>
</xs:element>
I am currently using Sandcastle, Doxygen, and JavaDoc to generate documentation for code I have written. Is it possible to document XML schemas using these packages? If not, are there any (preferably free!) packages which can do this? I could write the documentation myself as an extra conceptual topic within Doxygen or Sandcastle, but I would rather a tool did it for me!
An example would be (although I am no expert at XML Schema!):
/// <summary>Top Node</summary>
<xs:element name="TopNode">
/// <summary>Child Node</summary>
<xs:element name="ChildNode" type="xs:string"/>
</xs:element>
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(2)
据我所知,唯一可以记录 XML 模式的工具是 DocFlex/XML XSDDoc。坦率地说,我没有太多使用它的经验,但尽管我很少使用它,但它做得相当不错。
The only tool that I know of that can document XML schemas is DocFlex/XML XSDDoc. Quite frankly, I don't have much experience using it but for what little use I did have of it, it did a pretty good job.
我刚刚开始使用 XML Schema Documenter ,它与 Sandcastle 帮助文件生成器 是一个满足我需求的完美组合,它是一个具有基于 XML 配置的 .NET 插件框架。
I've just started using XML Schema Documenter which integrates with Sandcastle Help File Builder and its a great combination for my needs which are a .NET plugin framework that has XML based configuration.