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

Re: Documenting XML Dialects With Instance Documents


documenting xml
The schematron-report tool creates a two-pane linked view to
a document.  The errors are in one pane: double click and the
other pane will jump to the correct place.[1]  This is availble
open source on the web, and in free Topologi's Schematron Validator.

You could invert the logic so that matching contexts are located. 
The general jumping framework owes itself to David Carlisle.

I guess you are wanting to go the other way: select a node and
find out which patterns match.  I don't know of any existing tool
that goes this way round yet for Schematron, however it is just a 
matter of  seeing whether a node matches a context path and 
satisifes some xpath expressions.

Cheers
Rick Jelliffe

[1] Screenshot at http://www.topologi.com/products/validator/doc/using4.html


----- Original Message ----- 
From: "Doug Ransom" <Doug.Ransom@p...>
To: "Xml-Dev@Lists. Xml. Org (E-mail)" <xml-dev@l...>
Sent: Wednesday, March 26, 2003 10:11 AM
Subject: RE:  Documenting XML Dialects With Instance Documents


I am thinking more along the lines of our RDDL documentation.  We will publish schemas on the rddl page, and publish a sample instance document for illustrative purposes.  There is a bit of a semantic gap for the reader between the schemas and instance document.  Examplotron isn't quite what I have in mind (and it targets Relax, while we prefer XML Schema & Schematron). What I am looking for is a reusable way to create annotated instance documents. As the user navigates the annotated document they see schema rules which apply and some natural language documentation as well. 

I could see implementing this as a document which has pointers to or fragments of the instance document and pointers to the relevant schemas bits. 



> -----Original Message-----
> From: Dare Obasanjo [mailto:dareo@m...]
> Sent: Tuesday, March 25, 2003 3:00 PM
> To: Doug Ransom; Xml-Dev@Lists. Xml. Org (E-mail)
> Subject: RE:  Documenting XML Dialects With Instance 
> Documents
> 
> 
> Inline Schema? 
> 
> http://msdn.microsoft.com/library/en-us/cpguide/html/cpconvali
> dationwith
> inlinexsdschema.asp
> 
> -- 
> PITHY WORDS OF WISDOM 
> You can never tell which way the train went by looking at the track.
> 
> 
> This posting is provided "AS IS" with no warranties, and confers no
> rights. 
> 
> >  
> >  
> > -----Original Message-----
> > From: Doug Ransom [mailto:Doug.Ransom@p...] 
> > Sent: Tuesday, March 25, 2003 11:56 AM
> > To: Xml-Dev@Lists. Xml. Org (E-mail)
> > 
> > Does anyone know of useful tools or techniques to annotate an 
> > instance document WRT its Schemas (typically both an XML 
> > Schema and Schematron in our case)?  I think people like to 
> > look at the instance document and see the relevant bits of 
> > the schemas than the other way around, perhaps in a frame 
> > beside the instance document.
> > 
> >  
> > 
> > Doug Ransom
> > Interoperability Architect
> > Power Measurement
> > 2195 Keating X Road
> > Saanichton, BC, Canada  V8M 2A5
> > Tel: 1-(250) 652-7100
> > E-Mail: <mailto:doug.ransom@p...>
> > Website: <http://www.pwrm.com/>
> > 
> > ION(r)  smart energy everywhere(tm)
> > 
> > 
> > -----------------------------------------------------------------
> > The xml-dev list is sponsored by XML.org 
> > <http://www.xml.org>, an initiative of OASIS 
> > <http://www.oasis-open.org>
> > 
> > The list archives are at http://lists.xml.org/archives/xml-dev/
> > 
> > To subscribe or unsubscribe from this list use the subscription
> > manager: <http://lists.xml.org/ob/adm.pl>
> > 
> > 
> 

-----------------------------------------------------------------
The xml-dev list is sponsored by XML.org <http://www.xml.org>, an
initiative of OASIS <http://www.oasis-open.org>

The list archives are at http://lists.xml.org/archives/xml-dev/

To subscribe or unsubscribe from this list use the subscription
manager: <http://lists.xml.org/ob/adm.pl>



PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.