GraphArch Documentation and Publication Ontology

A vocabulary for collecting source contributions, generating reusable documentation fragments, assembling validated dataset revisions, resolving publication plans, and recording HTML and PDF publication results. It separates the identity of documented resources and logical components from target-specific arrangement and presentation.

This is the evolving publication-pipeline vocabulary. Earlier documentation.ttl and doc-component-categories.ttl files are prototype vocabularies, not imports or authoritative definitions of this contract. Version 0.0.1 is a development identifier; immutable releases and persistent namespace hosting remain release work.

Domain and range declarations support RDF inference; they are not closed-world validation rules. Broad rdfs:Resource domains and ranges are intentional where properties are reused across resource kinds or identify arbitrary domain resources. Cardinalities, value sets, path safety, markup safety, size budgets, and lifecycle transitions are enforced by the companion SHACL shapes and Rust implementation. Embedded RDF examples illustrate individual relationships; they are not complete build configurations. The ontology imports the Artifact Governance Ontology for authority semantics. Grapharch does not fetch imports implicitly during a documentation build.

2.1 ga:Authority§

Label: Publishing authority

A governance role responsible for semantic artifacts or their publication namespaces, distinct from the party playing that role and reusable across publication targets.

IRI: https://ekgf.org/ontology/grapharch#Authority

Note: Authority has the meaning defined by the Artifact Governance Ontology in EKGF/ekg-ontologies. Reuse its registered UUIDv4 authority identities. Link the distinct organization or other party with cmns-rlcmp:isPlayedBy. Names, hosts, and URLs are metadata, not authority identity keys. The player may be unknown. Display names use rdfs:label; canonical abbreviations use artgov:authorityAcronym.

2.2 ga:BibliographicEntry§

Label: Bibliographic entry

An identified bibliographic reference discovered in a source specification and available for citation and reference linking.

IRI: https://ekgf.org/ontology/grapharch#BibliographicEntry

2.3 ga:BinaryAsset§

Label: Chunked publication artifact

A retained publication artifact represented by ordered base64 chunks, an output route, a byte count, and a SHA-256 digest.

IRI: https://ekgf.org/ontology/grapharch#BinaryAsset

Note: Binary assets include collected images and generated publication artifacts. Fragments and collected references can identify them through ga:asset; publication plans select assets required by scoped content. They are not placeholder fragments. Publication verifies decoded size, SHA-256 digest and supported image content before committing the output.

2.4 ga:BookPlan§

Label: Book plan

A resolved publication unit grouping selected placements into one book against the publication plan's pinned input revision.

IRI: https://ekgf.org/ontology/grapharch#BookPlan

2.5 ga:BookPublication§

Label: Book publication operation

An observed per-book publication operation recording its resolved plan, pinned revision, execution outcome, and generated artifact provenance.

IRI: https://ekgf.org/ontology/grapharch#BookPublication

2.6 ga:Collector§

Label: Source collector

A specialized processor that reads one supported kind of native source, recognizes its documentation hints, and contributes normalized RDF with source provenance.

IRI: https://ekgf.org/ontology/grapharch#Collector

2.7 ga:Component§

Label: Logical component

A logical documentation unit that groups reusable fragments independently of their position in a particular output.

IRI: https://ekgf.org/ontology/grapharch#Component

2.8 ga:Contribution§

Label: Source contribution

A stable ownership unit identifying the output of one processor for one source in one project, whose committed versions may change over time.

IRI: https://ekgf.org/ontology/grapharch#Contribution

Note: The stable contribution owner, immutable version identifier, and individual execution attempt are distinct resources. A failed or superseded attempt must not advance the committed head.

2.9 ga:DefinedTerm§

Label: Defined term

An identified term definition discovered in documentation, retaining its source identity for linking and reference resolution.

IRI: https://ekgf.org/ontology/grapharch#DefinedTerm

2.10 ga:Diagnostic§

Label: Build diagnostic

An identified report of a pipeline problem or observation, linked to its operation, affected resource, input revision, and reusable diagnostic fragment.

IRI: https://ekgf.org/ontology/grapharch#Diagnostic

Note: Diagnostics are derived output. They can be rendered as documentation, but do not change the source assertions they report on.

2.11 ga:Documentor§

Label: Specialized RDF fragment generator

A specialized processor that reads already collected RDF and generates documentation fragments for identified resources without interpreting source-native syntax.

IRI: https://ekgf.org/ontology/grapharch#Documentor

2.12 ga:Entry§

Label: Resolved fragment occurrence

A resolved occurrence of one fragment within a component placement in a publication plan, preserving placement and fragment order.

IRI: https://ekgf.org/ontology/grapharch#Entry

2.13 ga:Example§

Label: Specification example

An identified example discovered in documentation, such as a fenced code block with its language and source-fragment relationship.

IRI: https://ekgf.org/ontology/grapharch#Example

2.14 ga:ExternalReference§

Label: External reference

An identified reference to material addressed by a fragment rather than placed as a documentation subject, including an external repository resource or a retained binary image. Declaring the reference does not itself add a native RDF subject to the publication scope.

IRI: https://ekgf.org/ontology/grapharch#ExternalReference

2.15 ga:Fragment§

Label: Documentation fragment

An identified unit of authored or generated content with a body, content format, one or more documented subjects, and contribution provenance.

IRI: https://ekgf.org/ontology/grapharch#Fragment

Note: A fragment is reusable across targets. Output position belongs to placements and resolved entries, not to the identity of the documented subject.

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
<urn:intro> a ga:Fragment ;
    ga:subject <urn:product> ;
    ga:body "An introduction." ;
    ga:format "text/markdown" ;
    ga:contribution <urn:contribution:intro> .

2.16 ga:MetadataRow§

Label: Publication metadata row

An ordered front-matter record preserving a source publication field, display label, and associated value or link.

IRI: https://ekgf.org/ontology/grapharch#MetadataRow

2.17 ga:OntologyModule§

Label: Ontology module

A named grouping of ontologies or subordinate modules, recognized from explicit source assertions and preserved independently of its publication placement.

IRI: https://ekgf.org/ontology/grapharch#OntologyModule

Note: FIBO Module instances and their dct:hasPart assertions are recognized by the RDF source adapter. Original source assertions are retained. Publication rejects cycles, ambiguous multiple parents, missing members, and hierarchies deeper than eight component levels. Ontologies without explicit module membership remain separate reference chapters.

2.18 ga:Operation§

Label: Pipeline operation

An identified execution of a pipeline stage for which diagnostics and an execution policy can be recorded.

IRI: https://ekgf.org/ontology/grapharch#Operation

2.19 ga:Page§

Label: Website page grouping

An output-oriented grouping of documentation topics with a source path, website route, and navigation hints.

IRI: https://ekgf.org/ontology/grapharch#Page

2.20 ga:Placement§

Label: Component placement

A profile-specific occurrence of a logical component with an explicit position, independent of that component and its reusable fragments.

IRI: https://ekgf.org/ontology/grapharch#Placement

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
<urn:reader> a ga:Profile ;
    ga:placement <urn:intro:placement> .
<urn:intro:placement> a ga:Placement ;
    ga:component <urn:introduction> ;
    ga:order 0 .

2.21 ga:Plan§

Label: Publication plan

A resolved publication instruction set selecting content, ordered entries, and assets for one target against a pinned input revision.

IRI: https://ekgf.org/ontology/grapharch#Plan

Note: A plan and its input content must be read through their pinned snapshots. Plan contributions and diagnostics do not become source contribution heads for later assembly.

2.22 ga:Processor§

Label: Contribution processor

An identified pipeline participant that owns reproducible contributions to a documentation project at a declared lifecycle stage.

IRI: https://ekgf.org/ontology/grapharch#Processor

Note: Processor identity denotes a configured contribution owner; it does not imply a separate operating-system process or separately distributed binary.

2.23 ga:Profile§

Label: Publication profile

An identified arrangement of logical components for a publication audience or purpose, expressed through ordered placements.

IRI: https://ekgf.org/ontology/grapharch#Profile

2.24 ga:Project§

Label: Documentation project

An identified documentation configuration whose sources, processors, scopes, profiles, and publication targets share a logical RDF dataset.

IRI: https://ekgf.org/ontology/grapharch#Project

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
<urn:manual> a ga:Project ;
    ga:target <urn:manual:web> .

2.25 ga:PublicationJob§

Label: Publication job

A recorded rendering attempt for a target and pinned plan, including its execution policy, outcome, diagnostic count, and output location when published.

IRI: https://ekgf.org/ontology/grapharch#PublicationJob

Note: Output locations can be local execution artifacts. They are not necessarily public URLs and are not inputs required to reconstruct source documentation.

2.26 ga:ReferenceSection§

Label: Reference section

A source-owned title and ordering override for one kind of resource section in an ontology family reference.

IRI: https://ekgf.org/ontology/grapharch#ReferenceSection

Note: Use ga:sectionKind to select classes, properties, individuals, shapes, schemes, concepts, collections, or other; dct:title supplies one English or untagged plain-text heading; ga:order supplies a distinct integer from 0 to 1000. Defaults are Classes (10), Properties (20), Named Individuals (30), Shapes (40), Concept Schemes (41), Concepts (42), Collections (43), and Other Terms (50). Empty categories are omitted. Overrides rename and reorder categories without suppressing resources. SKOS schemes, concepts, and collections take precedence over other declared types; then named individuals, classes, properties, shapes, and other terms.

2.27 ga:Revision§

Label: Assembled dataset revision

An identified documentation dataset state accepted by assembly for a project, against which scope resolution and publication planning can operate.

IRI: https://ekgf.org/ontology/grapharch#Revision

Note: Assembly validates the selected source and document contributions. A captured contribution snapshot is not automatically an assembled, publishable revision. Revision resources are not Oxigraph transaction identifiers.

2.28 ga:Scope§

Label: Documentation scope

A reusable selection of documentable resources defined by inclusions, exclusions, composition, and explicitly bounded relationship traversal.

IRI: https://ekgf.org/ontology/grapharch#Scope

Note: Scope membership is explicit. A reference to an external resource does not imply inclusion. Traversal requires a declared maximum depth; cyclic composition is rejected.

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
<urn:scope> a ga:Scope ;
    ga:include <urn:root> ;
    ga:traverse rdfs:subClassOf ;
    ga:maxDepth 2 .

2.29 ga:ScopePlan§

Label: Resolved scope plan

An evaluated scope result recording the selected documentable members for a particular input revision.

IRI: https://ekgf.org/ontology/grapharch#ScopePlan

2.30 ga:Section§

Label: Specification section

An identified section discovered in a source specification, retaining its source-document relationship and native anchors.

IRI: https://ekgf.org/ontology/grapharch#Section

2.31 ga:Showcase§

Label: Executable documentation showcase

An executable documentation example connecting native inputs and expected diagnostics to generated previews, PDFs, other outputs, and an exported dataset.

IRI: https://ekgf.org/ontology/grapharch#Showcase

2.32 ga:Target§

Label: Publication target

A named publication configuration binding one scope, one presentation profile, a renderer, and a relative output destination.

IRI: https://ekgf.org/ontology/grapharch#Target

Note: A project can define separate specification, companion-website, and document targets with different scopes and profiles. Targets are publications, not merely alternative styling choices. Plans for a publication family can share one assembled input revision while retaining independent placement and execution records.

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
<urn:manual:web> a ga:Target ;
    ga:scope <urn:scope> ;
    ga:profile <urn:reader> ;
    ga:renderer "html" ;
    ga:destination "reader" .

2.33 ga:TextAsset§

Label: Collected UTF-8 download

A collected UTF-8 text resource retained in the documentation graph for publication as a downloadable file.

IRI: https://ekgf.org/ontology/grapharch#TextAsset

2.34 ga:Topic§

Label: Documentation topic

A logical documentation component with stable identity, reusable fragments, and optional parent-topic and example relationships.

IRI: https://ekgf.org/ontology/grapharch#Topic

3.1 ga:about§

Label: Diagnosed artifact

Identifies the resource or artifact to which a diagnostic applies.

IRI: https://ekgf.org/ontology/grapharch#about

3.2 ga:artifactDirectory§

Label: Published artifact directory

Identifies the directory in which a successful publication job wrote its output files; a local file IRI records execution provenance rather than a portable download URL.

IRI: https://ekgf.org/ontology/grapharch#artifactDirectory

3.3 ga:asset§

Label: Retained binary asset

Identifies a retained binary artifact referenced by a documentation fragment or collected reference, or selected by a publication plan for emission alongside rendered documentation.

IRI: https://ekgf.org/ontology/grapharch#asset

Note: A fragment or reference can identify an image before publication planning. A plan selects the retained assets needed by its scoped content. Referencing an asset does not classify its owner as a publication plan and does not authorize network access during rendering.

3.4 ga:attempt§

Label: Owning contribution attempt

Associates a physical retained graph with the contribution attempt that wrote it.

IRI: https://ekgf.org/ontology/grapharch#attempt

3.5 ga:author§

Label: Document author

Identifies a contributor credited as an author of a specification.

IRI: https://ekgf.org/ontology/grapharch#author

3.6 ga:bookPlacement§

Label: Book placement

Includes a selected placement in exactly one resolved book.

IRI: https://ekgf.org/ontology/grapharch#bookPlacement

3.7 ga:bookPlan§

Label: Book plan

Links a resolved family plan to one of its module or standalone ontology books.

IRI: https://ekgf.org/ontology/grapharch#bookPlan

3.8 ga:bookRoot§

Label: Book root

Identifies the root placement of a resolved book.

IRI: https://ekgf.org/ontology/grapharch#bookRoot

3.9 ga:bookSubject§

Label: Book subject

Identifies the module or ontology documented by a resolved book.

IRI: https://ekgf.org/ontology/grapharch#bookSubject

3.10 ga:chunk§

Label: Ordered artifact content chunk

Identifies an ordered base64 content chunk of a retained binary artifact.

IRI: https://ekgf.org/ontology/grapharch#chunk

3.11 ga:collector§

Label: Configured collector or executing processor

Associates a project with a configured collector, or a contribution attempt with the processor executing its stage.

IRI: https://ekgf.org/ontology/grapharch#collector

Note: Project declarations use collector instances. Internal attempt metadata also uses this property for documentors and other processors; its range is therefore ga:Processor rather than ga:Collector.

3.12 ga:component§

Label: Logical component

Associates a placement or resolved entry with the logical component whose fragments are being arranged.

IRI: https://ekgf.org/ontology/grapharch#component

3.13 ga:compose§

Label: Composed scope

Includes the selection of another documentation scope in the scope being defined, subject to bounded traversal and exclusion rules.

IRI: https://ekgf.org/ontology/grapharch#compose

3.14 ga:contribution§

Label: Source contribution

Identifies the stable processor-owned contribution from which a documentation fragment or retained asset originates.

IRI: https://ekgf.org/ontology/grapharch#contribution

3.15 ga:currentRevision§

Label: Current validated project revision

Identifies the most recently accepted assembled revision of a documentation project.

IRI: https://ekgf.org/ontology/grapharch#currentRevision

3.16 ga:data§

Label: Retained contribution data

Associates a committed contribution version with the retained attempt whose physical graphs contain its assertions.

IRI: https://ekgf.org/ontology/grapharch#data

3.17 ga:datasetArtifact§

Label: Exported showcase dataset

Identifies the retained RDF dataset export offered for a showcase.

IRI: https://ekgf.org/ontology/grapharch#datasetArtifact

3.18 ga:derivedFrom§

Label: Source documentation fragment

Identifies the source documentation fragment from which a topic, example, or other documentation construct was derived.

IRI: https://ekgf.org/ontology/grapharch#derivedFrom

3.19 ga:diagnostic§

Label: Operation diagnostic

Associates a pipeline operation or publication job with a recorded diagnostic.

IRI: https://ekgf.org/ontology/grapharch#diagnostic

3.20 ga:editor§

Label: Document editor

Identifies a contributor credited as an editor of a specification.

IRI: https://ekgf.org/ontology/grapharch#editor

3.21 ga:editorDraft§

Label: Latest editor draft

Identifies the public location of the latest editor-maintained draft of a document.

IRI: https://ekgf.org/ontology/grapharch#editorDraft

3.22 ga:entry§

Label: Publication plan entry

Associates a resolved publication plan with one of its ordered fragment occurrences.

IRI: https://ekgf.org/ontology/grapharch#entry

3.23 ga:example§

Label: Topic code example

Associates a logical documentation topic with an identified code example.

IRI: https://ekgf.org/ontology/grapharch#example

3.24 ga:exclude§

Label: Excluded scope member

Identifies a resource excluded from the resolved members of a documentation scope.

IRI: https://ekgf.org/ontology/grapharch#exclude

3.25 ga:failed§

Label: Failed contribution attempt

Associates a stable contribution owner with a failed attempt retained for failure reporting without replacing its committed head.

IRI: https://ekgf.org/ontology/grapharch#failed

3.26 ga:formerEditor§

Label: Former document editor

Identifies a contributor credited as a former editor of a specification.

IRI: https://ekgf.org/ontology/grapharch#formerEditor

3.27 ga:fragment§

Label: Documentation fragment

Associates a component, plan entry, or diagnostic with a reusable documentation fragment.

IRI: https://ekgf.org/ontology/grapharch#fragment

3.28 ga:head§

Label: Committed contribution head

Associates a stable contribution owner with its current committed version in control metadata, or with a pinned version in a snapshot graph.

IRI: https://ekgf.org/ontology/grapharch#head

Note: Its interpretation depends on graph context: the control graph holds mutable current heads, while snapshot graphs retain immutable selections. Querying all graphs without snapshot selection can mix revisions.

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
<urn:owner> ga:head <urn:version:one> .

3.29 ga:implementationReport§

Label: Implementation report

Identifies the report describing implementations of a specification.

IRI: https://ekgf.org/ontology/grapharch#implementationReport

3.30 ga:include§

Label: Included scope seed

Identifies a resource explicitly included as a seed member of a documentation scope.

IRI: https://ekgf.org/ontology/grapharch#include

3.31 ga:inputRevision§

Label: Pinned input revision

Identifies the pinned input dataset state against which a plan, operation, diagnostic, or publication job was produced.

IRI: https://ekgf.org/ontology/grapharch#inputRevision

3.32 ga:latestRecommendation§

Label: Latest recommendation

Identifies the latest recommendation referenced in specification front matter.

IRI: https://ekgf.org/ontology/grapharch#latestRecommendation

3.33 ga:latestVersion§

Label: Latest published document version

Identifies the public location of the latest published version of a document.

IRI: https://ekgf.org/ontology/grapharch#latestVersion

3.34 ga:license§

Label: Document license

Identifies the license governing the published document or its documented content.

IRI: https://ekgf.org/ontology/grapharch#license

3.35 ga:member§

Label: Resolved scope member

Identifies a documentable resource selected into an evaluated scope plan.

IRI: https://ekgf.org/ontology/grapharch#member

3.36 ga:metadataRow§

Label: Metadata row

Associates a publication target with an ordered front-matter metadata record retained from its source.

IRI: https://ekgf.org/ontology/grapharch#metadataRow

3.37 ga:moduleMember§

Label: Module member

Relates an explicitly declared ontology module to one of its named ontologies or subordinate modules without inferring containment from directories or imports.

IRI: https://ekgf.org/ontology/grapharch#moduleMember

3.38 ga:orcid§

Label: Contributor ORCID

Identifies the ORCID record associated with a publication contributor.

IRI: https://ekgf.org/ontology/grapharch#orcid

3.39 ga:outputArtifact§

Label: Showcase publication output

Identifies a retained publication output belonging to a showcase, including outputs beyond its primary preview and PDF.

IRI: https://ekgf.org/ontology/grapharch#outputArtifact

3.40 ga:parentPlacement§

Label: Parent placement

Places a documentation component beneath an earlier component in the same publication, preserving its parent hierarchy in a pinned publication plan.

IRI: https://ekgf.org/ontology/grapharch#parentPlacement

3.41 ga:parentTopic§

Label: Enclosing logical topic

Identifies the enclosing logical topic of a documentation topic, independently of filesystem directory layout.

IRI: https://ekgf.org/ontology/grapharch#parentTopic

3.42 ga:partOf§

Label: Containing source document

Identifies the containing document, page, or logical topic of a collected documentation construct.

IRI: https://ekgf.org/ontology/grapharch#partOf

3.43 ga:pdfArtifact§

Label: Primary PDF output

Identifies the retained PDF artifact offered for a showcase.

IRI: https://ekgf.org/ontology/grapharch#pdfArtifact

3.44 ga:pending§

Label: Pending contribution attempt

Associates a stable contribution owner with its active uncommitted attempt; starting a newer attempt supersedes the pending attempt.

IRI: https://ekgf.org/ontology/grapharch#pending

3.45 ga:placement§

Label: Component placement

Associates a publication profile or resolved plan entry with a target-specific component occurrence.

IRI: https://ekgf.org/ontology/grapharch#placement

3.46 ga:plan§

Label: Rendered publication plan

Identifies the resolved publication plan rendered by a publication job.

IRI: https://ekgf.org/ontology/grapharch#plan

3.47 ga:planSnapshot§

Label: Pinned plan snapshot

Identifies the pinned contribution snapshot containing the resolved publication plan used by a rendering job.

IRI: https://ekgf.org/ontology/grapharch#planSnapshot

3.48 ga:previewArtifact§

Label: Primary HTML preview

Identifies the retained HTML artifact used as the primary live preview of a showcase.

IRI: https://ekgf.org/ontology/grapharch#previewArtifact

3.49 ga:previousVersion§

Label: Previous document version

Identifies the public location of the preceding version of a document.

IRI: https://ekgf.org/ontology/grapharch#previousVersion

3.50 ga:processor§

Label: Owning processor

Identifies the processor that owns a contribution, including a collector, documentor, or other pipeline processor.

IRI: https://ekgf.org/ontology/grapharch#processor

3.51 ga:profile§

Label: Publication profile

Associates a publication target or resolved plan with the profile defining its component arrangement.

IRI: https://ekgf.org/ontology/grapharch#profile

3.52 ga:project§

Label: Documentation project

Identifies the documentation project to which a contribution, execution attempt, resolved plan, or publication job belongs.

IRI: https://ekgf.org/ontology/grapharch#project

3.53 ga:publisher§

Label: Specification publisher

Identifies the publishing authority responsible for a specification target.

IRI: https://ekgf.org/ontology/grapharch#publisher

3.54 ga:reference§

Label: Referenced resource

Identifies a resource referenced by a documentation fragment and checked during assembly and publication planning.

IRI: https://ekgf.org/ontology/grapharch#reference

3.55 ga:referenceSection§

Label: Reference section override

Associates an ontology with a named reference section override controlling the title and order of one resource category.

IRI: https://ekgf.org/ontology/grapharch#referenceSection

3.56 ga:repository§

Label: Project source repository

Identifies the source repository of a documentation project, enabling source links and repository-specific presentation.

IRI: https://ekgf.org/ontology/grapharch#repository

3.57 ga:scope§

Label: Documentation scope

Associates a project, target, or evaluated scope plan with the reusable documentation scope that it configures or resolves.

IRI: https://ekgf.org/ontology/grapharch#scope

3.58 ga:scopePlan§

Label: Resolved scope plan

Identifies the evaluated scope result used to select the content of a publication plan.

IRI: https://ekgf.org/ontology/grapharch#scopePlan

3.59 ga:showcase§

Label: Project showcase

Associates a documentation project with an executable showcase included in its gallery.

IRI: https://ekgf.org/ontology/grapharch#showcase

3.60 ga:sourceFragment§

Label: Affected source fragment

Identifies the existing documentation fragment affected by a diagnostic, when the problem can be located to a fragment.

IRI: https://ekgf.org/ontology/grapharch#sourceFragment

3.61 ga:statusUrl§

Label: Publication status URL

Identifies the explanatory web page linked from a specification publication-status label.

IRI: https://ekgf.org/ontology/grapharch#statusUrl

3.62 ga:subject§

Label: Documented subject

Identifies a documentable resource described by a fragment, independently of that resource being selected for a particular output.

IRI: https://ekgf.org/ontology/grapharch#subject

3.63 ga:target§

Label: Publication target

Associates a project, publication plan, or publication job with the publication target being configured, resolved, or rendered.

IRI: https://ekgf.org/ontology/grapharch#target

3.64 ga:testSuite§

Label: Publication test suite

Identifies the test suite associated with a specification.

IRI: https://ekgf.org/ontology/grapharch#testSuite

3.65 ga:thisVersion§

Label: This published document version

Identifies the public location of the particular document version described by the publication metadata.

IRI: https://ekgf.org/ontology/grapharch#thisVersion

3.66 ga:topic§

Label: Document topic

Associates a page or documentation construct with an identified logical documentation topic.

IRI: https://ekgf.org/ontology/grapharch#topic

3.67 ga:traverse§

Label: Traversal predicate

Identifies an RDF predicate along which scope resolution may follow outgoing relationships from included resources.

IRI: https://ekgf.org/ontology/grapharch#traverse

3.68 ga:validatedFor§

Label: Project for which a revision was validated

Identifies the project for which assembly accepted a dataset revision as publishable input.

IRI: https://ekgf.org/ontology/grapharch#validatedFor

3.69 ga:version§

Label: Contribution version

Associates a contribution attempt with its reproducible version identifier, which can be finalized before commit.

IRI: https://ekgf.org/ontology/grapharch#version

4.1 ga:accentColor§

Label: Authority accent color

Specifies the six-digit hexadecimal RGB color used for authority accents in a rendered publication.

IRI: https://ekgf.org/ontology/grapharch#accentColor

Note: The current renderer requires a value matching #[0-9A-Fa-f]{6}.

4.2 ga:affiliation§

Label: Editor affiliation

Records the organization affiliation displayed for a publication contributor.

IRI: https://ekgf.org/ontology/grapharch#affiliation

4.3 ga:base64§

Label: Base64-encoded chunk bytes

Contains the base64 encoding of the bytes in one retained binary-artifact chunk.

IRI: https://ekgf.org/ontology/grapharch#base64

Note: The current encoding uses canonical base64 text in an xsd:string literal, not an xsd:base64Binary typed literal.

4.4 ga:body§

Label: Content body

Contains the literal content of a documentation fragment or collected text resource, interpreted according to its declared format.

IRI: https://ekgf.org/ontology/grapharch#body

4.5 ga:bookBoundary§

Label: Book boundary

Overrides automatic leaf-module book selection: true makes this module and its descendants one book; false treats it as a series.

IRI: https://ekgf.org/ontology/grapharch#bookBoundary

4.6 ga:code§

Label: Stable diagnostic code

Records the stable machine-readable diagnostic category used by automation and expected-diagnostic checks.

IRI: https://ekgf.org/ontology/grapharch#code

4.7 ga:contentDigest§

Label: Artifact SHA-256 digest

Records the lowercase hexadecimal SHA-256 digest of the complete decoded artifact bytes.

IRI: https://ekgf.org/ontology/grapharch#contentDigest

4.8 ga:contentSize§

Label: Artifact byte count

Records the nonnegative number of decoded bytes in the complete retained artifact.

IRI: https://ekgf.org/ontology/grapharch#contentSize

4.9 ga:copyright§

Label: Document copyright statement

Contains the copyright and rights notice displayed for a publication.

IRI: https://ekgf.org/ontology/grapharch#copyright

4.10 ga:destination§

Label: Output destination

Specifies a safe relative directory within an output root in which a target publishes its generated files.

IRI: https://ekgf.org/ontology/grapharch#destination

4.11 ga:diagnosticCount§

Label: Diagnostic count

Records the number of diagnostics associated with a pipeline operation or publication job.

IRI: https://ekgf.org/ontology/grapharch#diagnosticCount

4.12 ga:executionPolicy§

Label: Execution failure policy

Records whether an operation stops at the first error or continues to collect diagnostics and produce permitted diagnostic output.

IRI: https://ekgf.org/ontology/grapharch#executionPolicy

Note: Current policy values are fail-fast and keep-going. Keep-going can publish diagnostic artifacts but still reports an unsuccessful build when errors remain.

4.13 ga:expectedDiagnostic§

Label: Expected fixture diagnostic code

Records a diagnostic code that must be observed when executing a showcase with a known source problem.

IRI: https://ekgf.org/ontology/grapharch#expectedDiagnostic

4.14 ga:field§

Label: Metadata field

Records the recognized metadata field identifier of a publication metadata row.

IRI: https://ekgf.org/ontology/grapharch#field

4.15 ga:format§

Label: Content format

Records the content-format identifier used to interpret a retained fragment or asset body.

IRI: https://ekgf.org/ontology/grapharch#format

Note: Current fragment paths use media-type identifiers such as text/markdown and text/html. A format identifier does not authorize execution of embedded scripts.

4.16 ga:fragmentOrder§

Label: Fragment position within a placement

Specifies the nonnegative integer position of a fragment within a resolved component placement.

IRI: https://ekgf.org/ontology/grapharch#fragmentOrder

Note: The current implementation accepts integers from 0 through 4294967295.

4.17 ga:headingAnchor§

Label: Original section heading anchor

Records a source heading identifier used for linking, including a retained HTML heading anchor or a Markdown-derived heading slug.

IRI: https://ekgf.org/ontology/grapharch#headingAnchor

4.18 ga:headingDepth§

Label: Fragment heading depth

Sets the starting depth of a fragment heading beneath its component, preserving section nesting across independently generated fragments.

IRI: https://ekgf.org/ontology/grapharch#headingDepth

4.19 ga:kind§

Label: Implementation kind

Records the implementation dispatch key identifying a collector or showcase pipeline kind.

IRI: https://ekgf.org/ontology/grapharch#kind

4.20 ga:language§

Label: Example code language

Records the source-code language identifier retained from an example code fence.

IRI: https://ekgf.org/ontology/grapharch#language

4.21 ga:linkLabel§

Label: Metadata link label

Records the human-readable link text retained for a publication metadata row.

IRI: https://ekgf.org/ontology/grapharch#linkLabel

4.22 ga:logo§

Label: Embedded authority logo

Contains the embedded PNG data URL used as the publishing authority logo without requiring a network fetch at render time.

IRI: https://ekgf.org/ontology/grapharch#logo

Note: The current renderer accepts data:image/png;base64, values and validates image content and size. The literal is a data URL, not an RDF link to a logo resource.

4.23 ga:maxDepth§

Label: Maximum traversal depth

Specifies the maximum number of relationship steps followed during scope traversal, with zero retaining only seed members.

IRI: https://ekgf.org/ontology/grapharch#maxDepth

Note: The current implementation accepts integers from 0 through 4294967295 and requires this property when ga:traverse is present.

4.24 ga:message§

Label: Diagnostic message

Contains the human-readable explanation of a diagnostic.

IRI: https://ekgf.org/ontology/grapharch#message

4.25 ga:metadataDisclosure§

Label: Collapsible publication metadata

Specifies whether specification metadata is presented in a collapsible disclosure element.

IRI: https://ekgf.org/ontology/grapharch#metadataDisclosure

4.26 ga:nativeAnchor§

Label: Original section anchor

Records an original source-document element identifier preserved for stable linking after collection and rendering.

IRI: https://ekgf.org/ontology/grapharch#nativeAnchor

4.27 ga:navigationHidden§

Label: Exclude page from navigation

Specifies whether a page is omitted from website navigation while remaining available at its route.

IRI: https://ekgf.org/ontology/grapharch#navigationHidden

4.28 ga:navigationOrder§

Label: Sibling navigation order

Specifies the numeric ordering hint used to arrange sibling pages in website navigation.

IRI: https://ekgf.org/ontology/grapharch#navigationOrder

Note: The Markdown collector accepts integers from 0 through 4294967295 and uses 999 when nav_order is omitted. The hint orders sibling pages rather than documentation fragments.

4.29 ga:ontologySource§

Label: Ontology specification source

Identifies the source-relative Turtle vocabulary file from which a specification target generates its ontology reference fragments and publication artifacts.

IRI: https://ekgf.org/ontology/grapharch#ontologySource

Note: The website build reads this declared source, generates named class and property reference fragments using the ontology's English annotations and preferred namespace, and retains the specification outputs as website assets. Source paths must stay inside the documentation root. Unsupported anonymous expressions or missing required annotations fail the build.

4.30 ga:order§

Label: Local position

Specifies the nonnegative integer position of an item within its containing ordered collection.

IRI: https://ekgf.org/ontology/grapharch#order

Note: The current implementation accepts integers from 0 through 4294967295. Ordering is local to the containing collection, not a global position.

4.31 ga:original§

Label: Original logical graph

Records the serialized original logical graph name represented by a retained physical graph, preserving the distinction between named, blank-node, and default graphs.

IRI: https://ekgf.org/ontology/grapharch#original

Note: The value is an xsd:string containing the graph-name spelling: <IRI> for a named graph, _:identifier for a blank-node graph, or DEFAULT for the default graph. It is not an IRI-valued relationship and does not reserve a domain IRI as a default-graph sentinel.

4.32 ga:parentTitle§

Label: Navigation parent title

Records the authored navigation-parent title used when assembling the website page hierarchy.

IRI: https://ekgf.org/ontology/grapharch#parentTitle

4.33 ga:pdfPath§

Label: Declared primary PDF output

Records the declared relative path of the primary PDF output expected from a showcase pipeline.

IRI: https://ekgf.org/ontology/grapharch#pdfPath

4.34 ga:pdfTocDepth§

Label: Book PDF contents depth

Sets the maximum heading depth in book PDF contents, independently of HTML navigation depth; bookshelf books default to chapters and sections at depth two.

IRI: https://ekgf.org/ontology/grapharch#pdfTocDepth

4.35 ga:pdfWorkers§

Label: PDF workers

Sets the bounded number of child Grapharch processes compiling book PDFs, between one and eight.

IRI: https://ekgf.org/ontology/grapharch#pdfWorkers

4.36 ga:personNote§

Label: Contributor note

Contains a supplementary contributor note, such as a service period or memorial acknowledgement.

IRI: https://ekgf.org/ontology/grapharch#personNote

4.37 ga:previewPath§

Label: Declared primary HTML output

Records the declared relative path of the primary HTML output expected from a showcase pipeline.

IRI: https://ekgf.org/ontology/grapharch#previewPath

4.38 ga:publicationDate§

Label: Publication date

Specifies the declared publication date displayed in specification front matter, using an XML Schema date literal.

IRI: https://ekgf.org/ontology/grapharch#publicationDate

Note: The value is an xsd:date. Rendering additionally checks calendar validity; ontology range axioms do not perform that validation.

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
<urn:manual:web> ga:publicationDate "2026-10-25"^^xsd:date .

4.39 ga:publicationStatus§

Label: Declared publication status

Records the authority-specific publication maturity label displayed in specification front matter.

IRI: https://ekgf.org/ontology/grapharch#publicationStatus

Note: This is publisher-controlled text, for example Working Draft or Reference Preview. It neither asserts external approval nor determines execution success.

4.40 ga:renderer§

Label: Renderer identifier

Records the renderer dispatch identifier selected for a target or recorded by a publication job.

IRI: https://ekgf.org/ontology/grapharch#renderer

Note: Current dispatch values are html, website, specification, specification-pages, bookshelf, and typst. These are implementation identifiers rather than a closed OWL enumeration of all possible renderers.

4.41 ga:reused§

Label: Reused verified PDF

Records whether this book operation reused a checksum-verified PDF with an unchanged effective compiler input fingerprint.

IRI: https://ekgf.org/ontology/grapharch#reused

4.42 ga:revision§

Label: Source revision token

Records the source or processor revision token identifying the reproducible content of a contribution attempt; this value is a literal, not a dataset revision IRI.

IRI: https://ekgf.org/ontology/grapharch#revision

Example:

@prefix ga: <https://ekgf.org/ontology/grapharch#> .
<urn:contribution:intro> ga:revision "sha256:source-content-digest" .

4.43 ga:route§

Label: Website-relative route

Records the safe website-relative output path assigned to a page or retained downloadable asset.

IRI: https://ekgf.org/ontology/grapharch#route

4.44 ga:sectionKind§

Label: Publication section kind

Records the structural role of a component, such as abstract, status, appendix, glossary, or references.

IRI: https://ekgf.org/ontology/grapharch#sectionKind

4.45 ga:severity§

Label: Diagnostic severity

Records the severity level of a diagnostic as an informational, warning, or error classification.

IRI: https://ekgf.org/ontology/grapharch#severity

Note: Current values are info, warning, and error. A diagnostic code identifies a category independently of severity.

4.46 ga:shortName§

Label: Authority abbreviation

Records the abbreviated name of a publishing authority used in compact publication labels.

IRI: https://ekgf.org/ontology/grapharch#shortName

4.47 ga:showcaseGallery§

Label: Render showcase collection on this page

Specifies whether a documentation page displays the generated collection of project showcases.

IRI: https://ekgf.org/ontology/grapharch#showcaseGallery

4.48 ga:showcasesSource§

Label: Declared showcase source directory

Records the explicitly configured source directory containing the showcase registry and native fixture inputs.

IRI: https://ekgf.org/ontology/grapharch#showcasesSource

4.49 ga:slug§

Label: Stable showcase artifact directory name

Records the stable safe directory name used to group a showcase and its publication artifacts.

IRI: https://ekgf.org/ontology/grapharch#slug

4.50 ga:source§

Label: Source identifier

Records the source identifier interpreted by the owning processor, such as a file path, query input, or showcase fixture directory.

IRI: https://ekgf.org/ontology/grapharch#source

Note: This property is a literal in the current contract, even when the string resembles an IRI. Its interpretation is specific to the configured processor.

4.51 ga:sourceMarkup§

Label: Retained source DOM markup

Contains retained source-document DOM markup used to preserve supported specification constructs through the RDF handoff.

IRI: https://ekgf.org/ontology/grapharch#sourceMarkup

4.52 ga:sourcePath§

Label: Source-relative path

Records the source-relative file path retained for provenance and source navigation.

IRI: https://ekgf.org/ontology/grapharch#sourcePath

4.53 ga:stage§

Label: Contribution lifecycle stage

Records the contribution lifecycle stage used to distinguish collected content, generated documentation, and derived plans.

IRI: https://ekgf.org/ontology/grapharch#stage

Note: Current contribution stage values are collect, document, and plan. Assembly and rendering have separate revision and job records.

4.54 ga:status§

Label: Execution outcome

Records the execution outcome of a pipeline operation or publication job, independently of a specification publication-status label.

IRI: https://ekgf.org/ontology/grapharch#status

4.55 ga:style§

Label: Publication presentation style

Records the Publication presentation style requested by a publication target or retained in its plan.

IRI: https://ekgf.org/ontology/grapharch#style

4.56 ga:subtitle§

Label: Publication subtitle

Contains the secondary title displayed below a publication title.

IRI: https://ekgf.org/ontology/grapharch#subtitle

4.57 ga:tocDepth§

Label: Maximum contents depth

Sets a maximum heading depth for a specification contents sidebar and its PDF outline, allowing large families to list modules and ontologies without every vocabulary term.

IRI: https://ekgf.org/ontology/grapharch#tocDepth

Note: An integer from one to eight on a target or profile. A target value overrides its profile. When absent, HTML retains the full outline and PDF retains its default depth of three.

4.58 ga:tocFrontMatter§

Label: Include front matter in contents

Specifies whether unnumbered front-matter sections are included in the specification table of contents.

IRI: https://ekgf.org/ontology/grapharch#tocFrontMatter

4.59 ga:unresolvedReference§

Label: Reported reference

Records the original reference text or address that could not be resolved during processing.

IRI: https://ekgf.org/ontology/grapharch#unresolvedReference

4.60 ga:url§

Label: External reference URL

Records a literal web address used for external-reference or contributor presentation; this legacy representation is distinct from IRI-valued publication links.

IRI: https://ekgf.org/ontology/grapharch#url

Note: The object is a string literal in the existing contract. Properties such as ga:thisVersion, ga:repository, and ga:orcid instead have IRI objects.