Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 14 additions & 6 deletions Makefile
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
## See RELEASE_PROCEDURE.md

# Where to copy from
DRAFT=1.2-DRAFT
DRAFT=1.3-DRAFT
# Official release
RELEASE=1.2
RELEASE=1.3
# Semantic versioning
TAG=1.2.0
NEXT=1.3-DRAFT
TAG=1.3.0
NEXT=1.4-DRAFT
# Prepare (but do not Publish!) the next version of https://zenodo.org/record/3541888
# then copy its DOI here so it can be included in generated HTML/PDF
DOI=10.5281/zenodo.13751027
DOI=10.5281/zenodo.20720080

all: dependencies release

Expand Down Expand Up @@ -81,10 +81,18 @@ docs/_specification/${RELEASE}/ro-crate-preview.html: dependencies docs/_specifi
docs/_specification/${RELEASE}/context.jsonld: dependencies docs/_specification/${RELEASE}/ scripts/schema-context.py
scripts/schema-context.py ${RELEASE} ${TAG} > docs/_specification/${RELEASE}/context.jsonld

docs/_specification/${RELEASE}/examples/rainfall-${TAG}/: dependencies docs/_specification/${RELEASE}/
mkdir -p docs/_specification/${RELEASE}/examples/
cp -r docs/_specification/${DRAFT}/examples/rainfall-${DRAFT}/ docs/_specification/${RELEASE}/examples/rainfall-${DRAFT}
mv docs/_specification/${RELEASE}/examples/rainfall-${DRAFT}/ docs/_specification/${RELEASE}/examples/rainfall-${TAG}
sed -i s/${DRAFT}/${RELEASE}/g docs/_specification/${RELEASE}/examples/rainfall-${TAG}/ro-crate-metadata.json
sed -i s/${DRAFT}/${RELEASE}/g docs/_specification/${RELEASE}/examples/rainfall-${TAG}/ro-crate-preview.html


release/:
mkdir -p release

release/ro-crate-${TAG}.md: dependencies release/ docs/_specification/${RELEASE}/_metadata.liquid docs/_specification/${RELEASE}/.references.md docs/_specification/${RELEASE}/*.md docs/_specification/${RELEASE}/appendix/*.md docs/_includes/references.liquid
release/ro-crate-${TAG}.md: dependencies release/ docs/_specification/${RELEASE}/_metadata.liquid docs/_specification/${RELEASE}/.references.md docs/_specification/${RELEASE}/*.md docs/_specification/${RELEASE}/appendix/*.md docs/_includes/references.liquid docs/_specification/${RELEASE}/examples/rainfall-${TAG}/
cp docs/_specification/${RELEASE}/_metadata.liquid docs/_specification/${RELEASE}/.metadata.md
pandoc --wrap=none --from=markdown+gfm_auto_identifiers --to=markdown+gfm_auto_identifiers \
docs/_specification/${RELEASE}/.metadata.md \
Expand Down
2 changes: 1 addition & 1 deletion docs/_config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@ defaults:

# include only the current spec in the search
- scope:
path: "_specification/1.2"
path: "_specification/1.3"
values:
search_exclude: false

Expand Down
38 changes: 37 additions & 1 deletion docs/_data/sidebars/spec.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,43 @@
title: Specification
title_url: specification
versions:
- title: RO-Crate 1.2 (newest release)
- title: RO-Crate 1.3 (newest release)
url: /specification/1.3/index.html
subitems:
- title: Introduction
url: /specification/1.3/introduction.html
- title: Terminology
url: /specification/1.3/terminology.html
- title: RO-Crate Structure
url: /specification/1.3/structure.html
- title: Metadata of the RO-Crate
url: /specification/1.3/metadata.html
- title: Root Data Entity
url: /specification/1.3/root-data-entity.html
- title: Data Entities
url: /specification/1.3/data-entities.html
- title: Contextual Entities
url: /specification/1.3/contextual-entities.html
- title: The focus of an RO-Crate
url: /specification/1.3/crate-focus.html
- title: Provenance of entities
url: /specification/1.3/provenance.html
- title: Profiles
url: /specification/1.3/profiles.html
- title: Workflows and scripts
url: /specification/1.3/workflows.html
- title: Appendix
url: /specification/1.3/appendix/index.html
subitems:
- title: Changelog
url: /specification/1.3/appendix/changelog.html
- title: Handling relative URI references
url: /specification/1.3/appendix/relative-uris.html
- title: Implementation notes
url: /specification/1.3/appendix/implementation-notes.html
- title: RO-Crate JSON-LD
url: /specification/1.3/appendix/jsonld.html
- title: RO-Crate 1.2
url: /specification/1.2/index.html
subitems:
- title: Introduction
Expand Down
2 changes: 1 addition & 1 deletion docs/_specification/1.3-DRAFT/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -207,7 +207,7 @@ You may notice the subtle difference between a _data entity_ that is conceptuall

An RO-Crate can be distributed on disk, in packaged format such as a zip file or disk image, or placed on a static website. In any of these cases, an RO-Crate should have an accompanying HTML version (`ro-crate-preview.html`) designed to be human-readable. The exact contents of the preview may vary but should correspond to the _RO-Crate Metadata Document_ content and link to the contained data entities. The preview may be generated automatically from the _RO-Crate Metadata Document_ (see [RO-Crate tools](../../tools)), or even by hand (equivalent to a README).

Below is a screenshot from the [preview of the running example](examples/rainfall-1.3.0/ro-crate-preview.html), which was generated using the [ro-crate-html](https://www.npmjs.com/package/ro-crate-html) package:
Below is a screenshot from the [preview of the running example](examples/rainfall-1.3-DRAFT/ro-crate-preview.html), which was generated using the [ro-crate-html](https://www.npmjs.com/package/ro-crate-html) package:

<figure>
<img src="../../assets/img/ro-crate-preview-example.png" alt="Screenshot of RO-Crate HTML preview. The metadata attributes are listed in a table with links to each connected entity, such as the Bureau of Meteorology." />
Expand Down
44 changes: 44 additions & 0 deletions docs/_specification/1.3/.metadata.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# RO-Crate Metadata Specification 1.3

* Permalink: <https://w3id.org/ro/crate/1.3>
* Published: 2026-06-22
* Publisher: [researchobject.org](https://www.researchobject.org/) community
* Status: Recommendation
* JSON-LD context: <https://w3id.org/ro/crate/1.3/context>
* This version: <https://w3id.org/ro/crate/1.3>
* Alternate formats: [Web pages](https://www.researchobject.org/ro-crate/specification/1.3/),
[single-page HTML](https://github.com/ResearchObject/ro-crate/releases/download/TAG/ro-crate-TAG.html),
[PDF](https://github.com/ResearchObject/ro-crate/releases/download/TAG/ro-crate-TAG.pdf),
[RO-Crate JSON-LD](ro-crate-metadata.json), [RO-Crate HTML](ro-crate-preview.html)
* Previous version: <https://w3id.org/ro/crate/1.2>
* Cite as: <!-- <https://doi.org/10.5281/zenodo.20720080> (this version) -->
<https://doi.org/10.5281/zenodo.3406497> (any version)
* Editors: [Peter Sefton](https://orcid.org/0000-0002-3545-944X), [Stian Soiland-Reyes](https://orcid.org/0000-0001-9842-9718), [Eli Chadwick](https://orcid.org/0000-0002-0035-6475)
* Authors: [Peter Sefton](https://orcid.org/0000-0002-3545-944X), [Eoghan Ó Carragáin](https://orcid.org/0000-0001-8131-2150), [Stian Soiland-Reyes](https://orcid.org/0000-0001-9842-9718), [Oscar Corcho](https://orcid.org/0000-0002-9260-0753), [Daniel Garijo](https://orcid.org/0000-0003-0454-7145), [Raul Palma](https://orcid.org/0000-0003-4289-4922), [Frederik Coppens](https://orcid.org/0000-0001-6565-5145), [Carole Goble](https://orcid.org/0000-0003-1219-2137), [José María Fernández](https://orcid.org/0000-0002-4806-5140), [Kyle Chard](https://orcid.org/0000-0002-7370-4805), [Jose Manuel Gomez-Perez](https://orcid.org/0000-0002-5491-6431), [Michael R Crusoe](https://orcid.org/0000-0002-2961-9670), [Ignacio Eguinoa](https://orcid.org/0000-0002-6190-122X), [Nick Juty](https://orcid.org/0000-0002-2036-8350), [Kristi Holmes](https://orcid.org/0000-0001-8420-5254), [Jason A. Clark](https://orcid.org/0000-0002-3588-6257), [Salvador Capella-Gutierrez](https://orcid.org/0000-0002-0309-604X), [Alasdair J. G. Gray](https://orcid.org/0000-0002-5711-4872), [Stuart Owen](https://orcid.org/0000-0003-2130-0865), [Alan R Williams](https://orcid.org/0000-0003-3156-2105), [Giacomo Tartari](https://orcid.org/0000-0003-1130-2154), [Finn Bacall](https://orcid.org/0000-0002-0048-3300), [Thomas Thelen](https://orcid.org/0000-0002-1756-2128), [Hervé Ménager](https://orcid.org/0000-0002-7552-1009), [Laura Rodríguez Navas](https://orcid.org/0000-0003-4929-1219), [Paul Walk](https://orcid.org/0000-0003-1541-5631), [brandon whitehead](https://orcid.org/0000-0002-0337-8610), [Mark Wilkinson](https://orcid.org/0000-0001-6960-357X), [Paul Groth](https://orcid.org/0000-0003-0183-6910), [Erich Bremer](https://orcid.org/0000-0003-0223-1059), [LJ Garcia Castro](https://orcid.org/0000-0003-3986-0510), [Karl Sebby](https://orcid.org/0000-0001-6022-9825), [Alexander Kanitz](https://orcid.org/0000-0002-3468-0652), [Ana Trisovic](https://orcid.org/0000-0003-1991-0533), [Gavin Kennedy](https://orcid.org/0000-0003-3910-0474), [Mark Graves](https://orcid.org/0000-0003-3486-8193), [Jasper Koehorst](https://orcid.org/0000-0001-8172-8981), [Simone Leo](https://orcid.org/0000-0001-8271-5429), [Marc Portier](https://orcid.org/0000-0002-9648-6484), [Paul Brack](https://orcid.org/0000-0002-5432-2748), [Milan Ojsteršek](https://orcid.org/0000-0003-1743-8300), [Bert Droesbeke](https://orcid.org/0000-0003-0522-5674), [Chenxu Niu](https://orcid.org/0000-0002-2142-1731), [Kosuke Tanabe](https://orcid.org/0000-0002-9986-7223), [Tomasz Miksa](https://orcid.org/0000-0002-4929-7875), [Marco La Rosa](https://orcid.org/0000-0001-5383-6993), [Cedric Decruw](https://orcid.org/0000-0001-6387-5988), [Andreas Czerniak](https://orcid.org/0000-0003-3883-4169), [Jeremy Jay](https://orcid.org/0000-0002-5761-7533), [Sergio Serra](https://orcid.org/0000-0002-0792-8157), [Ronald Siebes](https://orcid.org/0000-0001-8772-7904), [Shaun de Witt](https://orcid.org/0000-0003-4196-3658), [Shady El Damaty](https://orcid.org/0000-0002-2318-4477), [Douglas Lowe](https://orcid.org/0000-0002-1248-3594), [Xuanqi Li](https://orcid.org/0000-0003-1498-6205), [Sveinung Gundersen](https://orcid.org/0000-0001-9888-7954), [Muhammad Radifar](https://orcid.org/0000-0001-9156-9478>), [Rudolf Wittner](https://orcid.org/0000-0002-0003-2024), [Oliver Woolland](https://orcid.org/0000-0002-4565-9760), [Paul De Geest](https://orcid.org/0000-0002-8940-4946), [Douglas Fils](https://orcid.org/0000-0002-2257-9127), [Florian Wetzels](https://orcid.org/0000-0002-5526-7138), [Raül Sirvent](https://orcid.org/0000-0003-0606-2512), [Abigail Miller](https://orcid.org/0000-0001-9228-2882), [Jake Emerson](https://orcid.org/0000-0003-0617-9219), [Davide Fucci](https://orcid.org/0000-0002-0679-4361), [Bruno P. Kinoshita](https://orcid.org/0000-0001-8250-4074), [Maciek Bąk](https://orcid.org/0000-0003-1361-7301), [Jens Hollunder](https://orcid.org/0000-0003-3234-6762), [Martin Weise](https://orcid.org/0000-0003-4216-302X), [Vartika Bisht](https://orcid.org/0000-0002-1880-0597), [Toshiyuki Nishiyama Hiraki](https://orcid.org/0000-0001-6712-6335), [Bram Ulrichts](https://orcid.org/0000-0002-5934-8998), [Michael Falk](https://orcid.org/0000-0001-9261-8390), [Eli Chadwick](https://orcid.org/0000-0002-0035-6475), [Daniel Bauer](https://orcid.org/0000-0001-9447-460X), [James Love](https://orcid.org/0000-0001-7760-1240), [Eleni Adamidi](https://orcid.org/0000-0001-9925-1560), [Josh Moore](https://orcid.org/0000-0003-4028-811X), [Lars Schöbitz](https://orcid.org/0000-0003-2196-5015), [Andreas Meier](https://orcid.org/0009-0002-6541-4637), [Juan Fuentes](https://orcid.org/0009-0002-8209-1999), [Edan Bainglass](https://orcid.org/0000-0001-7218-0176), [Balazs E. Pataki](https://orcid.org/0000-0003-3482-0325), [Joe Heffer](https://orcid.org/0000-0001-8733-1117), [Pascal Su](https://orcid.org/0000-0001-5614-962X), [Andrea Davanzo](https://orcid.org/0009-0000-5170-1737), [Meznah Aloqalaa](https://orcid.org/0000-0002-1382-3896), [Pierre-Marie Allard](https://orcid.org/0000-0003-3389-2191), [Venkat S Malladi](https://orcid.org/0000-0002-0144-0564), [Esteban González](https://orcid.org/0000-0003-4112-6825), [Phil Reed](https://orcid.org/0000-0002-4479-715X), [Tilo Mathes](https://orcid.org/0000-0002-9694-748X), Saurabh Dome, [Niklas-Maximilian Epping](https://orcid.org/0000-0002-7348-4566), [Margareta Hellström](https://orcid.org/0000-0002-4154-2610), [Paul Slavin](https://orcid.org/0009-0009-5499-2096)


<!-- Add new RO-Crate team members at end -->


See <https://w3id.org/ro/crate> for further details about RO-Crate.

<small>
This specification is Copyright 2017-2025 University of Technology Sydney,
The University of Manchester UK and the RO-Crate contributors.
</small>

<small>
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
</small>

<small>
<http://www.apache.org/licenses/LICENSE-2.0>
</small>

<small>
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
</small>

**Note**: The RO-Crate [JSON-LD context](https://w3id.org/ro/crate/1.3/context) and JSON-LD examples within this specification are distributed under [CC0 1.0 Universal (CC0 1.0) Public Domain Dedication][CC0].

> The key words MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in [RFC 2119].
Loading
Loading