Cart
[Home] [By Thread] [By Date] [Recent Entries]
Simon St.Laurent wrote: >2.6.1 Documentation Extensions > >Human-readable documentation for XSchemas should be provided using the Itsy >Bitsy Teeny Weeny Simple Hypertext format created by John Cowan. The full DTD >is available at http://www.ccil.org/~cowan/XML/ibtwsh.dtd. Documentation that >uses portions of the IBTWSH format may be included in the XSC:Doc element, a >subelement available to all declarations. The XSC:Doc element provides basic >formatting options for XSchema documentation. I wonder how one should make (possible) hyperlinks in the doc to other items inside the XSchema, something "equivalent" to the below: Doc for ElementX: ------------------- "ElementX is for purpose X, it is quite similar to <ElementName>ElementY</ElementName>, but differs a bit, especially the attribute <AttributeName>AttributeInX</AttributeName> is very different from the corresponding <AttributeName Element="ElementY">AttributeInY</AttributeName> in <ElementName>ElementY</ElementName>." Using something like this makes it easy to strip the "hyperlinks" away, or to convert/process them into real hyperlinks in the end-product documentation. (An XSchema viewer/editor could of course render them as hyperlinks directly) Does there already exist a standard way of doing this? Cheers, Jarle Stabell xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@i... Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ To (un)subscribe, mailto:majordomo@i... the following message; (un)subscribe xml-dev To subscribe to the digests, mailto:majordomo@i... the following message; subscribe xml-dev-digest List coordinator, Henry Rzepa (mailto:rzepa@i...)
|
