nicholascar/vocpub-profile

Vocabularies Publication Profile

This is a profile of the Simple Knowledge Organization System (SKOS) intended to allow for easy to manage and publish vocabularies.

By profile, what is meant here is "A specification that constrains, extends, combines, or provides guidance or explanation about the usage of other specifications." (from PROF) and, here the other specification is SKOS.

This profile is formulated according to the Profiles Vocabulary and provides Shapes Constraint Language (SHACL) validator files that can be used to determine whether vocabularies conform to this profile.

This profile is hosted online in Linked Data form using a persistent web address:

• https://w3id.org/profile/vocpub

Profile Resources

Specification

This profile's specification - the resource that contains the normative rules - is within the file specification.html and it is able to be viewed online at:

• https://raw.githack.com/nicholascar/vocpub-profile/master/specification.html

Validator

This profile's rules, as defined in the specification are presented for machine validation of RDF vocabularies in the shape file validator.shacl.ttl which conforms to the SHACL standard.

Tools such as pySHACL and the online SHACL Playground or SHACL Play! can be used with this shape file to validate vocabulary files.

License

This code is licensed using the CC BY 4.0 licence. See the LICENSE file for the deed.

Note Citation below for attribution.

Citation

To cite this profile, please use the following (formulated in BibTex):

@software{vocpub-profile,
  author = {{SURROUND Australia Pty Ltd}},
  title = {{Vocabulary Publication Profile}},
  version = {1.0},
  date = {2021},
  publisher = {{SURROUND Australia Pty Ltd}},
  url = {https://w3id.org/profile/vocpub}
}

Contact

publisher:

Australian Government Linked Data Working Group
https://www.linked.data.gov.au

creator:
Dr Nicholas J. Car
Data Systems Architect
SURROUND Australia Pty. Ltd.
[email protected]
https://orcid.org/0000-0002-8742-7730

vocpub-profile's Issues

Errors in validator messages

Hi @nicholascar
I have been using the validator and have come across a few errors in the messages where the message doesn't relate to the requirement number.

The issues are in the Requirements outlined below

vocpub-profile/validator.shacl.ttl

Lines 274 to 276 in aed7747

	<Requirement-2.2.2>
	a sh:NodeShape ;
	sh:message "Requirement 2.1.7 Provenance for a Collection _SHOULD_ be indicated by at least one of the following properties: dcterms:provenance, dcterms:source or prov:wasDerivedFrom." ;

vocpub-profile/validator.shacl.ttl

Lines 359 to 361 in aed7747

	<Requirement-2.3.4>
	a sh:NodeShape ;
	sh:message "Requirement 2.1.7 Provenance for a Concept _SHOULD_ be indicated by at least one of the following properties: dcterms:provenance, dcterms:source or prov:wasDerivedFrom." ;

vocpub-profile/validator.shacl.ttl

Lines 401 to 409 in aed7747

	<Requirement-2.4.1>
	a sh:NodeShape ;
	sh:targetClass sdo:Organization , sdo:Person ;
	sh:property [
	sh:path sdo:name ;
	sh:minCount 1 ;
	sh:maxCount 1 ;
	sh:datatype xsd:string ;
	sh:message "Requirement 2.4.2 Each agent _MUST_ indicate at least one name property with the `sdo:name` property that must be a text literal value"