Artifact Publication Ontology
EKGF Editor's Draft
1. Artifact Publication Ontology§
1.1 Overview§
Artifact Publication Ontology
| Identifier | Value |
|---|---|
| Ontology IRI / Namespace | https://ekgf.org/ontology/artifact-publication# |
| Prefix | ekg-artpub |
How semantic artifacts are published, either as a family or as explicitly selected artifact references: profiles configure generation, targets identify destinations, runs generate outputs, releases identify versions and approvals record authority decisions about exact releases. Family grouping is optional. The state of a run and of a release is described with the Lifecycle Ontology. SHACL shapes validate the scope and approval records.
1.2 Classes§
1.2.1 Publication artifact§
A generated output of a publication run, such as a website bundle, PDF, RDF export, changelog, diff report or archive.
ekg-artpub:PublicationArtifact | |
https://ekgf.org/ontology/artifact-publication#PublicationArtifact | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:Class |
rdfs:label | Publication artifact |
1.2.2 Publication profile§
Branch-scoped generator configuration for publishing either one family or one or more explicit artifact references, including section ordering, render policy, validation gates and output targets. Retain the configuration referenced by a release; changed configuration requires a new profile identity.
ekg-artpub:PublicationProfile | |
https://ekgf.org/ontology/artifact-publication#PublicationProfile | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:Class |
rdfs:label | Publication profile |
1.2.3 Publication run§
An execution that generates publication artifacts for the scope selected by a profile, branch and input commit. The scope may be a family or explicit artifact references. How far it has come is its lifecycle state; by default a run follows the execution lifecycle.
ekg-artpub:PublicationRun | |
https://ekgf.org/ontology/artifact-publication#PublicationRun | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:Class |
rdfs:label | Publication run |
1.2.4 Publication target§
A configured destination for a generated publication output, such as a website, PDF, RDF download, archive or package.
ekg-artpub:PublicationTarget | |
https://ekgf.org/ontology/artifact-publication#PublicationTarget | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:Class |
rdfs:label | Publication target |
1.2.5 Release approval§
An affirmative approval decision by one authority about one exact standards release at a recorded time. Several authorities can approve the same release through separate records. An approval does not extend to other releases or future family members, and does not itself publish the release. Supporting evidence can be linked with rdfs:seeAlso. Required approvers and any withdrawal of approval are matters for the applicable governance policy; a governing or publishing role alone does not establish that approval occurred.
ekg-artpub:ReleaseApproval | |
https://ekgf.org/ontology/artifact-publication#ReleaseApproval | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:Class |
rdfs:label | Release approval |
owl:disjointWith | ekg-artgov:Family |
owl:disjointWith | ekg-artgov:Reference |
owl:disjointWith | ekg-artpub:PublicationProfile |
owl:disjointWith | ekg-artpub:PublicationRun |
owl:disjointWith | ekg-artpub:StandardsRelease |
1.2.6 Standards release§
A versioned snapshot of either one family or one or more explicit artifact references. Its identity, scope, version and content provenance are immutable; changed content requires a new release identity and new approvals. A release may record a branch, input commit, publication run and generated artifacts where available, but externally produced releases do not require a local generator run. Its lifecycle state may change from candidate to published, superseded or withdrawn. A version label is scoped to the release's publication context, not a global identifier. Family membership is optional and is not inferred from the references in a release.
ekg-artpub:StandardsRelease | |
https://ekgf.org/ontology/artifact-publication#StandardsRelease | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:Class |
rdfs:label | Standards release |
owl:disjointWith | ekg-artgov:Family |
owl:disjointWith | ekg-artgov:Reference |
owl:disjointWith | ekg-artpub:PublicationArtifact |
owl:disjointWith | ekg-artpub:PublicationProfile |
owl:disjointWith | ekg-artpub:PublicationRun |
1.3 Properties§
1.3.1 Approved at§
Timestamp at which the authority approved the identified release. This is distinct from when it was generated or published.
ekg-artpub:approvedAt | |
https://ekgf.org/ontology/artifact-publication#approvedAt | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:ReleaseApproval |
rdfs:label | Approved at |
rdfs:range | xsd:dateTime |
1.3.2 Approved by§
Identifies the authority role that issued this approval. The organization playing the role has its own identity. A separate decision record is used for each approving authority.
ekg-artpub:approvedBy | |
https://ekgf.org/ontology/artifact-publication#approvedBy | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:domain | ekg-artpub:ReleaseApproval |
rdfs:label | Approved by |
rdfs:range | ekg-artgov:Authority |
1.3.3 Approves release§
Identifies the exact release approved by this decision. Approval is never attached to the enduring family or artifact reference.
ekg-artpub:approvesRelease | |
https://ekgf.org/ontology/artifact-publication#approvesRelease | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:domain | ekg-artpub:ReleaseApproval |
rdfs:label | Approves release |
rdfs:range | ekg-artpub:StandardsRelease |
1.3.4 Artifact checksum§
Checksum or digest of a generated publication artifact.
ekg-artpub:artifactChecksum | |
https://ekgf.org/ontology/artifact-publication#artifactChecksum | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationArtifact |
rdfs:label | Artifact checksum |
rdfs:range | xsd:string |
1.3.5 Artifact media type§
Media type of a generated publication artifact, such as text/html, application/pdf or text/turtle.
ekg-artpub:artifactMediaType | |
https://ekgf.org/ontology/artifact-publication#artifactMediaType | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationArtifact |
rdfs:label | Artifact media type |
rdfs:range | xsd:string |
1.3.6 Artifact URL§
Stable URL where a generated publication artifact can be read.
ekg-artpub:artifactUrl | |
https://ekgf.org/ontology/artifact-publication#artifactUrl | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationArtifact |
rdfs:label | Artifact URL |
rdfs:range | xsd:anyURI |
1.3.7 Generator version§
Version of the publication generator used by a publication profile, run, artifact or release.
ekg-artpub:generatorVersion | |
https://ekgf.org/ontology/artifact-publication#generatorVersion | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:label | Generator version |
rdfs:range | xsd:string |
1.3.8 Input commit CID§
Content identifier of the branch commit used as input for a publication run or release.
ekg-artpub:inputCommitCid | |
https://ekgf.org/ontology/artifact-publication#inputCommitCid | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:label | Input commit CID |
rdfs:range | xsd:string |
1.3.9 Publication artifact§
Links a publication run or a standards release to a generated publication artifact.
ekg-artpub:publicationArtifact | |
https://ekgf.org/ontology/artifact-publication#publicationArtifact | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:label | Publication artifact |
rdfs:range | ekg-artpub:PublicationArtifact |
1.3.10 Publication branch§
Links a publication run or a standards release to the branch whose commit was published.
ekg-artpub:publicationBranch | |
https://ekgf.org/ontology/artifact-publication#publicationBranch | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:label | Publication branch |
rdfs:range | rdfs:Resource |
1.3.11 Publication completed at§
Timestamp at which a publication run completed.
ekg-artpub:publicationCompletedAt | |
https://ekgf.org/ontology/artifact-publication#publicationCompletedAt | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationRun |
rdfs:label | Publication completed at |
rdfs:range | xsd:dateTime |
1.3.12 Publication profile§
Links a publication run, target, artifact or release to the profile that governed generation.
ekg-artpub:publicationProfile | |
https://ekgf.org/ontology/artifact-publication#publicationProfile | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:label | Publication profile |
rdfs:range | ekg-artpub:PublicationProfile |
1.3.13 Publication release§
Links a publication run or a generated artifact to the standards release that incorporated it.
ekg-artpub:publicationRelease | |
https://ekgf.org/ontology/artifact-publication#publicationRelease | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:label | Publication release |
rdfs:range | ekg-artpub:StandardsRelease |
1.3.14 Publication run§
Links a standards release or a generated artifact to the publication run that produced it.
ekg-artpub:publicationRun | |
https://ekgf.org/ontology/artifact-publication#publicationRun | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:label | Publication run |
rdfs:range | ekg-artpub:PublicationRun |
1.3.15 Publication started at§
Timestamp at which a publication run started.
ekg-artpub:publicationStartedAt | |
https://ekgf.org/ontology/artifact-publication#publicationStartedAt | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationRun |
rdfs:label | Publication started at |
rdfs:range | xsd:dateTime |
1.3.16 Publication target§
Links a publication profile, run or artifact to a configured output target.
ekg-artpub:publicationTarget | |
https://ekgf.org/ontology/artifact-publication#publicationTarget | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:label | Publication target |
rdfs:range | ekg-artpub:PublicationTarget |
1.3.17 Publishes family§
Links a publication profile to the one family that it publishes. Optional: a profile can instead select artifacts individually with publishesReference.
ekg-artpub:publishesFamily | |
https://ekgf.org/ontology/artifact-publication#publishesFamily | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:domain | ekg-artpub:PublicationProfile |
rdfs:label | Publishes family |
rdfs:range | ekg-artgov:Family |
1.3.18 Publishes reference§
Selects an artifact by its stable reference for publication without a family. A profile can select several references. This does not create a family or assert family membership.
ekg-artpub:publishesReference | |
https://ekgf.org/ontology/artifact-publication#publishesReference | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:domain | ekg-artpub:PublicationProfile |
rdfs:label | Publishes reference |
rdfs:range | ekg-artgov:Reference |
1.3.19 Release family§
Identifies the one family whose version this release records. Optional: an ungrouped release selects artifacts with releaseReference instead. This is recorded explicitly, so editing a publication profile cannot change an existing release's scope.
ekg-artpub:releaseFamily | |
https://ekgf.org/ontology/artifact-publication#releaseFamily | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:domain | ekg-artpub:StandardsRelease |
rdfs:label | Release family |
rdfs:range | ekg-artgov:Family |
1.3.20 Release reference§
Identifies an artifact included in a release without family grouping. Each selected artifact is represented by a stable reference; the release supplies its version and content provenance. A release can select several references. These are source artifacts, distinct from generated outputs linked by publicationArtifact.
ekg-artpub:releaseReference | |
https://ekgf.org/ontology/artifact-publication#releaseReference | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:ObjectProperty |
rdfs:domain | ekg-artpub:StandardsRelease |
rdfs:label | Release reference |
rdfs:range | ekg-artgov:Reference |
1.3.21 Release version§
Public version label of a standards release, whether it releases a family or explicitly selected artifact references. The label belongs to the release, not the enduring family or reference, and need not be globally unique.
ekg-artpub:releaseVersion | |
https://ekgf.org/ontology/artifact-publication#releaseVersion | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:StandardsRelease |
rdfs:label | Release version |
rdfs:range | xsd:string |
1.3.22 Released at§
Timestamp at which a standards release was published.
ekg-artpub:releasedAt | |
https://ekgf.org/ontology/artifact-publication#releasedAt | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:StandardsRelease |
rdfs:label | Released at |
rdfs:range | xsd:dateTime |
1.3.23 Target kind§
Kind of publication target, such as website, pdf, rdf-download, archive or package.
ekg-artpub:targetKind | |
https://ekgf.org/ontology/artifact-publication#targetKind | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationTarget |
rdfs:label | Target kind |
rdfs:range | xsd:string |
1.3.24 Target URL§
Base URL or destination URL of a publication target.
ekg-artpub:targetUrl | |
https://ekgf.org/ontology/artifact-publication#targetUrl | |
| RDF predicate | Value |
|---|---|
rdf:type | owl:DatatypeProperty |
rdfs:domain | ekg-artpub:PublicationTarget |
rdfs:label | Target URL |
rdfs:range | xsd:anyURI |
1.4 Shapes§
1.4.1 Publication Profile Shape§
Validates that a publication profile explicitly selects a family or artifact references using the supported scope alternatives.
ekg-artpub:PublicationProfileShape | |
https://ekgf.org/ontology/artifact-publication#PublicationProfileShape | |
| RDF predicate | Value |
|---|---|
rdf:type | sh:NodeShape |
rdfs:label | Publication Profile Shape |
sh:class | ekg-artpub:PublicationProfile |
sh:message | A publication profile selects either one family or one or more artifact references. |
sh:nodeKind | sh:IRI |
sh:property | (sh:class: ekg-artgov:Family; sh:maxCount: 1; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:publishesFamily) |
sh:property | (sh:class: ekg-artgov:Reference; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:publishesReference) |
sh:targetClass | ekg-artpub:PublicationProfile |
sh:targetObjectsOf | ekg-artpub:publicationProfile |
sh:targetSubjectsOf | ekg-artpub:publishesFamily |
sh:targetSubjectsOf | ekg-artpub:publishesReference |
sh:xone | ((sh:property: (sh:minCount: 1; sh:path: ekg-artpub:publishesFamily); sh:property: (sh:maxCount: 0; sh:path: ekg-artpub:publishesReference)), (sh:property: (sh:minCount: 1; sh:path: ekg-artpub:publishesReference); sh:property: (sh:maxCount: 0; sh:path: ekg-artpub:publishesFamily))) |
1.4.2 Release Approval Shape§
Validates an approval record identifying the exact release approved, the approving authority, and the approval time.
ekg-artpub:ReleaseApprovalShape | |
https://ekgf.org/ontology/artifact-publication#ReleaseApprovalShape | |
| RDF predicate | Value |
|---|---|
rdf:type | sh:NodeShape |
rdfs:label | Release Approval Shape |
sh:class | ekg-artpub:ReleaseApproval |
sh:nodeKind | sh:IRI |
sh:not | (sh:or: ((sh:class: ekg-artgov:Family), (sh:class: ekg-artgov:Reference), (sh:class: ekg-artpub:StandardsRelease), (sh:class: ekg-artpub:PublicationProfile), (sh:class: ekg-artpub:PublicationRun))) |
sh:property | (sh:class: ekg-artgov:Authority; sh:maxCount: 1; sh:minCount: 1; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:approvedBy) |
sh:property | (sh:class: ekg-artpub:StandardsRelease; sh:maxCount: 1; sh:minCount: 1; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:approvesRelease) |
sh:property | (sh:datatype: xsd:dateTime; sh:maxCount: 1; sh:minCount: 1; sh:path: ekg-artpub:approvedAt) |
sh:targetClass | ekg-artpub:ReleaseApproval |
sh:targetSubjectsOf | ekg-artpub:approvedAt |
sh:targetSubjectsOf | ekg-artpub:approvedBy |
sh:targetSubjectsOf | ekg-artpub:approvesRelease |
1.4.3 Standards Release Shape§
Validates a standards release's family or reference scope, version label, and optional publication and content-provenance records.
ekg-artpub:StandardsReleaseShape | |
https://ekgf.org/ontology/artifact-publication#StandardsReleaseShape | |
| RDF predicate | Value |
|---|---|
rdf:type | sh:NodeShape |
rdfs:label | Standards Release Shape |
sh:class | ekg-artpub:StandardsRelease |
sh:nodeKind | sh:IRI |
sh:not | (sh:or: ((sh:class: ekg-artgov:Family), (sh:class: ekg-artgov:Reference), (sh:class: ekg-artpub:PublicationProfile), (sh:class: ekg-artpub:PublicationRun), (sh:class: ekg-artpub:PublicationArtifact), (sh:class: ekg-artpub:ReleaseApproval))) |
sh:property | (sh:class: ekg-artgov:Family; sh:maxCount: 1; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:releaseFamily) |
sh:property | (sh:class: ekg-artpub:PublicationProfile; sh:maxCount: 1; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:publicationProfile) |
sh:property | (sh:datatype: xsd:string; sh:maxCount: 1; sh:minLength: 1; sh:path: ekg-artpub:inputCommitCid) |
sh:property | (sh:class: ekg-artgov:Reference; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:releaseReference) |
sh:property | (sh:datatype: xsd:string; sh:maxCount: 1; sh:minCount: 1; sh:minLength: 1; sh:path: ekg-artpub:releaseVersion) |
sh:property | (sh:class: ekg-artpub:PublicationRun; sh:maxCount: 1; sh:node: (sh:property: (sh:datatype: xsd:string; sh:maxCount: 1; sh:minCount: 1; sh:minLength: 1; sh:path: ekg-artpub:inputCommitCid); sh:property: (sh:class: ekg-artpub:PublicationProfile; sh:maxCount: 1; sh:minCount: 1; sh:nodeKind: sh:IRI; sh:path: ekg-artpub:publicationProfile)); sh:nodeKind: sh:IRI; sh:path: ekg-artpub:publicationRun) |
sh:sparql | (sh:message: A release and every linked publication profile must select the same family or the same artifact references.; sh:select: SPARQL SELECT query 1) |
sh:sparql | (sh:message: A release linked to a publication run must record the same input commit.; sh:select: SPARQL SELECT query 2) |
sh:targetClass | ekg-artpub:StandardsRelease |
sh:targetObjectsOf | ekg-artpub:approvesRelease |
sh:targetObjectsOf | ekg-artpub:publicationRelease |
sh:targetSubjectsOf | ekg-artpub:releaseFamily |
sh:targetSubjectsOf | ekg-artpub:releaseReference |
sh:targetSubjectsOf | ekg-artpub:releaseVersion |
sh:xone | ((sh:property: (sh:maxCount: 0; sh:path: ekg-artpub:releaseReference); sh:property: (sh:minCount: 1; sh:path: ekg-artpub:releaseFamily)), (sh:property: (sh:maxCount: 0; sh:path: ekg-artpub:releaseFamily); sh:property: (sh:minCount: 1; sh:path: ekg-artpub:releaseReference))) |
1.4.3.1 SPARQL query 1§
A release and every linked publication profile must select the same family or the same artifact references.
PREFIX artpub: <https://ekgf.org/ontology/artifact-publication#>
SELECT $this WHERE {
$this (artpub:publicationProfile|artpub:publicationRun/artpub:publicationProfile) ?profile .
{
{ $this artpub:releaseFamily ?scope .
FILTER NOT EXISTS { ?profile artpub:publishesFamily ?scope } }
UNION
{ ?profile artpub:publishesFamily ?scope .
FILTER NOT EXISTS { $this artpub:releaseFamily ?scope } }
UNION
{ $this artpub:releaseReference ?scope .
FILTER NOT EXISTS { ?profile artpub:publishesReference ?scope } }
UNION
{ ?profile artpub:publishesReference ?scope .
FILTER NOT EXISTS { $this artpub:releaseReference ?scope } }
}
}
1.4.3.2 SPARQL query 2§
A release linked to a publication run must record the same input commit.
PREFIX artpub: <https://ekgf.org/ontology/artifact-publication#>
SELECT $this WHERE {
$this artpub:publicationRun/artpub:inputCommitCid ?commit .
FILTER NOT EXISTS { $this artpub:inputCommitCid ?commit }
}