Skip to content

Commit 02e39d8

Browse files
Reference to EPUB guidelines
#49
1 parent 291b866 commit 02e39d8

File tree

1 file changed

+14
-11
lines changed

1 file changed

+14
-11
lines changed

Guidelines/Nordic MathML Guidelines 2024-1.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -954,26 +954,29 @@ Example of the rendering and mark up of equation solving with commentary text:
954954

955955
### When to use images of mathematical content
956956

957-
**Open questions**: Is this optional for the ordering agencies? Which parts are optional? Shoud we just reference EPUB guidelines, or leave it ambigious?
958-
959957
There are cases when all of the mathematical content can't be captured with just MathML. Example of such notation in a study book that can't be replicated with just MathML:
960958

961959
![6 by 3 matrix with a arrow on the bottom of it pointing to the first column of the matrix with the text 'Left most nonzero column'.](images/matrix-with-notation-below.png)
962960

963-
Here the arrow and text pointing to the first column can't be replicated. In these cases capture the mathematical content as an image and markup an image description below it. Capture the matrix in MathML inside the image description and extract the text.
961+
Here the arrow and text pointing to the first column can't be replicated. In these cases capture the mathematical content as an image and markup as an image description below it. Capture the matrix in MathML inside the image description and extract the text.
962+
963+
Use the markup that is specified in the [Nordic Guidelines for Production of Accessible EPUB 3 section "text extraction from images"](https://github.com/nlbdev/nordic-accessible-epub-guidelines/blob/main/guidelines/guidelines.md#text-extraction-from-images).
964964

965-
Example markup:
965+
Example markup based on this:
966966

967967
```html
968-
<img src="..." alt="..." />
969-
<p>Image description.
970-
<math>...</math>
971-
</p>
972-
<p>Leftmost nonzero columns.</p>
968+
<figure class="image">
969+
<img src="images/X41001A-011.jpg" alt="equation" aria-describedby="desc011" />
970+
<aside class="fig-desc" id="desc011">
971+
<p>
972+
<math>...</math>
973+
</p>
974+
<p>Leftmost nonzero columns.</p>
975+
</aside>
976+
</figure>
973977
```
974978

975-
Follow the Ordering agency's markup for image descriptions. The above is just an example.
976-
979+
**Note** that the `alt` attribute has the value `equation`.
977980

978981
### Chemistry {#chemistry-in-mathml}
979982
<!-- I'm doing this ID thing wrong, aren't I? /Tim -->

0 commit comments

Comments
 (0)