Skip to content
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

Jump to bottom

minor proofreading edits, 11/07/2024 #516

Merged
merged 2 commits into from
Nov 8, 2024
Merged

minor proofreading edits, 11/07/2024 #516

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3fc4c4a
minor proofreading edits; extra example
dginev Nov 7, 2024
4196acd
avoid word change in this PR
dginev Nov 7, 2024
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
17 changes: 9 additions & 8 deletions src/intent.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ <h3 id="mixing_intent_grammar">The Grammar for <code class="attribue">intent</co

<dt><dfn id="intent_reference">reference</dfn></dt>
<dd>
An argument [=reference=] such as <code>$name</code> refers to a descendent element
An argument [=reference=] such as <code>$name</code> refers to a descendant element
that has an attribute <code>arg="name"</code>. Unlike <code class="attribute">id</code>
attributes, <code class="attribute">arg</code> do not have to be
unique within a document. When searching for a matching element the
Expand Down Expand Up @@ -305,7 +305,7 @@ <h3 id="mixing_intent_properties">Intent Properties</h3>
<section>
<h3 id="intent_using">Using Intent Concepts and Properties</h3>
<p>When the <code class="attribute">intent</code> attribute corresponding to a specific node
contains a concept component, the AT's [=Intent Concept Dictionary=] should be consulted.
contains a concept component, the supported [=Intent Concept Dictionary=] should be consulted.
dginev marked this conversation as resolved.
Show resolved Hide resolved
The concept name should be normalized
(<q>`_`</q> (U+00F5) and <q>`.`</q> (U+002E) to <q>`-`</q> (U+002D)),
and compared using <a data-cite="INFRA#ascii-case-insensitive">ASCII case-insensitive</a>
Expand All @@ -317,7 +317,7 @@ <h3 id="intent_using">Using Intent Concepts and Properties</h3>
when the normalized name, the fixity property, and the arity
all match an entry in the AT's concept dictionary.
The speech hint in the matching entry
can be used be used as a guide for the generation of
can be used as a guide for the generation of
specific audio, replacement text or braille renderings, as appropriate.
It can also help clarify argument order.
However, because common notations have many specialized ways of being spoken, the AT
Expand All @@ -338,8 +338,8 @@ <h3 id="intent_using">Using Intent Concepts and Properties</h3>
Even for an unsupported concept, if a fixity property and arguments were given,
the speech for the arguments should be composed
in a manner consistent with the given fixity property, if possible.</p>
<p>Note that future updates of the AT and its [=Intent Concept Dictionary=] may
add or remove concepts. Hence which concepts are supported may change with each update.</p>
<p>Note that future updates of an AT may add or remove concepts in its [=Intent Concept Dictionary=].
Hence which concepts are supported may change with each update.</p>

<p>In cases where the intent contains neither an explicit nor inferrable concept
the AT should generally read out the MathML in a literal or structural fashion,
Expand All @@ -355,7 +355,7 @@ <h3 id="intent_using">Using Intent Concepts and Properties</h3>
might read the table in a style more appropriate for a list of
equations. In both cases the navigation of the underlying table
structure can be supplied by the AT system, as it would for an
un-annotated table.</p>
unannotated table.</p>

<p>In general, depending upon the reader, AT may add words or sounds to make
the speech clearer to the listener. For example, for someone
Expand Down Expand Up @@ -383,13 +383,13 @@ <h4 id="mixing_intent_error_recovery">Intent Error Recovery</h4>
then the processor should act as if the attribute were not
present.
Typically this will result in a suitable fallback text being
generated from the MathML element and its descendents. Note that
generated from the MathML element and its descendants. Note that
just the erroneous attribute is ignored, other <code
class="attribute">intent</code> attributes in the MathML
expression should be used.</li>
<li>If a `reference` such as `$x` does not correspond to an <code
class="attribute">arg</code> attribute with value `x` on a
descendent element, the processor should act as if the reference
descendant element, the processor should act as if the reference
were replaced by the literal `_dollar_x`.</li>
</ol>
</section>
Expand Down Expand Up @@ -526,6 +526,7 @@ <h3 id="mixing_intent_examples">Intent Examples</h3>
&lt;mo arg="script">&#x2032;&lt;/mo>
&lt;/msup>
</pre>
<blockquote>x prime<br/>x superscript prime end superscript</blockquote>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should just have x prime (which I just checked also matched what mathcat does) I don't see how you can get x superscript prime as the intent masks the presentation so you are explicitly stoping the "superscript" being read (if you are using the intent at all) The system may of course have an option to read the underlying markup ignoring intent but that shouldn't be in this "intent examples" section.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, exactly, when the intent is used it is x prime. That's the starting fragment before the <br/>.

The second entry is the speech when intent isn't used - I copied it directly from the example right above, there are several that follow that pattern.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

they do? I'll look again when it's not midnight, as I say wasn't planning on rushing any edits:-)

</div>

<p>An overbar may represent complex conjugation, or mean (average), again with possible readings with and without <code class="attribute">intent</code>:</p>
Expand Down
Loading