[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Cross linking inside XSchema documentation? (XSchema Spec Section 2.6)

• From: Jarle Stabell <jarle.stabell@d...>
• To: xml-dev@i...
• Date: Tue, 30 Jun 1998 20:13:27 +0200

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...)

• Prev by Date: Re: extensibility in XSchema?
• Next by Date: 'Optional' vs 'Implied' in XSchema
• Previous by thread: Re: XSchema 1.0 proposals, preparing the ground
• Next by thread: RE: Cross linking inside XSchema documentation? (XSchema Spec Section 2.6)
• Index(es):
  • Date
  • Thread