Skip to content

add literal property #87

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 26, 2025
Merged

add literal property #87

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d3dcb9a
add literal property
davidcarlisle Mar 25, 2025
d059c97
spelling
davidcarlisle Mar 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion _data/core-properties.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@

Check warning on line 1 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

1:1 [empty-lines] too many blank lines (1 > 0)
- property: function
type: fixity
applicability: intent function head
Expand Down Expand Up @@ -51,7 +51,7 @@
en: "x y"



Check warning on line 54 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

54:1 [empty-lines] too many blank lines (3 > 2)
- property: literal
type: inference
applicability: all presentation elements
Expand All @@ -68,7 +68,17 @@
Assistive technology should use the specified `common` defaults.
See [common property](../literal-common-properties#common-property)


- property: legacy
type: inference
applicability: all presentation elements
effect: |
Assistive technology should use its system specified defaults.
This is the default behavior if neither the
[literal property](../literal-common-properties#literal-property)
nor
[common property](../literal-common-properties#common-property)
is in effect.
See [legacy property](../literal-common-properties#legacy-property)

- property: array
type: table
Expand Down Expand Up @@ -135,7 +145,7 @@
applicability: mtable
effect: "the table should be read in a style suitable for displayed equations (and inequations)"
examples:
- mathml: |

Check warning on line 148 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

148:4 [indentation] wrong indentation: expected 4 but found 3
<mtable intent=':system-of-equations'>
<mtr>
<mtd columnalign='right'>
Expand Down Expand Up @@ -255,7 +265,7 @@
en: the sum from 0 to n of i squared



Check warning on line 268 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

268:1 [empty-lines] too many blank lines (3 > 2)
- property: unit
type: units-and-currency
applicability: mi
Expand All @@ -265,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."

Check warning on line 278 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

278:3 [indentation] wrong indentation: expected 4 but found 2

- property: currency
type: units-and-currency
Expand Down Expand Up @@ -328,7 +338,7 @@
type: chemistry
effect: read the term as a chemical equation
examples:
- mathml: |

Check warning on line 341 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

341:4 [indentation] wrong indentation: expected 4 but found 3
<mrow intent=':chemical-equation'>
<mrow intent=':chemical-equation'>
<mn>2</mn>
Expand Down Expand Up @@ -365,7 +375,7 @@
en: '2, cap h, sub 2; cap o; reacts to form; 2 cap h, sub 2; plus cap o, sub 2'



Check warning on line 378 in _data/core-properties.yml

View workflow job for this annotation

GitHub Actions / validate-yaml-core-properties-concept-list 

378:1 [empty-lines] too many blank lines (3 > 2)
- property: pause-short
type: pause
applicability: all
Expand Down
9 changes: 9 additions & 0 deletions literal-common-properties.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,10 @@ The exact words may depend upon both the audience and the children of node. Some

For someone who is blind, it may be important to indicate the start and end of fractions, roots, etc., but for someone with dyslexia, the extra words might be "verbal noise."

If neither `:literal` nor `:common` property is in scope, the default
behavior, which may be explicitly specified by using the `:legacy`
property, is system dependent.


## `literal` property

Expand Down Expand Up @@ -130,3 +134,8 @@ As noted above, a trig function raised to a "-1" power should have special speec
These are spoken in a special way, although maybe that is just the default way to speak those Unicode characters.

However, adding subscripts and superscripts of various types (e.g., $\mathbb {Z}^2$, $\mathbb {Z}^+$, and $\mathbb {Z}_2$) often have specialized speech such as "Z 2".


## `legacy` property

The behavior of readings when the `:legacy` property is in effect is system dependent. Links to documentation of some known systems may be added here as the information becomes available.