https://github.com/esipfed/science-on-schema.org

science-on-schema.org - providing guidance for publishing schema.org as JSON-LD for the sciences
https://github.com/esipfed/science-on-schema.org

Last synced: 10 months ago
JSON representation

science-on-schema.org - providing guidance for publishing schema.org as JSON-LD for the sciences

Host: GitHub
URL: https://github.com/esipfed/science-on-schema.org
Owner: ESIPFed
License: apache-2.0
Created: 2018-07-20T18:14:36.000Z (almost 8 years ago)
Default Branch: main
Last Pushed: 2024-12-10T19:43:16.000Z (over 1 year ago)
Last Synced: 2024-12-10T20:34:58.983Z (over 1 year ago)
Language: Python
Homepage:
Size: 9.89 MB
Stars: 115
Watchers: 35
Forks: 33
Open Issues: 89
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Governance: GOVERNANCE.md

Awesome Lists containing this project

README

          

[](https://doi.org/10.5281/zenodo.7884538) 

![GitHub release (latest by date)](https://img.shields.io/github/v/release/ESIPFed/science-on-schema.org)

[![Twitter Follow](https://img.shields.io/twitter/follow/ScienceOnSchema.svg?style=social&label=Follow)](https://twitter.com/ScienceOnSchema)

![GitHub last commit](https://img.shields.io/github/last-commit/ESIPFed/science-on-schema.org)



## Science On Schema.Org (SOSO) Guidance Documents ##

This repository provides guidance for repository operators and others to follow consistent conventions to provide schema.org markup in Dataset landing pages to improve data discovery through search engines. The main guides help describe Datasets and Data Repositories.

| Name | | Guideline | Examples | Issues |

| --:  | --- | :-: | :-: | :-: |

| __[Dataset](/guides/Dataset.md)__ | guidelines for schema.org for a scientific Dataset | [](/guides/Dataset.md) | [](/examples/dataset) | [](/issues?q=is%3Aissue+is%3Aopen+label%3ADataset) |

| __[Data Repository](/guides/DataRepository.md)__ | guidelines for schema.org for a research data repository | [](/guides/DataRepository.md) | [](/examples/data-repository) | [](/issues?q=is%3Aissue+is%3Aopen+label%3ADataRepository) |

* [Getting Started](/guides/GETTING-STARTED.md) - explains some useful techniques that will be common across all schema.org types

* [Experimental](/guides/Experimental.md) - some suggestions for more advanced dataset documentation, proposed for inclusion in future SOSO guidelines. 

## Citation

Science on Schema.org (SOSO) releases are archived on Zenodo, and the current release should be cited as:

>  Adam Shepherd, Matthew B. Jones, Stephen Richard,  Nicholas Jarboe, Dave Vieglais, Douglas Fils, Ruth Duerr, Chantelle Verhey, Melinda Minch, Bryce Mecum, Nokome Bentley. (2023). Science-on-Schema.org v1.3.2. Zenodo. https://doi.org/10.5281/zenodo.7884538

## Community 

This guidance has been created by members of the ESIP [science-on-schema.org cluster](http://wiki.esipfed.org/index.php/Schema.org_Cluster). The cluster will be seeking endorsement across all members of ESIP, and in the meantime is releasing a series of progressively more mature guidance documents for the community. Your feedback and contributions are welcome. The cluster meets twice monthly, and all are welcome:

- When: 

    - 4th Thursday, 2:30pm ET

- Where: Telecons via Zoom

    - Connection: https://us02web.zoom.us/j/84043422486?pwd=bGM4YkFyMkFGSW1FZG5yaFRNaGNvdz09

    - Phone Access: United States: +1 (786) 535-3211

    - Dial by your location (Find your local number: https://us02web.zoom.us/u/kcKljXMoF0)

- [Living Agenda](https://docs.google.com/document/d/1tIlDVnKeocO1E_SSbNaldv0avORfGFdmYDNk_3ub6ik/edit?ts=5d9ed12d)

## Version DOIs

| Version | DOI |

| ------------- | ------------- |

|[1.3.2](https://github.com/ESIPFed/science-on-schema.org/releases/tag/1.3.2)|[](https://doi.org/10.5281/zenodo.7884538)|

|[1.3.1](https://github.com/ESIPFed/science-on-schema.org/releases/tag/1.3.1)|[](https://doi.org/10.5281/zenodo.7872383)|

|[1.3.0](https://github.com/ESIPFed/science-on-schema.org/releases/tag/1.3.0)|[](https://doi.org/10.5281/zenodo.6502539)|

|[1.2.0](https://github.com/ESIPFed/science-on-schema.org/releases/tag/1.2.0)|[](https://doi.org/10.5281/zenodo.4477164)|

|[1.1.0](https://github.com/ESIPFed/science-on-schema.org/releases/tag/1.1.0)|[](https://doi.org/10.5281/zenodo.3736235)|

|[1.0.0](https://github.com/ESIPFed/science-on-schema.org/releases/tag/1.0.0)|[](https://doi.org/10.5281/zenodo.2628756)|

## Contributors

  

    
_{Adam Shepherd}
🎨 💻 🖋 📖 📋 🤔 🚧

    
_{Matt Jones}
🎨 💻 🖋 📖 📋 🤔 🚧

    
_{Stephen Richard}
🎨 💻 🖋 📖 📋 🤔 🚧

    
_njarboe
🎨 💻 🖋 📖 📋 🤔 🚧

  

  

    
_{Dave Vieglais}
🎨 💻 🖋 📖 📋 🤔 🚧

    
_{Douglas Fils}
🎨 💻 🖋 📖 📋 🤔 🚧

    
_rduerr
🎨 💻 🖋 📖 📋 🤔 🚧

    
_{Chantelle Verhey}
🖋 📖 🤔

  

  

    
_{Melinda Minch}
🖋 📖

    
_{Bryce Mecum}
💻 🖋 📖

    
_{Nokome Bentley}
🖋 📖

    
_{Lewis John McGibbney}
🖋 📖

  

  

    
_{Charles Vardeman}
🖋 📖

    
_{Simon Cox}
🖋 📖

    
_{Dan Brickley}
🖋 📖

    
_HPeat
🖋 📖

  

  

    
_{John Graybeal}
🖋 📖

    
_{ChantelRidsdale}
🖋 📖 🤔

    
_mcorlando
🖋 📋

    
_{Josef Hardi}
🤔

  

  

    
_{Øystein Godøy}
🤔

    
_{Richard Wallis}
🤔

    
_{Siri Jodha S Khalsa}
🤔

    
_{Mathias Bockwoldt}
🤔

  

## Resources

* ESIP and this group

  * [Learn about ESIP](https://www.esipfed.org/)

  * [Join ESIP Slack](https://esip-slack-invite.herokuapp.com/) for real time chat

  * Chat on the [`sci-schemaorg`](https://esip-all.slack.com/archives/sci-schemaorg) Slack channel

  * [`sci-schemaorg` mailing list](https://lists.esipfed.org/mailman/listinfo/esip-schema-dot-org)

  * [`sci-schemaorg` wiki](http://wiki.esipfed.org/index.php/Schema.org_Cluster)

* History

  * This guide is a continuation of the [P418 NSF EarthCube](https://github.com/earthcubearchitecture-project418/p418Vocabulary) vocabulary guidance which ended in April 2018.

* Broader Community

  * [Schema.org development](https://github.com/schemaorg/schemaorg)

  * [Schema.org archived history](https://www.w3.org/wiki/index.php?title=WebSchemas/SchemaDotOrgProposalsArchive#2011-2014_Proposals_for_Schema.org), can be helpful when determining intent

  * [Data Catalog Vocabulary](https://www.w3.org/TR/vocab-dcat/) (DCAT)

  * [Bioschemas](https://bioschemas.org/)

  * [Geoschemas](https://geoschemas.org/)

  * [Shape Constraint Language](https://www.w3.org/TR/shacl/) (SHACL)

  * [Comparison of SHACL tool implementations](https://w3c.github.io/data-shapes/data-shapes-test-suite/#validate-rdf-data-tests)

* Tools

  * [Gleaner](https://gleaner.io) EarthCube developed tools for working with structure data 

  * [`exstruct`](https://github.com/scrapinghub/extruct) python tool for extracting microdata

  * [Schema.org Validator](https://validator.schema.org/)

  * [Google Rich Results Tool](https://search.google.com/test/rich-results)

  * [Google dataset search](https://toolbox.google.com/datasetsearch)

  * TopQuadrant TopBraid [SHACL validator](https://github.com/TopQuadrant/shacl)

  * [pySHACL](https://github.com/RDFLib/pySHACL)

  * [SHACL playground](https://shacl.org/playground/)

## License

Copyright [2022] [Adam Shepherd, Matthew B. Jones, Stephen Richard,  Nicholas Jarboe, Dave Vieglais, Douglas Fils, Ruth Duerr, Chantelle Verhey, Melinda Minch, Bryce Mecum, Nokome Bentley]

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

    http://www.apache.org/licenses/LICENSE-2.0

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.

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/esipfed/science-on-schema.org

Awesome Lists containing this project

README