Skip to content

Generate SHACL shapes and vocabularies from Mermaid class diagrams.

Notifications You must be signed in to change notification settings

KNowledgeOnWebScale/merweb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🕸 Merweb

Merweb (Mermaid meets Semantic Web) is library and command line interface to generate SHACL shapes and vocabularies from Mermaid class diagrams.

Usage

  • Install via npm i -g merweb.
  • Execute tool via merweb -f path/to/diagram -s path/to/jsonld. You can try
merweb -f examples/diagram.txt \
  -s shapes.jsonld \
  -b "sc=https://w3id.org/idlab/ns/supply-chain/#" \
  -v "sc=https://w3id.org/idlab/ns/supply-chain/#" \
  -p "swrl=http://www.w3.org/2003/11/swrl#;owl=http://www.w3.org/2002/07/owl#" \
  -c vocab.jsonld

or

merweb -f examples/diagram_with_supertypes.txt \
  -s shapes.jsonld \
  -b "ex=https://example.org/examples#" \
  -v "ex=https://example.org/examples#" \
  -p "swrl=http://www.w3.org/2003/11/swrl#;owl=http://www.w3.org/2002/07/owl#" \
  -c vocab.jsonld

Examples

You can find example diagrams in the folder examples.

Annotations

Memweb reuses one existing Mermaid annotation and uses five new annotations to generate the correct shapes and vocabularies from the class diagrams. Below you can find a table of these annotations.

Annotation Description Shape Vocabulary Existing or new annotation
@type The type of a class Object of sh:targetNode A rdfs:Class New
@superTypes The super-types of a class N/A Object(s) of rdfs:subClassOf New
@extraTypes The extra types of a class Object of sh:property with rdf:type as sh:path A rdfs:Class New
@label The label of a class or property N/A Object of rdfs:label New
@comment The comment of a class or property N/A Object of rdfs:comment New
Cardinality on a class attribute The cardinality of datatype property Objects of sh:minCount and sh:maxCount N/A New
Cardinality on a relationship between two classes The cardinality of object property Objects of sh:minCount and sh:maxCount N/A Existing

Please note that the annotations @type, @superTypes, and @extraTypes assume a strict ordering: @type should always be declared before @superTypes and @extraTypes are declared. The internal ordering of the latter two can be arbitrary.

Remove annotations from diagrams

You can remove the annotations starting with @ from diagrams via the -r, --remove-annotations option. The changed diagram is outputted to the terminal.

merweb -f examples/diagram.txt -r

License

This code is copyrighted by Ghent University – imec and released under the MIT license.

About

Generate SHACL shapes and vocabularies from Mermaid class diagrams.

Resources

Stars

Watchers

Forks

Packages

No packages published