1 | {
|
2 | "title": "PropertyValue",
|
3 | "@id": "schema:PropertyValue",
|
4 | "extends": "Thing",
|
5 | "status": "stable",
|
6 | "role": "secondary",
|
7 | "category": "other",
|
8 | "description": "A property-value pair.",
|
9 | "$comment": "Always use specific properties when they exist and you can populate them.\nUsing `PropertyValue` as a substitute will typically not convey as much semantic\ninformation as using the specific property.\n\nMost of the time a `PropertyValue` node will need a `value` property\n(e.g. most of the examples on https://schema.org/PropertyValue have one)\nso this schema make that property required.\n\nThis type is mainly provided for use in `Thing.identifiers` (see the notes there).\n",
|
10 | "properties": {
|
11 | "type": {
|
12 | "@id": "schema:type",
|
13 | "description": "The name of the type.",
|
14 | "type": "string",
|
15 | "enum": [
|
16 | "PropertyValue"
|
17 | ],
|
18 | "default": "PropertyValue",
|
19 | "from": "Entity"
|
20 | },
|
21 | "id": {
|
22 | "@id": "schema:id",
|
23 | "description": "The identifier for this item.",
|
24 | "type": "string",
|
25 | "from": "Entity"
|
26 | },
|
27 | "meta": {
|
28 | "@id": "stencila:meta",
|
29 | "description": "Metadata associated with this item.",
|
30 | "type": "object",
|
31 | "from": "Entity"
|
32 | },
|
33 | "alternateNames": {
|
34 | "@id": "schema:alternateName",
|
35 | "description": "Alternate names (aliases) for the item.",
|
36 | "type": "array",
|
37 | "items": {
|
38 | "type": "string"
|
39 | },
|
40 | "from": "Thing",
|
41 | "isArray": true,
|
42 | "isPlural": true,
|
43 | "aliases": [
|
44 | "alternateName"
|
45 | ]
|
46 | },
|
47 | "description": {
|
48 | "@id": "schema:description",
|
49 | "description": "A description of the item.",
|
50 | "$comment": "Allows for the description to be an array of nodes (e.g. an array of inline content,\nor a couple of paragraphs), or a string. The `minItems` restriction avoids a string\nbeing coerced into an array with a single string item.\n",
|
51 | "anyOf": [
|
52 | {
|
53 | "type": "array",
|
54 | "items": {
|
55 | "$ref": "BlockContent.schema.json"
|
56 | }
|
57 | },
|
58 | {
|
59 | "type": "array",
|
60 | "items": {
|
61 | "$ref": "InlineContent.schema.json"
|
62 | },
|
63 | "minItems": 2
|
64 | },
|
65 | {
|
66 | "type": "string"
|
67 | }
|
68 | ],
|
69 | "from": "Thing"
|
70 | },
|
71 | "identifiers": {
|
72 | "@id": "schema:identifier",
|
73 | "description": "Any kind of identifier for any kind of Thing.",
|
74 | "$comment": "Some identifiers have specific properties e.g the `issn` property for\nthe `Periodical` type. These should be used in preference to this\nproperty which is intended for identifiers that do not yet have a\nspecific property. Identifiers can be represented as strings, but\nusing a `PropertyValue` will usually be better because it allows\nfor `propertyID` (i.e. the type of identifier).\n",
|
75 | "type": "array",
|
76 | "items": {
|
77 | "anyOf": [
|
78 | {
|
79 | "$ref": "PropertyValue.schema.json"
|
80 | },
|
81 | {
|
82 | "type": "string"
|
83 | }
|
84 | ]
|
85 | },
|
86 | "from": "Thing",
|
87 | "isArray": true,
|
88 | "isPlural": true,
|
89 | "aliases": [
|
90 | "identifier"
|
91 | ]
|
92 | },
|
93 | "images": {
|
94 | "@id": "schema:image",
|
95 | "description": "Images of the item.",
|
96 | "type": "array",
|
97 | "items": {
|
98 | "anyOf": [
|
99 | {
|
100 | "$ref": "ImageObject.schema.json"
|
101 | },
|
102 | {
|
103 | "type": "string",
|
104 | "format": "uri"
|
105 | }
|
106 | ]
|
107 | },
|
108 | "from": "Thing",
|
109 | "isArray": true,
|
110 | "isPlural": true,
|
111 | "aliases": [
|
112 | "image"
|
113 | ]
|
114 | },
|
115 | "name": {
|
116 | "@id": "schema:name",
|
117 | "description": "The name of the item.",
|
118 | "type": "string",
|
119 | "from": "Thing"
|
120 | },
|
121 | "url": {
|
122 | "@id": "schema:url",
|
123 | "description": "The URL of the item.",
|
124 | "type": "string",
|
125 | "format": "uri",
|
126 | "from": "Thing"
|
127 | },
|
128 | "propertyID": {
|
129 | "@id": "schema:propertyID",
|
130 | "description": "A commonly used identifier for the characteristic represented by the property.",
|
131 | "type": "string",
|
132 | "from": "PropertyValue"
|
133 | },
|
134 | "value": {
|
135 | "@id": "schema:value",
|
136 | "description": "The value of the property.",
|
137 | "anyOf": [
|
138 | {
|
139 | "type": "boolean"
|
140 | },
|
141 | {
|
142 | "type": "integer"
|
143 | },
|
144 | {
|
145 | "type": "number"
|
146 | },
|
147 | {
|
148 | "type": "string"
|
149 | }
|
150 | ],
|
151 | "$comment": "This follows the expected types of https://schema.org/value except for `StructuredValue`,\nwhich at the time of writing was not implemented in this schema.\n",
|
152 | "from": "PropertyValue"
|
153 | }
|
154 | },
|
155 | "required": [
|
156 | "type",
|
157 | "value"
|
158 | ],
|
159 | "file": "PropertyValue.schema.yaml",
|
160 | "children": [],
|
161 | "descendants": [],
|
162 | "$schema": "http://json-schema.org/draft-07/schema#",
|
163 | "$id": "https://schema.stenci.la/v1/PropertyValue.schema.json",
|
164 | "source": "https://github.com/stencila/schema/blob/master/schema/PropertyValue.schema.yaml",
|
165 | "type": "object",
|
166 | "additionalProperties": false,
|
167 | "propertyAliases": {
|
168 | "alternateName": "alternateNames",
|
169 | "identifier": "identifiers",
|
170 | "image": "images"
|
171 | }
|
172 | }
|