Skip to content

Describe use for ontology-in-document (esp. Metanorma) #79

Description

@johanwk

An Elot outline that declares an ontology is suitable for being included in a larger document, typically a standard where the ontology provides a vocabulary with more structure than the typical list of "terms and definitions" (these are not exclusive; terms may well need to be defined that have no natural place in an ontology).

The IDO standard document follows this pattern.

For more general use,
I've tested a setup where Elot is the source of an ontology clause within a Metanorma document; more specifically

  • Copied the "Rice" ISO standard which is distributed as a common example with Metanorma
  • Took an Elot file (examples/test-llm-citrus.org) and exported to Asciidoc
    • The support for export org-mode -> asciidoc is in ox-asciidoc. Some tweaks are needed for links and such to work properly, but it appears these are not difficult to add
  • Replaced the contents of a clause in the Rice example with the Elot export
  • Compiled the document

This works quite well as a proof of concept: if you have a standard document, Elot can be used as the source of an ontology clause included in the standard. Cross-references will work (plain text after all). It's natural to use Elot to generate diagrams (rdfpuml) that can be included in the standard document output.

A particularly great thing about this is that Metanorma will happily generate a NISO-STS XML version of the standard.

An initial use case is to apply this to IDO, which needs an update anyway.

I think this should be described in the document as a characteristic application of Elot.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions