New <termentry> Topic

<glossentry> Topic

Built for glossaries, not for terminology databases.

  • Not meant to be multilingual.
  • No elements for terminology metadata.
  • Attribute standards are missing, e.g. <glossStatus> @value has no values defined
<glossentry id="usbfd">
  <glossterm>USB flash drive</glossterm>
  <glossdef>A small portable drive.</glossdef>
  <glossBody>
    <glossPartOfSpeech value="noun"/>
    <glossUsage>
      Do not provide in upper case (as in "USB Flash Drive") 
      because that suggests a trademark.
    </glossUsage>
    <glossAlt>
      <glossAcronym>UFD</glossAcronym>
      <glossUsage>Explain the acronym on first occurrence.</glossUsage>
    </glossAlt>
    <glossAlt id="memoryStick">
      <glossSynonym>memory stick</glossSynonym>
      <glossUsage>This is a colloquial term.</glossUsage>
    </glossAlt>
    <glossAlt>
      <glossAbbreviation>stick</glossAbbreviation>
      <glossStatus value="prohibited"/>
      <glossUsage>This is too colloquial.</glossUsage>
      <glossAlternateFor href="#usbfd/memoryStick"/>
    </glossAlt>
    <glossAlt>
      <glossAbbreviation>flash</glossAbbreviation>
      <glossStatus value="prohibited"/>
      <glossUsage>This short form is ambiguous.</glossUsage>
    </glossAlt>
  </glossBody>
</glossentry>

<termentry> Topic

  • Multiple languages in one topic
  • Compatible to DITA-OT processing.
  • Total control of element names and structures
  • Easier to create XSL transformations, Schematron Termchecker and Termbrowser and <oXygen/> XML author frameworks that do not interfere with the standard DITA frameworks
  • Strict element and attribute structures simplify UX focussed development
  • Content can still be shared between a <glossentry> based glossary (e.g. for the end user) and the <termentry> based terminology base, e.g. by <ph> (e.g. for internal terms)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE termentry PUBLIC "-//DOCTALES//DTD DITA DOCTALES Termentry//EN" "termentry.dtd">
<termentry id="truck">
  <title>Truck</title>
  <definition>
    <definitionText>A truck is a motor vehicle designed to transport cargo.</definitionText>
    <definitionSource>
      <sourceReference href="https://en.wikipedia.org/wiki/Truck" 
        format="html" scope="external">
        Wikipedia
      </sourceReference>
    </definitionSource>
  </definition>
  <termBody>
    <agreedWith>
      <termCommitteeMember>Heinrich Müller</termCommitteeMember>
      <termCommitteeMember>Günther Schmidt</termCommitteeMember>
    </agreedWith>
    <fullForm language="de-DE" usage="preferred">
      <termVariant>Lastkraftwagen</termVariant>
    </fullForm>
    <acronym language="de-DE" usage="preferred">
      <termVariant>LKW</termVariant>
    </acronym>
    <fullForm language="en-US" usage="preferred">
      <termVariant>truck</termVariant>
    </fullForm>
    <fullForm language="en-GB" usage="preferred">
      <termVariant>lorry</termVariant>
    </fullForm>
    <fullForm language="en-GB" usage="notRecommended">
      <termVariant>truck</termVariant>
    </fullForm>
  </termBody>
  <relations>
    <relatedTerms>
      <relatedTerm keyref="car"/>
    </relatedTerms>
  </relations>
</termentry>