OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

 


 

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

[ Lists Home | Date Index | Thread Index ]
  • From: Jarle Stabell <jarle.stabell@dokpro.uio.no>
  • To: xml-dev@ic.ac.uk
  • 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@ic.ac.uk
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:majordomo@ic.ac.uk the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@ic.ac.uk the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@ic.ac.uk)





 

News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS