XML Schema "DocRegExt.xsd"
Target Namespace:
http://www.ivoa.net/xml/DocRegExt/v1
Version:
1.0note
Defined Components:
2 local elements, 2 complexTypes
Default Namespace-Qualified Form:
Local Elements: unqualified; Local Attributes: unqualified
Schema Location:
/home/msdemlei/gavo/trunk/gavo/resources/schemata/DocRegExt.xsd; see XML source
Imports Schemas (2):
VODataService.xsd [src], VOResource.xsd [src]
Annotation
A description of a document/education-like resource.
XML Source
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://www.ivoa.net/xml/DocRegExt/v1" version="1.0note" xmlns:doc="http://www.ivoa.net/xml/DocRegExt/v1.0" xmlns:vm="http://www.ivoa.net/xml/VOMetadata/v0.1" xmlns:vr="http://www.ivoa.net/xml/VOResource/v1.0" xmlns:vs="http://www.ivoa.net/xml/VODataService/v1.1" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<xs:annotation>
<xs:appinfo>
<vm:schemaName>DocRegExt</vm:schemaName>
<vm:schemaPrefix>xs</vm:schemaPrefix>
<vm:targetPrefix>doc</vm:targetPrefix>
</xs:appinfo>
<xs:documentation>
A description of a document/education-like resource.
</xs:documentation>
</xs:annotation>
<xs:complexType name="Document">
<xs:annotation>
<xs:documentation>
A natural-language document.
</xs:documentation>
<xs:documentation>
Natual-language documents suitable for registration include
worked-out use cases, tutorials, courses, or even material like
reference cards, provided they cover Virtual Observatory techniques.

We consider all translations of a document as one resource.
Individual translations are defined as doc:DocFile-typed
capabilities.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="vs:CatalogService"/>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="Edition">
<xs:annotation>
<xs:documentation>
An &#8220;edition&#8221; (typically: translation) of the document.
</xs:documentation>
<xs:documentation>
Although for a while, multiple editions of the document in one language
may be given (corresponding perhaps to two &#8220;major&#8221; versions), in
general, only the latest version of the document per language should be
given.

At least one vr:WebBrowser-typed interface with
role="rendered" must be present. The access URL of the interface
points to a rendered version of the edition (preferably in PDF,
but HTML is acceptable, too).

Editors are strongly encourated to also provide an
interface with role="source", the accessURL of which should point
to an editable version of the document, a version controlled
repository, or the like.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="vr:Capability">
<xs:sequence>
<xs:element maxOccurs="1" minOccurs="1" name="languageCode" type="xs:token">
<xs:annotation>
<xs:documentation>
The language this document is (mainly) written in,
as an RFC 3066 language code.
</xs:documentation>
<xs:documentation>
The country codes must be given in all lowercase. This
results in strings like en-us, de-de, or es-mx.

This language is also the language for locTitle,
irrespective or that element's xml:lang setting.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="locTitle" type="xs:token">
<xs:annotation>
<xs:documentation>
The translated document's title in the language specified
by the language sibling.
</xs:documentation>
<xs:documentation>
It is recommended to set this element's xml:lang element
to the same value as the language sibling. The reason
xml:lang is not used in the first place is that with an
extra element, enforcing that the content language is
given is more straightforward.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</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/