[{"data":1,"prerenderedAt":223},["ShallowReactive",2],{"kgmanifest-search":3,"/kgmanifest/ont":183,"kgmanifest-navigation":211},[4,10,15,21,25,30,34,40,45,51,56,61,66,71,76,80,85,90,95,100,105,110,115,120,124,129,134,138,143,148,153,158,163,168,173,178],{"id":5,"title":6,"titles":7,"content":8,"level":9},"/kgmanifest","KG Manifest",[],"Manifests for describing catalogues & resources for use in Prez What is KG Manifest",1,{"id":11,"title":12,"titles":13,"content":14,"level":9},"/kgmanifest/quickstart","Quickstart",[],"",{"id":16,"title":17,"titles":18,"content":19,"level":20},"/kgmanifest/quickstart#installing","Installing",[12],"How to install KG Manifest",2,{"id":22,"title":23,"titles":24,"content":14,"level":20},"/kgmanifest/quickstart#example-manifest-usage","Example manifest usage",[12],{"id":26,"title":27,"titles":28,"content":29,"level":9},"/kgmanifest/model","KG Manifest Model",[],"A KG Manifest is an RDF file that describes and links to a set of resources that can be loaded into an RDF database for Prez to provide access to. This page defines the KG Manifest specification and links to relevant tools. The modelManifest Resource Roles VocabularyExamplesTools",{"id":31,"title":32,"titles":33,"content":14,"level":20},"/kgmanifest/model#model","Model",[27],{"id":35,"title":36,"titles":37,"content":38,"level":39},"/kgmanifest/model#overview","Overview",[27,32],"graph LR\n  style Manifest fill:#FF90BB,stroke:#666,stroke-width:2px\n  Manifest --1:1-N--> ResourceDescriptor;\n  style ResourceDescriptor fill:#FFC1DA,stroke:#666,stroke-width:2px\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px \n  ResourceDescriptor --1:1-N--> artifact;\n  ResourceDescriptor --1:1--> hasRole;\n  ResourceDescriptor --1:0-N--> conformsTo;\n  ResourceDescriptor --1:0-1--> additionalType;\n  ResourceDescriptor --1:0-1--> sync;\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px  \n  artifact --1:0-N--> conformsTo;\n  artifact --1:0-1--> additionalType;\n  artifact --1:0-1--> sync;\n  artifact --1:0-1--> mainEntity;\n  artifact --1:0-1--> contentLocation;\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px  \n  artifact --1:0-1--> dateModified;\n  artifact --1:0-1--> versionIRI;\n  artifact --1:0-1--> version; See Annex A: Diagram Breakdown below for a part-by-part explanation of this diagram.",3,{"id":41,"title":42,"titles":43,"content":44,"level":20},"/kgmanifest/model#rules","Rules",[27],"An instance of the Manifest class, prez:Manifest, MUST have 1 or more Resource Descriptors, prof:ResourceDescriptor instances, indicated by the prof:hasResource predicate. The Manifest instance can be identified by an IRI or a Blank Node.Each Resource Descriptor MUST have at least one prof:hasArtifact predicate indicating either an RDF literal resource (a string) containing the location of the artifact or a Blank Node containing the location of the artifacts indicated by the schema:contentLocation predicate and the main artifact IRI within that content location indicated by schema:mainEntity.See the Main Entity details belowWhere content location is indicated, it MUST be a file path or path pattern relative to the manifest or a URL.Each Resource Descriptor MUST also have exactly one prof:hasRole predicate indicating a Concept from the Manifest Resource Roles Vocabulary.Each Resource Descriptor MAY have a schema:name and/or a schema:description predicate indicating literal resources naming and describing it.A Resource, or an Artifact, MAY indicate that it (if an Artifact) or the Artifacts within it (if a Resource) conform to any number of defined Standards or Profiles of Standards, using the predicate dcterms:conformsTo.Validators can be indicated either by using \"well known\" validator IRIs or by directly indicating the validator RDF file\ncurrent \"well known\" are listed below and can be indicated using an IRI like this:dcterms:conformsTo \u003CWELL-KNONW-VALIDATOR-IRI> ;other validators, such as my-local-validator.ttl or http://online-validator.com/val.ttl should be indicated using a literal, like this:dcterms:conformsTo \"path/from/manifest/root/to/my-local-validator.ttl\" ;See the Known Validators list belowA Resource, or an Artifact, MAY indicate that it (if an Artifact) or the Artifacts within it (if a Resource) is of a specific class, using the predicate schema:additionalTypeSee the Known Classes list belowA Resource, or an Artifact, MAY indicate that it should not be ignored by synchronisation tooling by setting a predicate prez:sync to falseSee the Indicating no action section belowAn Artifact may have \"versioning information\" about it indicated by use of a number of known versioning predicatessee the Artifact Versioning section below",{"id":46,"title":47,"titles":48,"content":49,"level":50},"/kgmanifest/model#known-validators","Known Validators",[27,42],"The following validators can be referred to by IRI, as described above: ValidatorIRIScopeGeoSPARQL\u003Chttp://www.opengis.net/def/geosparql/validator>Spatial ObjectsIDN Catalogue Profile\u003Chttps://data.idnau.org/pid/cp/validator>Catalogued resources containing Indigenous metadataVocPub\u003Chttps://linked.data.gov.au/def/vocpub>Vocabularies",4,{"id":52,"title":53,"titles":54,"content":55,"level":50},"/kgmanifest/model#known-classes","Known Classes",[27,42],"Some classes of resource are commonly catalogued and, when they are, their class does not need to be indicated within a Manifest. These classes are: dcat:Resourcedcat:Datasetdcat:Catalogowl:Ontologyschema:CreativeWorkschema:Datasetschema:DataCatalogskos:ConceptScheme If an Artifact, or all the Artifacts within a Resource, are not one of these types, then they can be indicated as being so by use of schema:additionalType like this: []\n    a prez:Manifest ;\n    prof:hasResource\n        # ...\n        [\n            prof:hasArtifact \"resources/*.ttl\" ;\n            prof:hasRole mrr:ResourceData ;\n            schema:additionalType \u003C{A-CLASS-IRI}> ;\n        ] ,\n        # ...\n. This will allow the Manifest to communicate the class of the object software should be looking for within the resource.",{"id":57,"title":58,"titles":59,"content":60,"level":50},"/kgmanifest/model#main-entity","Main Entity",[27,42],"If, for some reason, a resource is neither of one of the Known Classes nore it its class able to be indicated with schema:additionalType, the specific IRI of the resource can be indicated using schema:mainEntity. This may be needed in situations where an RDF file containing a resource also contains multiple other instance of the same class. []\n    a prez:Manifest ;\n    prof:hasResource\n        # ...\n        [\n            prof:hasArtifact \"resources/file1.ttl\" ;\n            prof:hasRole mrr:ResourceData ;\n            schema:mainEntity \u003C{RESOURCE-IRI}> ;\n        ] ,\n        # ...\n.",{"id":62,"title":63,"titles":64,"content":65,"level":50},"/kgmanifest/model#indicating-no-action","Indicating no action",[27,42],"If a Manifest wishes to list a resource but indicate it not for automatic handling by manifest tooling - perhaps it's too large to synchronise with an RDF DB - then the predicate prez:sync with the value false should be set. Here is an example of a Manifest indicating 4 spatial datasets, one of which is too large to sync: []\n    a prez:Manifest ;\n    prof:hasResource\n        [\n            prof:hasArtifact \"resources/*.ttl\" ;  # datset1.ttl, dataset2.ttl & dataset3.ttl\n            prof:hasRole mrr:ResourceData ;\n        ] ,\n        [\n            prof:hasArtifact \"resources/large/dataset4.ttl\" ;\n            prof:hasRole mrr:ResourceData ;\n            prez:sync false ;\n        ] ;\n.",{"id":67,"title":68,"titles":69,"content":70,"level":39},"/kgmanifest/model#artifact-versioning","Artifact versioning",[27,42],"An Artifact's version may be indicated by use of any or all of the following predicates: owl:versionIRIschema:version or owl:versionInfoschema:dateModified or dcterms:modified If this is done, then tools, such as kgmanifest that load and sync Manifest-described data, can obtain versioning information from a Manifest file, rather than by inspecting Artifacts' contents.",{"id":72,"title":73,"titles":74,"content":75,"level":20},"/kgmanifest/model#validation","Validation",[27],"The validator - a file containing rules - for Manifests is given in Annex B: Manifest Validator below. A manifest and all its content can also be validated using the kgmanifest tool's validate function which both validates a Manifest file using the validator below and also any content for which a conformance claim is given. See the Tools section below for info on the kgmanifest tool. Additionally, any stand-alon SHACL validator can also be used to validate a Manifest. Again, see the tools section below.",{"id":77,"title":78,"titles":79,"content":14,"level":20},"/kgmanifest/model#examples","Examples",[27],{"id":81,"title":82,"titles":83,"content":84,"level":39},"/kgmanifest/model#valid","Valid",[27,78],"A simple, valid, Manifest. --8\u003C-- \"docs/assets/manifest.ttl\"",{"id":86,"title":87,"titles":88,"content":89,"level":39},"/kgmanifest/model#invalid-no-role","Invalid - no role",[27,78],"The second Resource Descriptor does not indicate a role as it is commented out. --8\u003C-- \"docs/assets/manifest-invalid-01.ttl\"",{"id":91,"title":92,"titles":93,"content":94,"level":39},"/kgmanifest/model#invalid-bad-location","Invalid - bad location",[27,78],"The third resource specifies an invalid location, the non-existent web address of https://github.com/RDFLib/prez/blob/main/prez/reference_data/profiles/ogc_records_profile.ttlx which has had an extra 'x' added at the end. --8\u003C-- \"docs/assets/manifest-invalid-03.ttl\"",{"id":96,"title":97,"titles":98,"content":99,"level":39},"/kgmanifest/model#mainentity-use","mainEntity use",[27,78],"A snippet of a Manifest - just one value for hasResource - showing use of mainEntity and contentLocation instead of just a literal file path. [\n        prof:hasArtifact\n            [\n                schema:contentLocation \"vocabs/image-test.ttl\" ;\n                schema:mainEntity \u003Chttps://example.com/demo-vocabs/image-test> ;\n            ] ,\n            \"vocabs/language-test.ttl\" ;\n        prof:hasRole mrr:ResourceData ;\n        schema:description \"skos:ConceptScheme objects in RDF (Turtle) files in the vocabs/ folder\" ;\n        schema:name \"Resource Data\"\n    ] ,",{"id":101,"title":102,"titles":103,"content":104,"level":39},"/kgmanifest/model#conformance-claim-single","conformance claim - single",[27,78],"A single artifact claiming conformance to the VocPub Profile of SKOS. prof:hasArtifact\n        [\n            schema:contentLocation \"vocabs/image-test.ttl\" ;\n            schema:mainEntity \u003Chttps://example.com/demo-vocabs/image-test> ;\n            dcterms:conformsTo \u003Chttps://linked.data.gov.au/def/vocpub> ;\n        ] ,",{"id":106,"title":107,"titles":108,"content":109,"level":39},"/kgmanifest/model#conformance-claim-all","conformance claim - all",[27,78],"A single Resource in a Manifest claiming conformance to the VocPub Profile of SKOS for all artifacts (there are 3 given). [\n        prof:hasArtifact\n            [\n                schema:contentLocation \"vocabs/image-test.ttl\" ;\n                schema:mainEntity \u003Chttps://example.com/demo-vocabs/image-test> ;\n            ] ,\n            \"vocabs/language-test.ttl\" ;\n            \"vocabs/other-vocab.ttl\" ;\n        prof:hasRole mrr:ResourceData ;\n        # ...\n        dcterms:conformsTo \u003Chttps://linked.data.gov.au/def/vocpub> ;\n    ] ,",{"id":111,"title":112,"titles":113,"content":114,"level":39},"/kgmanifest/model#conformance-claim-supplied-validator","conformance claim - supplied validator",[27,78],"To indicate a validator stored in a local file, my-local-validator.ttl: [\n        prof:hasArtifact\n            [\n                schema:contentLocation \"vocabs/image-test.ttl\" ;\n                schema:mainEntity \u003Chttps://example.com/demo-vocabs/image-test> ;\n            ] ,\n            \"vocabs/language-test.ttl\" ;\n            \"vocabs/other-vocab.ttl\" ;\n        prof:hasRole mrr:ResourceData ;\n        # ...\n        dcterms:conformsTo \"path/to/my-local-validator.ttl\" ;\n    ] ,",{"id":116,"title":117,"titles":118,"content":119,"level":39},"/kgmanifest/model#additionaltype","additionalType",[27,78],"Where a",{"id":121,"title":122,"titles":123,"content":14,"level":20},"/kgmanifest/model#tools","Tools",[27],{"id":125,"title":126,"titles":127,"content":128,"level":39},"/kgmanifest/model#kgmanifest-github-pypi","kgmanifest - GitHub, PyPI",[27,122],"The kgmanifest command line tool and Python package, available on GitHub and on PyPI, provides a number of functions to work with KG Manifests. The functions provided are: validate - validate a Manifest file and contentslabel - check Manifest contents for unlabelled elementsdocument - create certain forms of documentationload - load a Manifest's content into a file or DBsync - synchronise a Manifest's contents with a DB See the package's repository for installation and use details.",{"id":130,"title":131,"titles":132,"content":133,"level":39},"/kgmanifest/model#shacl-validation","SHACL validation",[27,122],"The preferred way to perform validation of a KG Manifest file is to use the kgmanifest tool's validate function, as listed above. Hoever, you can also perform validation of a manifest - the manifest file only, not the content it refers to, using any one of a number of SHACL validators. See these notes for a listing of general-purpose SHACL validation tools: ABIS standard's notes on SHACL tooling & validation",{"id":135,"title":136,"titles":137,"content":14,"level":20},"/kgmanifest/model#annex-a-diagram-breakdown","Annex A: Diagram Breakdown",[27],{"id":139,"title":140,"titles":141,"content":142,"level":39},"/kgmanifest/model#manifest-resourcedescriptor","Manifest & ResourceDescriptor",[27,136],"graph LR\n  style Manifest fill:#FF90BB,stroke:#666,stroke-width:2px\n  Manifest --1:1-N--> ResourceDescriptor;\n  style ResourceDescriptor fill:#FFC1DA,stroke:#666,stroke-width:2px\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px \n  ResourceDescriptor --1:1-N--> artifact;\n  subgraph main\n  ResourceDescriptor --1:1--> hasRole;\n  ResourceDescriptor --1:0-N--> conformsTo;\n  ResourceDescriptor --1:0-1--> additionalType;\n  ResourceDescriptor --1:0-1--> sync;\n  end A Manifest must indicate at least one ResourceDescriptor. ResourceDescriptor instances MUST have the predicates of: hasRole - exactly 1hasArtifact- at least 1 ResourceDescriptor instances MAY have the predicates of: conformsTo - at most 1additionalType - at most 1sync - at most 1. If present, value must be false, e.g. true is default",{"id":144,"title":145,"titles":146,"content":147,"level":39},"/kgmanifest/model#artifact-description","Artifact: description",[27,136],"graph LR\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px graph LR\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px  \n  subgraph main\n  artifact --1:0-N--> conformsTo;\n  artifact --1:0-1--> additionalType;\n  artifact --1:0-1--> sync;\n  end\n  subgraph artifact-only\n  artifact --1:0-1--> mainEntity;\n  artifact --1:0-1--> contentLocation;\n  end The value for the hasArtifact predicate can be either: a literal, with no further predicates of its owna node (likely a Blank Node) If a node, it MUST have: contentLocation - exactly 1mainEntity - exactly 1 If a node, it MAY have: conformsTo - at most 1additionalType - at most 1sync - at most 1. If present, value must be false, e.g. true is default",{"id":149,"title":150,"titles":151,"content":152,"level":39},"/kgmanifest/model#artifact-versioning-1","Artifact: versioning",[27,136],"If a node, an Artifact MAY have: dateModified - at most 1versionIRI - at most 1version - at most 1 graph LR\n  style artifact fill:#F8F8E1,stroke:#666,stroke-width:2px  \n  subgraph versioning\n  artifact --1:0-1--> dateModified;\n  artifact --1:0-1--> versionIRI;\n  artifact --1:0-1--> version;\n  end",{"id":154,"title":155,"titles":156,"content":157,"level":20},"/kgmanifest/model#annex-b-manifest-validator","Annex B: Manifest Validator",[27],"--8\u003C-- \"docs/assets/validator.ttl\" html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"id":159,"title":160,"titles":161,"content":162,"level":9},"/kgmanifest/mrr","Manifest Resource Roles Vocabulary",[],"This roles vocabulary contains the allowed Roles that a resource, described within a ResourceDescriptor, can play with respect to a Manifest.",{"id":164,"title":165,"titles":166,"content":167,"level":20},"/kgmanifest/mrr#identifier","Identifier",[160],"The IRI of this vocabulary is: https://prez.dev/ManifestResourceRoles The vocab namespace is https://prez.dev/ManifestResourceRoles/. The recommended namespace prefix is mrr.",{"id":169,"title":170,"titles":171,"content":172,"level":20},"/kgmanifest/mrr#human-readable","Human-readable",[160],"The human-readable form of this vocabulary is as follows: Concept IRILabelDefinitionParentmrr:CatalogueDataCatalogue DataData for the catalogue, usually a Catalogue, including the identity of it and each item fo resource-mrr:ResourceDataResource DataData for the resource of the catalogue-mrr:CatalogueAndResourceModelCatalogue & Resource ModelThe default model for the catalogue and the resource. Must be a set of SHACL Shapes-mrr:CatalogueModelCatalogue ModelThe default model for the catalogue. Must be a set of SHACL Shapesmrr:CatalogueAndResourceModelmrr:ResourceModelResource ModelThe default model for the resource. Must be a set of SHACL Shapesmrr:CatalogueAndResourceModelmrr:CompleteCatalogueAndResourceLabelsComplete Resource & Catalogue LabelsAll the labels - possibly including names, descriptions & seeAlso links - for the Catalogue and Resource objects-mrr:IncompleteCatalogueAndResourceLabelsIncomplete Resource & Catalogue LabelsSome of the labels - possibly including names, descriptions & seeAlso links - for the Catalogue and Resource objects-",{"id":174,"title":175,"titles":176,"content":177,"level":20},"/kgmanifest/mrr#machine-readable","Machine-readable",[160],"The machine-readable form of this vocabulary, in RDF's Turtle syntax, is: --8\u003C-- \"docs/assets/mrr.ttl\"",{"id":179,"title":180,"titles":181,"content":182,"level":9},"/kgmanifest/ont","Prez Ontology",[],"==Here will soon be the ontology!== You should probably look at the KG Manifest Model for now...",{"id":184,"title":180,"body":185,"code":204,"date":204,"description":204,"editorContent":204,"extension":205,"icon":204,"meta":206,"navigation":207,"path":179,"seo":208,"source":204,"stem":209,"tags":204,"__hash__":210},"kgmanifest/kgmanifest/ont.md",{"type":186,"value":187,"toc":202},"minimark",[188,192],[189,190,191],"p",{},"==Here will soon be the ontology!==",[189,193,194],{},[195,196,197,198,201],"em",{},"You should probably look at the ",[199,200,27],"a",{"href":26}," for now...",{"title":14,"searchDepth":20,"depth":20,"links":203},[],null,"md",{},true,{"title":180,"description":204},"kgmanifest/ont","DeEjxtvKE-ha3ibNmkcBCJjuTLoEAn8fIUox3EW0sWo",[212],{"title":6,"path":5,"stem":213,"children":214,"tags":204},"kgmanifest/1.index",[215,216,218,220,222],{"title":6,"path":5,"stem":213,"tags":204},{"title":12,"path":11,"stem":217,"tags":204},"kgmanifest/2.quickstart",{"title":27,"path":26,"stem":219,"tags":204},"kgmanifest/model",{"title":160,"path":159,"stem":221,"tags":204},"kgmanifest/mrr",{"title":180,"path":179,"stem":209,"tags":204},1774621042751]