IKE Docs
Koncept AsciiDoc Extension 43

Koncept AsciiDoc Extension

An AsciidoctorJ extension providing the k:ConceptName[] inline macro for formally identified terminology concepts. Renders SVG badges for HTML and PDF output, DocBook phrases for XSL-FO backends, and plain text for Prawn. Automatically generates a Referenced Koncepts glossary section with definitions, description logic axioms, SNOMED CT identifiers, and OWL IRIs.

Usage

In any AsciiDoc document processed by the IKE pipeline:

The patient presents with k:Hypertension[] and k:Type2Diabetes[].

Each k:Name[] reference renders as a styled badge linking to the auto-generated glossary at the end of the document.

Koncept Definitions

Definitions are sourced from YAML files (koncepts.yml) bundled with the extension JAR. Each entry includes:

  • Natural language definition
  • Description logic axioms (when available)
  • SNOMED CT concept identifier
  • OWL IRI for formal ontology alignment

Registration

The inline macro is registered via Java SPI (META-INF/services) and works with all AsciiDoc backends. The glossary postprocessor is registered per-execution in the asciidoctor-maven-plugin configuration (not via SPI, due to incompatibility with the Prawn PDF backend).

Backend Rendering

Backend Rendering
HTML5 SVG badge with brand colors and hyperlink to glossary
Prawn PDF Styled text with color coding
DocBook/FO DocBook phrase elements for FOP and XEP rendering
Koncept AsciiDoc extension AsciidoctorJ description logic SNOMED CT clinical terminology SVG badge
Date: 2026-05-17 11:38:25 -0700
Searching...
No results.