Skip to content

Commit bb7b582

Browse files
u-fischerFrankMittelbachdavidcarlisle
authored
update prototype (#806)
* update prototype * Update documentation/prototype-usage-instructions.md Co-authored-by: David Carlisle <[email protected]> --------- Co-authored-by: Frank Mittelbach <[email protected]> Co-authored-by: David Carlisle <[email protected]>
1 parent 2c3fb89 commit bb7b582

File tree

1 file changed

+17
-16
lines changed

1 file changed

+17
-16
lines changed

documentation/prototype-usage-instructions.md

+17-16
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ runlatex.packageregex = [
2929

3030

3131

32-
# Using the LaTeX prototype for accessible PDF (as of 2024/11)
32+
# Using the LaTeX prototype for accessible PDF (as of 2025/02)
3333

3434
The new code can be used with pdfLaTeX or the Unicode engine
3535
luaLaTeX. The latter is the preferred engine recommended for new
@@ -51,12 +51,7 @@ list:
5151
pdfversion = 2.0,
5252
pdfstandard = ua-2,
5353
pdfstandard = a-4f, %or a-4
54-
testphase =
55-
{phase-III,
56-
title,
57-
table,
58-
math,
59-
firstaid}
54+
testphase = latest
6055
}
6156
\documentclass{article}
6257
\begin{document}
@@ -71,6 +66,11 @@ document should comply with.
7166
Tagging is then enabled by loading various modules through the
7267
`testphase` key.
7368

69+
- The `latest` key loads all modules that we think are sensible. This is the recommended
70+
value, it will load new modules automatically once they are added.
71+
72+
73+
It is possible to load only individual modules
7474
- The `phase-III` module activates tagging and loads support for most
7575
standard document elements like paragraphs, lists, sectioning, table
7676
of contents, graphics, floats, links and more. You should always use
@@ -80,7 +80,7 @@ Tagging is then enabled by loading various modules through the
8080
care that the title and author are added to the XMP metadata.
8181

8282
- The `table` module adds tagging support to tables like `tabular`,
83-
`tabularx`, `tabulary` and `longtable`.
83+
`tabularx`, `tabulary` and `longtable`.
8484
- The `math` module enables basic tagging of equations.
8585
- Finally, the `firstaid` contains small fixes of
8686
external packages to make them compatible with the tagging code, e.g.,
@@ -134,12 +134,12 @@ key as shown below.
134134

135135
At the moment this isn't transferred well by the derivation algorithm
136136
from PDF to HTML, but this area will see improvements. (The PDF structure
137-
is already correct, as one cane see in ngPDF, but the HTML/CSS
137+
is already correct, as one can see in ngPDF, but the HTML/CSS
138138
styling currently loses the grid layout.)
139139

140140
## Handling lists and other block structures
141141

142-
Most lists using standard LaTeX enviornmenst such as `enumerate` will
142+
Most lists using standard LaTeX environments such as `enumerate` will
143143
be tagged automatically. The new list implementation also implement an
144144
optional _key-value_ interface with similar features to the well known
145145
`enumitem` package, although with a different implementation.
@@ -149,7 +149,7 @@ optional _key-value_ interface with similar features to the well known
149149
150150
A list starting at 5
151151
152-
\begin{enumerate}[start=5]
152+
\begin{enumerate}[start=5]
153153
\item Level A1
154154
\begin{enumerate}
155155
\item Level B1
@@ -184,7 +184,7 @@ LuaLaTeX, but may also be provided by the author.
184184
Technically there are two methods of associating MathML with each
185185
formula:
186186

187-
* As an _associated file_ This is an embedded stream of XML within
187+
* As an _associated file_. This is an embedded stream of XML within
188188
the PDF that exactly matches the MathML that you would use in other
189189
contexts such as a web page.
190190
* Using MathML Namespace _Structure Element_ tagging. This is a
@@ -236,7 +236,8 @@ A matrix equation.
236236

237237
To use MathML Structure Element tagging you may use the
238238
`math/mathml/structelem` key as shown below. Here we also suppress
239-
adding the Associated Files.
239+
adding the Associated Files. With a current lualatex-dev the same can be achieved
240+
with the key `math/setup=mathml-SE`.
240241

241242
```
242243
\DocumentMetadata{uncompress,lang=en,
@@ -330,8 +331,8 @@ A matrix equation.
330331
\end{document}
331332
```
332333

333-
Here we supply an additional file with MathML versions of each formula.
334-
[pdflatexexample-mathml.html](pdflatexexample-mathml.html)
334+
Here we supply an additional file with MathML versions of each formula.
335+
[pdflatexexample-mathml.html](pdflatexexample-mathml.html)
335336
_View Source_ to see the MathML markup used.
336337

337338
**Note:** If the math in the above example is edited, the checksum will not match
@@ -427,4 +428,4 @@ provided by DANTE and Duallab respectively.
427428
Please do not over use the services, they aren't set up to process heavy loads
428429
but are intended just to run small examples in order to show how to use it on your local machine.</p>
429430

430-
</details>
431+
</details>

0 commit comments

Comments
 (0)