/[volute]/trunk/projects/edu/edumatters/DocRegExt-1.xsd
ViewVC logotype

Contents of /trunk/projects/edu/edumatters/DocRegExt-1.xsd

Parent Directory Parent Directory | Revision Log Revision Log


Revision 4010 - (show annotations)
Thu May 4 09:44:07 2017 UTC (4 years ago) by msdemlei
File size: 4340 byte(s)
edumatters: removing in-document schema.

misc. editorial changes.


1 <?xml version="1.0" encoding="UTF-8"?>
2 <xs:schema
3 xmlns:xs="http://www.w3.org/2001/XMLSchema"
4 xmlns:vr="http://www.ivoa.net/xml/VOResource/v1.0"
5 xmlns:vs="http://www.ivoa.net/xml/VODataService/v1.1"
6 xmlns:vm="http://www.ivoa.net/xml/VOMetadata/v0.1"
7 xmlns:doc="http://www.ivoa.net/xml/DocRegExt/v1.0"
8 version="1.0note"
9 targetNamespace="http://www.ivoa.net/xml/DocRegExt/v1.0"
10 elementFormDefault="unqualified"
11 attributeFormDefault="unqualified"
12 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
13 <xs:annotation>
14 <xs:appinfo>
15 <vm:schemaName>DocRegExt</vm:schemaName>
16 <vm:schemaPrefix>xs</vm:schemaPrefix>
17 <vm:targetPrefix>doc</vm:targetPrefix>
18 </xs:appinfo>
19 <xs:documentation>
20 A description of a document/education-like resource.
21 </xs:documentation>
22 </xs:annotation>
23 <xs:import namespace="http://www.ivoa.net/xml/VOResource/v1.0"
24 schemaLocation="http://www.ivoa.net/xml/VOResource/VOResource-v1.0.xsd"/>
25 <xs:import namespace="http://www.ivoa.net/xml/VODataService/v1.1"
26 schemaLocation="http://www.ivoa.net/xml/VOResource/VODataService-v1.1.xsd"/>
27
28 <xs:complexType name="Document">
29 <xs:annotation>
30 <xs:documentation>
31 A natural-language document.
32 </xs:documentation>
33 <xs:documentation>
34 Natual-language documents suitable for registration include
35 worked-out use cases, tutorials, courses, or even material like
36 reference cards, provided they cover Virtual Observatory techniques.
37
38 We consider all translations of a document as one resource.
39 Individual translations are defined as doc:DocFile-typed
40 capabilities.
41 </xs:documentation>
42 </xs:annotation>
43
44 <xs:complexContent>
45 <xs:extension base="vs:Resource"/>
46 </xs:complexContent>
47 </xs:complexType>
48
49 <xs:complexType name="Edition">
50 <xs:annotation>
51 <xs:documentation>
52 An “edition” (typically: translation) of the document.
53 </xs:documentation>
54 <xs:documentation>
55 Although for a while, multiple editions of the document in one language
56 may be given (corresponding perhaps to two “major” versions), in
57 general, only the latest version of the document per language should be
58 given.
59
60 At least one vr:WebBrowser-typed interface with
61 role="rendered" must be present. The access URL of the interface
62 points to a rendered version of the edition (preferably in PDF,
63 but HTML is acceptable, too).
64
65 Editors are strongly encourated to also provide an
66 interface with role="source", the accessURL of which should point
67 to an editable version of the document, a version controlled
68 repository, or the like.
69 </xs:documentation>
70 </xs:annotation>
71 <xs:complexContent>
72 <xs:extension base="vr:Capability">
73 <xs:sequence>
74 <xs:element name="language" type="xs:token"
75 minOccurs="1" maxOccurs="1">
76 <xs:annotation>
77 <xs:documentation>
78 The language this document is (mainly) written in,
79 as an RFC 3066 language code.
80 </xs:documentation>
81 <xs:documentation>
82 The country codes must be given in all lowercase. This
83 results in strings like en-us, de-de, or es-mx.
84
85 This language is also the language for locTitle,
86 irrespective or that element's xml:lang setting.
87 </xs:documentation>
88 </xs:annotation>
89 </xs:element>
90 <xs:element name="locTitle" type="xs:token"
91 minOccurs="0" maxOccurs="1">
92 <xs:annotation>
93 The translated document's title in the language specified
94 by the language sibling.
95 </xs:annotation>
96 <xs:annotation>
97 It is recommended to set this element's xml:lang element
98 to the same value as the language sibling. The reason
99 xml:lang is not used in the first place is that with an
100 extra element, enforcing that the content language is
101 given is more straightforward.
102 </xs:annotation>
103 </xs:element>
104 </xs:sequence>
105 </xs:extension>
106 </xs:complexContent>
107 </xs:complexType>
108 </xs:schema>

msdemlei@ari.uni-heidelberg.de
ViewVC Help
Powered by ViewVC 1.1.26