use-argname property

_data/core-properties.yml

@@ -1,4 +1,4 @@
 
 - property: function
   type: fixity
   applicability: intent function head
@@ -51,7 +51,7 @@
       en: "x y"
 
 
 
 - property: literal
   type: inference
   applicability: all presentation elements
@@ -145,7 +145,7 @@
   applicability: mtable
   effect: "the table should be read in a style suitable for displayed equations (and inequations)"
   examples:
    - mathml: |
       <mtable intent=':system-of-equations'>
         <mtr>
          <mtd columnalign='right'>
@@ -265,7 +265,7 @@
       en: the sum from 0 to n of i squared
 
 
 
 - property: unit
   type: units-and-currency
   applicability: mi
@@ -275,7 +275,7 @@
     - mathml: "<mrow><mn>2</mn><mi mathvariant='normal' intent=':unit'>Ω</mi></mrow>"
       en: 2 ohms
   comment:
   - "This includes SI units, English units, etc. It also includes radians, degrees, etc."
 
 - property: currency
   type: units-and-currency
@@ -338,7 +338,7 @@
   type: chemistry
   effect: read the term as a chemical equation
   examples:
    - mathml: |
       <mrow intent=':chemical-equation'>
        <mrow intent=':chemical-equation'>
         <mn>2</mn>
@@ -375,7 +375,7 @@
      en: '2,  cap h, sub 2;  cap o; reacts to form; 2  cap h, sub 2; plus  cap o, sub 2'
 
 
 
 - property: pause-short
   type: pause
   applicability: all
@@ -425,3 +425,30 @@
   examples:
     - mathml: '<math><mi>a</mi><mspace intent=":pause-xlong" width="4cm"/><mi>b</mi></math>'
       en: "a [pause....] b"
+
+- property: use-argname
+  type: argname
+  applicability: all
+  effect: "Used as a _self-property_ on an element with `arg`, causes the value of the `arg` attribute to be spoken by AT when the user moves to that child. For core concepts, this value should override argument names that would otherwise be used by AT.
+           May be translated to the current language, or used literally if translation is not known."
+  examples:
+     - mathml: '<mi arg="numerator" intent=":use-argname">x</mi>'
+       en: numerator
+       fr: numérateur
+       de: Zähler
+     - mathml: '<mi arg="denominator" intent=":use-argname">x</mi>'
+       en: denominator
+       fr: dénominateur
+       de: Nenner
+     - mathml: '<mn arg="base" intent=":use-argname">2</mn>'
+       en: base
+       fr: base
+       de: Basis
+     - mathml: '<mrow arg="lower-limit" intent=":use-argname"><mi>i</mi><mo>=</mo><mn>0</mn></mrow>'
+       en: lower-limit
+       fr: "limite à gauche"
+       de: Untergrenze
+     - mathml: '<mi arg="upper-limit" intent=":use-argname">n</mi>'
+       en: upper-limit
+       fr: "limite à droite"
+       de: Obergrenze