XSD 文件中的 CHM 文件
是否可以从 XSD 文件创建 CHM 文件或 HTML 帮助(类似于 Sandcastle 创建的文件)? xs:documentation
节点中的文本包含文档。
我拥有的 XSD 文件之一的示例片段是
<xs:element name="Request" type="RequestType">
<xs:annotation>
<xs:documentation>
<html:p>The Request message contains a number of <html:i>RequestType</html:i> elements for the server to process.</html:p>
<html:p>A <html:i>Request</html:i> will always result in a <html:i>Response</html:i> message being returned by the server, and <html:b>must</html:b> contain an <html:b>xmlns=[<html:i>Default namespace</html:i>]</html:b> declaration.</html:p>
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Response" type="ResponseType">
<xs:annotation>
<xs:documentation>The Response message contains the result of a previous <html:i>Request</html:i> message, with one <html:i>ResponseType</html:i> element for each <html:i>RequestType</html:i> sent to the server.</xs:documentation>
</xs:annotation>
</xs:element>
Is it possible to create a CHM file or HTML help (akin to those created by Sandcastle) from an XSD file? Text in the xs:documentation
nodes contains, well, the documentation.
An example snippet from one of the XSD files I have is
<xs:element name="Request" type="RequestType">
<xs:annotation>
<xs:documentation>
<html:p>The Request message contains a number of <html:i>RequestType</html:i> elements for the server to process.</html:p>
<html:p>A <html:i>Request</html:i> will always result in a <html:i>Response</html:i> message being returned by the server, and <html:b>must</html:b> contain an <html:b>xmlns=[<html:i>Default namespace</html:i>]</html:b> declaration.</html:p>
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Response" type="ResponseType">
<xs:annotation>
<xs:documentation>The Response message contains the result of a previous <html:i>Request</html:i> message, with one <html:i>ResponseType</html:i> element for each <html:i>RequestType</html:i> sent to the server.</xs:documentation>
</xs:annotation>
</xs:element>
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(2)
XML 架构文档管理器 是一个 Sandcastle 帮助文件生成器 插件,允许您将 XML 架构的参考文档集成到帮助文件中。
XML Schema Documenter is a Sandcastle Help File Builder plug-in that allows you to integrate reference documentation for XML schemas in your help files.
有一个名为“xs3p”的 XSLT,可以从 xml.fiforms.org/xs3p 下载。
您可以使用任何 XSLT 处理器将 XSD 转换为 HTML - 我使用“nxslt3”奥列格·特卡琴科。
第二步是使用一些 Html 帮助构建器将多个 HTML 组合到 CHM 中。
马克
PS:忘了提及 - 当然,这两个工具都是免费的:-)
There's a XSLT called "xs3p" which can be downloaded from xml.fiforms.org/xs3p.
You can use any XSLT processor to convert your XSD into HTML - I use "nxslt3" by Oleg Tkachenko.
A second step would then be to combine several HTML into a CHM using some Html Help builder.
Marc
PS: forgot to mention - both tools are free, of course :-)