Skip to content

Commit 579def7

Browse files
committed
created detailed info file for absolute beginners, and distribution (bundled) profiles for rdf
1 parent 7949da8 commit 579def7

File tree

16 files changed

+9697
-20
lines changed

16 files changed

+9697
-20
lines changed

README.md

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@ This repository organizes DataCite metadata concepts into resolvable JSON-LD fil
1616
- `vocab/` defines controlled vocabularies (enumerated terms) used by DataCite fields (for example `resourceTypeGeneral`, `relationType`, `nameType`)
1717
- `context/` contains JSON-LD contexts used to map compact keys to IRIs
1818
- `manifest/` provides a versioned inventory of classes, properties, and vocabulary schemes/terms
19+
- `dist/` contains integrated distribution artifacts that bundle the schema as a single JSON-LD graph plus alternate RDF serializations
1920
- `Input files/` contains example XML, transformed JSON outputs, validation helpers, and notes used during transformation experiments
2021

2122
## Repository Layout (Plain-English Guide)
@@ -31,7 +32,7 @@ Example:
3132
Typical structure:
3233

3334
- `@id`: stable IRI of the class
34-
- `@type`: usually `rdf:Class`
35+
- `@type`: usually `rdfs:Class`
3536
- `rdfs:label`: human-readable name
3637
- `rdfs:comment`: short description
3738

@@ -76,6 +77,14 @@ Important files:
7677

7778
This is a useful entry point if you want to programmatically discover what is defined for a given schema version.
7879

80+
### `dist/`
81+
82+
- `dist/datacite-4.6.jsonld` is the integrated JSON-LD bundle for the current staged schema version
83+
- `dist/datacite-4.6.ttl` is the Turtle serialization of that bundle
84+
- `dist/datacite-4.6.rdf` is the RDF/XML serialization of that bundle
85+
86+
These files are generated from the manifest-backed source files by `node scripts/build-distribution.js`.
87+
7988
### `Input files/`
8089

8190
This folder contains working materials and examples used to test conversions and round-tripping:
@@ -102,6 +111,9 @@ This allows metadata fields like `identifier`, `creator`, or `resourceTypeGenera
102111
- `class/`: 21 JSON-LD files
103112
- `property/`: 78 JSON-LD files
104113
- `vocab/`: 170 JSON-LD files
114+
- `context/`: 2 JSON-LD files
115+
- `manifest/`: 1 JSON manifest file
116+
- `dist/`: 3 distribution files (`.jsonld`, `.ttl`, `.rdf`)
105117

106118
## Example: What a Vocabulary Term File Looks Like
107119

@@ -148,10 +160,11 @@ The key difference is whether you want semantic convenience or exact XML structu
148160

149161
If you are exploring this repo for the first time:
150162

151-
1. Read `manifest/datacite-4.6.json` to see the full inventory of defined resources.
152-
2. Open `context/fullcontext.jsonld` to understand how DataCite-like JSON keys are mapped.
153-
3. Compare one file each from `class/`, `property/`, and `vocab/` to see the modeling pattern.
154-
4. Review `Input files/codes&steps.md` and the example files if you are evaluating XML <-> JSON round-tripping.
163+
1. Open `dist/datacite-4.6.jsonld` if you need a single importable bundle of the staged linked-data set.
164+
2. Read `manifest/datacite-4.6.json` to see the full inventory of defined resources.
165+
3. Open `context/fullcontext.jsonld` to understand how DataCite-like JSON keys are mapped.
166+
4. Compare one file each from `class/`, `property/`, and `vocab/` to see the modeling pattern.
167+
5. Review `Input files/codes&steps.md` and the example files if you are evaluating XML <-> JSON round-tripping.
155168

156169
## Notes
157170
- Some files in `Input files/` are experimental outputs used for validation and comparison, not canonical schema definitions.

class/Resource.jsonld

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
"datacite": "https://schema.stage.datacite.org/linked-data/"
77
},
88
"@id": "https://schema.stage.datacite.org/linked-data/class/Resource",
9-
"@type": "rdf:Class",
9+
"@type": "rdfs:Class",
1010
"rdfs:label": "Resource",
1111
"rdfs:comment": "A resource that can be cited and identified..."
12-
}
12+
}

class/index.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@
153153
<header class="topbar">
154154
<div class="wrap">
155155
<a class="brand" href="/linked-data//">DataCite Linked Data</a>
156-
<nav class="nav" aria-label="Section navigation"><a href="/linked-data//">Home</a><a href="/linked-data/class/" aria-current="page">Classes</a><a href="/linked-data/property/">Properties</a><a href="/linked-data/vocab/">Controlled Terms</a><a href="/linked-data/context/">Contexts</a><a href="/linked-data/manifest/">Manifests</a></nav>
156+
<nav class="nav" aria-label="Section navigation"><a href="/linked-data//">Home</a><a href="/linked-data/class/" aria-current="page">Classes</a><a href="/linked-data/property/">Properties</a><a href="/linked-data/vocab/">Controlled Terms</a><a href="/linked-data/context/">Contexts</a><a href="/linked-data/dist/">Distributions</a><a href="/linked-data/manifest/">Manifests</a></nav>
157157
</div>
158158
</header>
159159
<div class="wrap">
@@ -296,13 +296,13 @@ <h1>Class Definitions</h1>
296296
<div class="meta-col">rdfs:Class<br>2026-02-18</div>
297297
</div>
298298
</li><li>
299-
<div class="row" data-search="Resource Resource A resource that can be cited and identified... rdf:Class">
299+
<div class="row" data-search="Resource Resource A resource that can be cited and identified... rdfs:Class">
300300
<div class="name">
301301
<a href="/linked-data/class/Resource.jsonld">Resource</a>
302302
<div class="small muted code">Resource.jsonld</div>
303303
</div>
304304
<div class="desc">A resource that can be cited and identified...</div>
305-
<div class="meta-col">rdf:Class<br>2026-02-20</div>
305+
<div class="meta-col">rdfs:Class<br>2026-03-02</div>
306306
</div>
307307
</li><li>
308308
<div class="row" data-search="ResourceType ResourceType A description of the resource. rdfs:Class">

context/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -153,7 +153,7 @@
153153
<header class="topbar">
154154
<div class="wrap">
155155
<a class="brand" href="/linked-data//">DataCite Linked Data</a>
156-
<nav class="nav" aria-label="Section navigation"><a href="/linked-data//">Home</a><a href="/linked-data/class/">Classes</a><a href="/linked-data/property/">Properties</a><a href="/linked-data/vocab/">Controlled Terms</a><a href="/linked-data/context/" aria-current="page">Contexts</a><a href="/linked-data/manifest/">Manifests</a></nav>
156+
<nav class="nav" aria-label="Section navigation"><a href="/linked-data//">Home</a><a href="/linked-data/class/">Classes</a><a href="/linked-data/property/">Properties</a><a href="/linked-data/vocab/">Controlled Terms</a><a href="/linked-data/context/" aria-current="page">Contexts</a><a href="/linked-data/dist/">Distributions</a><a href="/linked-data/manifest/">Manifests</a></nav>
157157
</div>
158158
</header>
159159
<div class="wrap">

0 commit comments

Comments
 (0)