RE: [ubl-dev] Stylesheets for HTML rendering of genericode and UBLcontext/value association files

[Juerg Tschumperlin <juerg.tschumperlin@minedu.govt.nz>]

Hi,

The New Zealand Ministry of Education is currently adopting the OASIS UBL
Methodology for Code List and Value Validation (Draft 0.8).

The stylesheets kindly supplied by Ken Holman this weekend are proving very
valuable to us already. They appear to work fine in our initial tests.

The value of these stylesheets lies in their simple to use capability to
display the information contained in context/value association files and
genericode files in an organized and presentable fashion.

This information forms an integral part of the trading partner agreement,
which needs to be clearly understood by a number of people, some of which are
not necessarily familiar with reading XML files. In fact, the angle brackets
have in the past shown to scare some of them.

These stylesheets provide an elegant method to use the real XML files for
user-friendly trading partner agreement documentation, without the need for
deriving such documentation which could easily get out of synch with the real
XML files.

An excellent piece of work - highly recommended. Thank you Ken.

Regards

Juerg Tschumperlin  
New Zealand Ministry of Education



> -----Original Message-----
> From: G. Ken Holman [mailto:gkholman@CraneSoftwrights.com]
> Sent: Sunday, 10 December 2006 4:09 p.m.
> To: UBL-Dev
> Subject: [ubl-dev] Stylesheets for HTML rendering of genericode and UBL
> context/value association files
> 
> Fellow UBL Dev mail list members,
> 
> As part of the specification of the context/value association files
> in the UBL methodology for code list and value validation, it is
> possible to embed elements of foreign namespaces into the file for
> documentation purposes.
> 
> This embedded foreign vocabulary could be simple text (as illustrated
> in the methodology), XHTML, DocBook, or any other XML vocabulary.
> 
> If one chooses to use XHTML, then Crane has published stylesheets
> used to render this documentation in standalone HTML reports or
> directly in XSLT-aware web browsers such as Firefox and Internet Explorer.
> 
> As part of this work, it is necessary to render the content of
> genericode files with the lists of coded values.  I've modularized
> the stylesheets so that if you have genericode files and you want to
> render their content in a standalone fashion (rather than as part of
> a context/value file rendering), you can do so.
> 
> Both stylesheets can be used by standalone XSLT processors to create
> standalone HTML files, or you can use a stylesheet association
> processing instruction in a genericode file or context/value
> association file to trigger the HTML rendering in an XSLT-aware browser.
> 
> These files will be helpful to you if you need to present the content
> of these files without exposing markup to those who are averse to
> seeing angle brackets.  The content is hyperlinked and the codes and
> meta data are presented in an orderly fashion in tables.
> 
> To download a copy of these freely-available stylesheets, please
> visit the "Free resources" section of our web site linked in our
> trailer below.  The first section of the resources page is a link to
> the UBL and code list resources.  On that page under "Stylesheet
> resources" is the "Genericode and context/value association file
> stylesheets" section.  I'm not including the actual URL in this post
> in case the URL has to change which would make the archives out of date.
> 
> There is a "readme" file with (hopefully) complete instructions
> regarding using the stylesheets.
> 
> I welcome any feedback and suggestions to improve on the rendering of
> this information.
> 
> I hope these are considered helpful.
> 
> . . . . . . . . . Ken
> 
> cc:  UBL TC, UBL Dev, Code List TC
> 
> --
> World-wide corporate, govt. & user group XML, XSL and UBL training
> G. Ken Holman                 mailto:gkholman@CraneSoftwrights.com
> Crane Softwrights Ltd.          http://www.CraneSoftwrights.com/u/
> Box 266, Kars, Ontario CANADA K0A-2E0    +1(613)489-0999 (F:-0995)
> Male Cancer Awareness Aug'05  http://www.CraneSoftwrights.com/u/bc
> Legal business disclaimers:  http://www.CraneSoftwrights.com/legal
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ubl-dev-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: ubl-dev-help@lists.oasis-open.org



DISCLAIMER
This e-mail is intended for the addressee only and may contain information which is subject to legal privilege. The contents are not necessarily the official view or communication of the Ministry of Education. If you are not the intended recipient you must not use, disclose, copy or distribute this e-mail or any information in, or attached to it. If you have received this e-mail in error, please contact the sender immediately or return the original message to the Ministry by e-mail, and destroy any copies. The Ministry does not accept any liability for changes made to this e-mail or attachments after sending.
All e-mails have been scanned for viruses and content by security software. The Ministry reserves the right to monitor all e-mail communications through its network.