XML Schema "StandardsRegExt-1.0.xsd"
Target Namespace:
http://www.ivoa.net/xml/StandardsRegExt/v1.0
Version:
1.0pr3
Defined Components:
9 local elements, 6 complexTypes, 2 simpleTypes
Default Namespace-Qualified Form:
Local Elements: unqualified; Local Attributes: unqualified
Schema Location:
/home/msdemlei/gavo/trunk/gavo/resources/schemata/StandardsRegExt-1.0.xsd; see XML source
Imports Schema:
VOResource-v1.1.xsd [src]
Annotation
This is a core schema for describing IVOA Standards themselves. See complete specification at http://www.ivoa.net/Documents/latest/StandardsRegExt.html.
XML Source
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://www.ivoa.net/xml/StandardsRegExt/v1.0" version="1.0pr3" xmlns:vm="http://www.ivoa.net/xml/VOMetadata/v0.1" xmlns:vr="http://www.ivoa.net/xml/VOResource/v1.0" xmlns:vstd="http://www.ivoa.net/xml/StandardsRegExt/v1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:appinfo>
<vm:schemaName>StandardsRegExt</vm:schemaName>
<vm:schemaPrefix>xs</vm:schemaPrefix>
<vm:targetPrefix>vstd</vm:targetPrefix>
</xs:appinfo>
<xs:documentation>
This is a core schema for describing IVOA Standards themselves.
See complete specification at
http://www.ivoa.net/Documents/latest/StandardsRegExt.html.
</xs:documentation>
</xs:annotation>
<xs:complexType name="Standard">
<xs:annotation>
<xs:documentation>
a description of a standard specification.
</xs:documentation>
<xs:documentation>
This typically refers to an IVOA standard but is not
limited to such.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="vr:Resource">
<xs:sequence>
<xs:element maxOccurs="unbounded" name="endorsedVersion" type="vstd:EndorsedVersion">
<xs:annotation>
<xs:documentation>
the version of the standard that is recommended for use.
</xs:documentation>
<xs:documentation>
More than one version can be listed, indicating
that any of these versions are recognized as
acceptable for use.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" name="schema" type="vstd:Schema">
<xs:annotation>
<xs:documentation>
a description and pointer to a schema document
defined by this standard.
</xs:documentation>
<xs:documentation>
This is most typically an XML Schema, but it need
not be strictly.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="deprecated" type="xs:token">
<xs:annotation>
<xs:documentation>
when present, this element indicates that all
versions of the standard are considered
deprecated by the publisher. The value is a
human-readable explanation for the designation.
</xs:documentation>
<xs:documentation>
The explanation should indicate if another
standard should be preferred.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" name="key" type="vstd:StandardKey">
<xs:annotation>
<xs:documentation>
a defined key associated with this standard.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="EndorsedVersion">
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute default="n/a" name="status">
<xs:annotation>
<xs:documentation>
the IVOA status level of this version of the standard.
</xs:documentation>
<xs:documentation>
For values of "rec", "pr", "wd", and "note", the
record's referenceURL element should point to the
official specification document in the IVOA Document
Repository; if the document does not appear there,
these values should not be used.
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="rec">
<xs:annotation>
<xs:documentation>
an IVOA Recommendation
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="pr">
<xs:annotation>
<xs:documentation>
an IVOA Proposed Recommendation
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="wd">
<xs:annotation>
<xs:documentation>
an IVOA Working Draft
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="iwd">
<xs:annotation>
<xs:documentation>
an internal Working Draft of an IVOA Working Group
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="note">
<xs:annotation>
<xs:documentation>
a published IVOA Note
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="n/a">
<xs:annotation>
<xs:documentation>
not an IVOA standard or protostandard at
this time.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="use">
<xs:annotation>
<xs:documentation>
A designation of preference for the version compared
to other versions in use.
</xs:documentation>
</xs:annotation>
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="preferred">
<xs:annotation>
<xs:documentation>
the most preferred version.
</xs:documentation>
<xs:documentation>
Only one version should have this designation.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="deprecated">
<xs:annotation>
<xs:documentation>
a version whose use is now discouraged
because a newer version is preferred.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="Schema">
<xs:annotation>
<xs:documentation>
a description of a schema definition
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element maxOccurs="1" minOccurs="1" name="location" type="xs:anyURI">
<xs:annotation>
<xs:documentation>
A URL pointing to a document that formally defines
the schema.
</xs:documentation>
<xs:documentation>
The document should be in a machine-parsable format
when applicable. For example, when refering to an
XML schema, the document should be an XML Schema or
similar document that can be used to validate an
instance document.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="description" type="xs:token">
<xs:annotation>
<xs:documentation>
A human-readable description of what the schema
defines or is used for.
</xs:documentation>
<xs:documentation>
A brief description--e.g. one statement--is
recommended for display purposes.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" name="example" type="xs:anyURI">
<xs:annotation>
<xs:documentation>
A URL pointing to a sample document that illustrates
the use of the schema.
</xs:documentation>
<xs:documentation>
When applicable (e.g. XML), the document should be
in the format defined by the schema document.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="namespace" type="xs:token" use="required">
<xs:annotation>
<xs:documentation>
an identifier for the schema being described. Each instance
of this attribute must be unique within the resourse description.
</xs:documentation>
<xs:documentation>
For XML schemas, this should be the schema's namespace URI.
Otherwise, it should be a unique label to distinguish it from
other schemas described in the same resource description.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="ServiceStandard">
<xs:annotation>
<xs:documentation>
a description of a standard service protocol.
</xs:documentation>
<xs:documentation>
This typically refers to an IVOA standard but is not
limited to such.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="vstd:Standard">
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" name="interface" type="vr:Interface">
<xs:annotation>
<xs:documentation>
an abstract description of one of the interfaces defined
by this service standard.
</xs:documentation>
<xs:documentation>
This element can provide details about the interface
that apply to all implementations. Each interface
element should specify a role with a value starting
with "std:" or, if there is only one standard interface,
is equal to "std".
</xs:documentation>
<xs:documentation>
Applications that, for example, wish to build a GUI
to the service on-the-fly would first access this generic
description. Site-specific variations, such
as supported optional arguments or site specific
arguments, would be given in the actual implemented
service description and overrides any common information
found in this generic description. This generic interface
description can be matched with the site-specific one
using the role attribute.
</xs:documentation>
<xs:documentation>
Even though the Interface type requires an
accessURL child element, this element is
intended to describe a service in the
abstract--i.e. without reference to a particular
installation of the service. Consequently,
the accessURL may contain a bogus URL;
applications should not expect it to be resolvable.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="StandardKeyEnumeration">
<xs:annotation>
<xs:documentation>
A registered set of related keys. Each key can be
uniquely identified by combining the IVOA identifier of
this resource with the key name separated by the URI
fragment delimiter, #, as in: ivoa-identifier#key-name
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="vr:Resource">
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="1" name="key" type="vstd:StandardKey">
<xs:annotation>
<xs:documentation>
the name and definition of a key--a named concept,
feature, or property.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="StandardKey">
<xs:annotation>
<xs:documentation>
The name and definition of a key--a named concept,
feature, or property.
</xs:documentation>
<xs:documentation>
This key can be identified via an IVOA identifier
of the form ivo://authority/resource#name where name is
the value of the child name element.
</xs:documentation>
<xs:documentation>
This type can be extended if the key has
other metadata associated with it.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="name" type="vstd:fragment">
<xs:annotation>
<xs:documentation>
The property identifier which would appear as the
fragment (string after the pound sign, #) in an IVOA
identifier.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="description" type="xs:token">
<xs:annotation>
<xs:documentation>
A human-readable definition of this property.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="StandardKeyURI">
<xs:annotation>
<xs:documentation>
reference that forces an IVOA ID with a # fragment part
appended to match the standard pattern for registering
enumeration values with a vstd:StandardKeyList
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:anyURI">
<xs:pattern value="ivo://[\w\d][\w\d\-_\.!~\*'\(\)\+=]{2,}(/[\w\d\-_\.!~\*'\(\)\+=]+(/[\w\d\-_\.!~\*'\(\)\+=]+)*)?(#([A-Za-z0-9;/\?:@&amp;=\+$,\-_\.!~\*'\(\)]|%[A-Fa-f0-9]{2})+)?"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="fragment">
<xs:annotation>
<xs:documentation>
the allowed characters for a fragment identifier taken
from rfc2396
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:pattern value="([A-Za-z0-9;/\?:@&amp;=\+$,\-_\.!~\*'\(\)]|%[A-Fa-f0-9]{2})+"/>
</xs:restriction>
</xs:simpleType>
</xs:schema>

This XML schema documentation has been generated with DocFlex/XML RE 1.8.0 using DocFlex/XML XSDDoc 2.2.0 template set.
DocFlex/XML RE is a reduced edition of DocFlex/XML, which is a tool for programming and running highly sophisticated documentation and reports generators by the data obtained from any kind of XML files. The actual doc-generators are implemented in the form of special templates that are designed visually using a high quality Template Designer GUI basing on the XML schema (or DTD) files describing the data source XML.
DocFlex/XML XSDDoc is a commercial template application of DocFlex/XML that implements a high-end XML Schema documentation generator with simultaneous support of framed multi-file HTML, single-file HTML and RTF output formats. (More formats are planned in the future).
A commercial license for "DocFlex/XML XSDDoc" will allow you:
  • To configure the generated documentation so much as you want. Thanks to our template technology, it was possible to support more than 300 template parameters (working the same as "options" of an ordinary doc-gen), which will give you an unprecedented control over the generated content!
  • To use certain features disabled in the free mode (such as the full documenting of substitution groups).
  • To enable/disable documenting of the initial, imported, included and redefined XML schemas selectively.
  • To document local element components both globally and locally (similar to attributes).
  • To enable/disable reproducing of namespace prefixes.
  • To format your annotations with XHTML tags and reproduce that formatting both in HTML and RTF output.
  • To insert images in your annotations using XHTML <img> tags (supported both in HTML and RTF output).
  • To use PlainDoc.tpl main template to generate all the XML schema documentation in the form of a single HTML file.
  • To use the same template to generate the incredible quality RTF documentation.
  • To document only selected XML schema components specified by name.
  • To remove this very advertisement text
Once having only such a license, you will be able to run the fully-featured XML schema documentation generator both with DocFlex/XML SDK and with DocFlex/XML RE, which is a reduced free edition containing only the template interpretor / output generator. No other licenses will be required!
But this is not all. In addition to it, a commercial license for DocFlex/XML SDK will allow you to modify the XSDDoc templates themselves as much as you want. You will be able to achieve whatever was impossible to do with the template parameters only. And, of course, you could develop any template applications by your own!
Please note: By purchasing a license for this software, you not only acquire a useful tool, you will also make an important investment in its future development, the result of which you could enjoy later by yourself. Every single your purchase matters and makes a difference for us!
To buy a license, please follow this link: http://www.filigris.com/shop/