GlossaristGlossarist

ISO 10241-1 Data Category Mapping

ISO 10241-1:2011 §5.3 Table 1 specifies the data categories of a standardized terminological entry. Glossarist’s model covers all mandatory and most optional categories. This page maps each ISO 10241-1 data category to its Glossarist field so standards adopters can build ISO 10241-compliant vocabularies directly.

Primary data categories (ISO 10241-1 §5.3 Table 1)

ISO 10241-1 data categoryMandatory?Repeatable?Glossarist fieldNotes
entry numbermandatorynon-repeatableManagedConcept.identifier (rendered as termid in YAML)Glossarist also accepts uri for URN-based identifiers
term (in order: preferred, admitted, deprecated)mandatoryrepeatableLocalizedConcept.designations[] with normative_status: preferred | admitted | deprecatedFive-half-high-dots slot holder (ISO 10241-1 §6.2) is not needed — Glossarist’s designation field is optional during draft
grammatical info (gender, number, part of speech)optionalrepeatable (per term)Designation.grammar.{gender, number, part_of_speech}Driven by ISO 12620 taxonomies in Glossarist
language code / script codeoptionalrepeatableLocalizedConcept.language (ISO 639-3) + LocalizedConcept.script (ISO 15924)The localizations map is keyed by language code
geographical useoptionalrepeatableDesignation.geographical_area (country code)
pronunciationoptionalrepeatableDesignation.pronunciationIPA notation expected
normative statusoptionalrepeatableDesignation.normative_statuspreferred | admitted | deprecated
letter symboloptional (mandatory if internationally standardized)repeatableDesignation with type: symbol and kind: letter_symbolSee Term Types for the full designation vocabulary
graphical symboloptional (mandatory if internationally standardized)repeatableDesignation with type: symbol and kind: graphical_symbol
definitionmandatory (unless non-verbal representation is used)non-repeatableLocalizedConcept.definition[] of DetailedDefinition objectsGlossarist permits multiple definitions per language (intensional + partitive + translated) — see Definitions
non-verbal representationmandatory if existsnon-repeatableLocalizedConcept.examples[] with type: figure or dedicated non_verbal_representations[]See Non-verbal Entities
exampleoptionalrepeatableLocalizedConcept.examples[]
note to entryoptionalrepeatableLocalizedConcept.notes[]Glossarist separates notes from annotations (editorial vs reader-facing)
note to termoptionalrepeatableLocalizedConcept.notes[] with kind: term
note to definitionoptionalrepeatableDetailedDefinition.notes[]
sourceoptionalrepeatableConceptSource on the relevant objectSee Sources for the model

Mandatory/optional summary

ISO 10241-1 mandates:

  1. Entry number → always present (Glossarist’s identifier)
  2. Term → at least one preferred term per language
  3. Definition → unless replaced by a non-verbal representation

Everything else is optional. Glossarist’s validators enforce the same three invariants at the schema level.

Entry organization (ISO 10241-1 §5.1)

ISO 10241-1 specifies three orders for terminological entries in a published standard:

OrderDescriptionGlossarist support
Systematic (preferred)Arranged according to the concept systemThe concept-browser renders datasets in concept-system order by default — see Concept System Types
MixedConcept-system-derived headings, language-specific withinThe domains field on ManagedConcept enables grouping; the browser can sort by domain
Language-specific (least preferred)Alphabetical or per-language conventionNot recommended; the browser can render this via tags filtering

For multilingual standards, ISO 10241-1 §5.1.4 requires the order within each subdivision to not be language-specific. Glossarist’s localization-keyed model (localizations: { eng: …, fra: … }) makes this natural — the same concept appears once with multiple language entries.

Information required for standards (ISO 10241-1 §5.2)

ISO 10241-1 §5.2 requires documentation of:

  • (a) Order of terminological entries — the dataset’s register.yaml declares this
  • (b) Method of accessing terminological data — concept-browser provides systematic, alphabetical, and search access
  • (c) Structuring and presentation rules — the schemas in /model/schemas/ are the authoritative source
  • (d) Grammatical information and variant forms — captured per designation via grammar and variant_of

TBX (ISO 30042) round-tripping

Glossarist’s data model maps cleanly to TBX (TermBase eXchange, ISO 30042). The concept-browser emits TBX for any dataset. The mapping is:

TBX elementGlossarist field
<termEntry>ManagedConcept
<descrip type="definition">LocalizedConcept.definition[].content
<descrip type="subjectField">ManagedConcept.domains
<term>Designation.designation
<termNote type="termType">Designation.term_type
<termNote type="partOfSpeech">Designation.grammar.part_of_speech
<admin type="source">ConceptSource
<admin type="entryStatus">LocalizedConcept.entry_status

For the full TBX emission reference, see the glossarist-ruby documentation.

Adopting ISO 10241-1 with Glossarist

A minimal ISO 10241-1-compliant terminological entry in Glossarist YAML:

termid: "3.1.1.1"
status: valid

localizations:
  eng:
    language: eng
    terms:
      - type: expression
        designation: entity
        normative_status: preferred
        grammar:
          part_of_speech: noun
    definition:
      - type: intensional
        content: "A concrete or abstract thing."
    sources:
      - type: authoritative
        origin: "ISO 19107:2003"

This satisfies all three ISO 10241-1 mandatory categories (entry number, term, definition) plus several optional ones (part of speech, source).

See also