Search the web
Sign In
New User? Sign Up
rng-users · RELAX NG users
? Already a member? Sign in to Yahoo!

Yahoo! Groups Tips

Did you know...
Want your group to be featured on the Yahoo! Groups website? Add a group photo to Flickr.

Best of Y! Groups

   Check them out and nominate your group.
Having problems with message search? Fill out this form to ensure your group is one of the first to be migrated to the new message search system.

Messages

  Messages Help
Advanced
Generating an XML document from RelaxNG   Message List  
Reply | Forward Message #15 of 1125 |
documenting Relax NG

The Text Encoding Initiative schemas are maintained using a module
of the TEI called "tagdocs", which allows for describing elements,
attributes,
classes of elements, 'entities', and so on. The whole of the large TEI
Guidelines
are written in the same single document; hence the name of "ODD" for
this system - One Document Does it all.

The ODD format reverts to Relax NG markup for specifing the content
model of elements. From this we derive, as needed,

- documentaton (HTML, PDF, LaTeX, TEI XML etc)
- Relax NG schemas (RNC using trang)
- XSD schemas (using trang)
- DTDs (direct translation)

There is a complex and powerful system for writing customizations
(additions, deletions, changes, internationalization), expressed
in the same language.

Some pointers on http://www.tei-c.org/P5/; or I can describe
in detail as desired.


--
Sebastian Rahtz
Information Manager, Oxford University Computing Services
13 Banbury Road, Oxford OX2 6NN. Phone +44 1865 283431

OSS Watch: JISC Open Source Advisory Service
http://www.oss-watch.ac.uk




Thu Jun 30, 2005 7:21 am

sebastian.rahtz@...
Send Email Send Email

Forward
Message #15 of 1125 |
Expand Messages Author Sort by Date

... I believe docbook, tdg, is generated like this Jirka, but the schema has certain features that are written deliberately to enable the trace through the...
Dave Pawson
dpawson2000
Offline Send Email
Jun 30, 2005
7:09 am

The Text Encoding Initiative schemas are maintained using a module of the TEI called "tagdocs", which allows for describing elements, attributes, classes of...
Sebastian Rahtz
sebastian.rahtz@...
Send Email
Jun 30, 2005
7:21 am

Thanks Sebastian and everybody else that responded to this. What I mean is not a meta language, but the possibility to generate the documentation directly from...
George Cristian Bina
george_bina
Offline Send Email
Jun 30, 2005
1:24 pm

... Look to rng itself, and what's available. We could all do it, if the schema is 'special' to our way of working. What can you do that is within the rng rec...
Dave Pawson
dpawson2000
Offline Send Email
Jun 30, 2005
3:03 pm

Hi Dave, ... Sorry but I cannot follow you. Can you please expand a little? My question is if we should focus on patterns only or not. A schema is formed from...
George Cristian Bina
george_bina
Offline Send Email
Jul 1, 2005
11:52 am

... At some point your output, if XML will begin to look like the rng schema, perhaps with a variant syntax. If you constrained the schema author in some way,...
Dave Pawson
dpawson2000
Offline Send Email
Jul 1, 2005
3:01 pm

... hard bit. Right. That's why I was hoping some user would point to an existing example of documentation produced for DTDs or XML Schema and say, do it like...
Bob Foster
xmlbob
Offline Send Email
Jul 1, 2005
3:29 pm

... http://www.tei-c.org/P5/Guidelines/REFTAG.html do it like that -- Sebastian Rahtz Information Manager, Oxford University Computing Services 13 Banbury...
Sebastian Rahtz
sebastian.rahtz@...
Send Email
Jul 1, 2005
3:34 pm

Thanks. And (aside from the ugly but maybe useful first page) wow. This has the look of something produced automatically. Do you happen to have a link to the...
Bob Foster
xmlbob
Offline Send Email
Jul 1, 2005
4:25 pm

... indeed it is. ... There are no original schemas. The TEI is a single XML document containing all the information used to create schemas, DTDs, HTML...
Sebastian Rahtz
sebastian.rahtz@...
Send Email
Jul 3, 2005
10:37 pm

All the examples so far, including this one, are of documentation aimed at XML authors. Here's an entirely different take, aimed at schema authors (?): ...
Bob Foster
xmlbob
Offline Send Email
Jul 1, 2005
4:47 pm

... http://www.docbook.org/tdg/en/html/para.html They don't come much better. (or more useful) -- Regards, Dave Pawson XSLT + Docbook FAQ ...
Dave Pawson
dpawson2000
Offline Send Email
Jul 1, 2005
5:06 pm

Thanks, Dave. Now we're getting down to it. So far we've identified three kinds of documentation that can be automatically generated from a schema and have...
Bob Foster
xmlbob
Offline Send Email
Jul 1, 2005
6:23 pm

... In WXS, the combination of a child element's name and its parent's type determines the child's type uniquely. In RNG there are no guarantees. -- John...
John.Cowan
johnwcowan
Online Now Send Email
Jul 1, 2005
7:34 pm

For XML Schema the context is in general the path up to the root, as the root must be either a typed element or a global element or the path up to the first...
George Cristian Bina
george_bina
Offline Send Email
Jul 1, 2005
9:34 pm

... Yes, George and John, I know that. My suggestion to use paths to discriminate between elements with the same name was based on common use cases, not...
Bob Foster
xmlbob
Offline Send Email
Jul 1, 2005
10:48 pm

... I'd hope that if I see the element foobar, it has a single semantic. It may have 4 different content models, but I wouldn't think much of the schema author...
Dave Pawson
dpawson2000
Offline Send Email
Jul 2, 2005
8:57 am

Hi Dave, A schema documentation tool should present schema information and use the annotations to show additional developer to user information. The main idea...
George Cristian Bina
george_bina
Offline Send Email
Jul 1, 2005
4:23 pm

... I think we're drifting away from the original question here. DocBook NG contains additional markup designed to make it possible to generate documentation...
Norman Walsh
normwalsh
Online Now Send Email
Jun 30, 2005
3:57 pm

Thanks for all your comments and help. From what I can understand, there is no easy solution to generate an XML document from a RelaxNG schema (well besides...
Sylvain Hellegouarch
sh@...
Send Email
Jul 4, 2005
8:25 am

Sylvain, ... I had to do something similar for one of my customers and my conclusion is that it's impossible in the general case without XSLT extensions (at ...
Eric van der Vlist
evlist
Offline Send Email
Jul 4, 2005
8:41 am

Oh. Well then I know of one editor that does it. ;-} What format would you (and anyone else who's interested) like to see the documentation in? Bob Foster ...
Bob Foster
xmlbob
Offline Send Email
Jun 29, 2005
10:39 pm

... XML Bob? Then transform it to what is required. regards DaveP...
Dave Pawson
dpawson2000
Offline Send Email
Jun 30, 2005
7:10 am

... Sigh. RELAX NG is already XML. What is required? Bob...
Bob Foster
xmlbob
Offline Send Email
Jun 30, 2005
6:12 pm
 First  |  |  Next > Last 
Advanced

Copyright © 2009 Yahoo! Inc. All rights reserved.
Privacy Policy - Terms of Service - Guidelines - Help