Extended math options for luamml (#1511)

* start documentation for math options * review math option, WIP * move luamml loading, trim spacing * start with examples * add option for structelem * correct test * correct alt attribute if luamml is not used * more docu * rename plug * adapt key for luamml writing * more examples * enable alt for ua-1, docu, typo * update test * update test (alt + attribute change) * more doku and a bit support for ignore flag * clean up examples * add jobname to title, tlg * note about tests * change version, add changes.txt * test with newest luamml * add version test * add test files * comments from review
latex3 · Oct 29, 2024 · c10a4a3 · c10a4a3
1 parent b1e172c
commit c10a4a3
Show file tree

Hide file tree

Showing 55 changed files with 3,710 additions and 712 deletions.
diff --git a/required/latex-lab/changes.txt b/required/latex-lab/changes.txt
@@ -1,3 +1,8 @@
+2024-10-25 Ulrike Fischer <Ulrike.Fischer@latex-project.org>
+	* latex-lab-math.dtx: reorganized luamml and mathml options
+	to support also structure elements and extended the documentation. Corrected 
+	handling of alt-texts. Added examples for the various options.
+
 2024-10-16 Ulrike Fischer <Ulrike.Fischer@latex-project.org>
 	* latex-lab-firstaid.dtx: correct amsthm firstaid (tagging/733),
 	remove now unneeded code for cleveref.

diff --git a/required/latex-lab/config-math-tagging-examples.lua b/required/latex-lab/config-math-tagging-examples.lua
@@ -0,0 +1,10 @@
+-- Tests for math tagging examples
+
+stdengine    = "luatex"
+checkengines = {"luatex"}
+checksearch  = true
+testfiledir  = "math-tagging-examples"
+
+checkruns     = 2
+
+recordstatus=true
diff --git a/required/latex-lab/latex-lab-math.dtx b/required/latex-lab/latex-lab-math.dtx
diff --git a/required/latex-lab/math-tagging-examples/math-17-alt+mathmlAF+texAF.lvt b/required/latex-lab/math-tagging-examples/math-17-alt+mathmlAF+texAF.lvt
@@ -0,0 +1,56 @@
+% template for math reading. 
+\DocumentMetadata
+ {
+  uncompress,testphase={phase-III,title,math},
+  pdfversion=1.7,
+  pdfstandard=ua-1
+  %pdfversion=2.0,
+  %pdfstandard=ua-2
+ }
+
+
+\documentclass{article}
+\makeatletter
+\ExplSyntaxOn
+\tl_put_right:Nn\cdp@list{\cdp@elt {TU}{lmr}{m}{n}} 
+\ExplSyntaxOff
+\makeatother
+
+\usepackage{unicode-math}
+
+\title{Test math tagging \jobname}
+
+% global setups
+% rolemap mathml to Span default false  (probably senseless)
+%\tagpdfsetup{role/mathml-tags}  
+
+% suppress loading of luamml
+%\tagpdfsetup{math/mathml/luamml/load=false} %
+
+% suppress writing of luamml-mathml
+%\tagpdfsetup{math/mathml/luamml/write=false} %
+
+% suppress mathml-AF reading
+%\tagpdfsetup{math/mathml/sources=} %
+
+% enable structure elements
+%\tagpdfsetup{math/mathml/structelem} %
+
+\begin{document}
+% local settings. Can also be in the preamble but used here for clarity
+
+% alt text, default currently false if not ua-1
+%\tagpdfsetup{math/alt/use = true}      
+
+% suppress tex source AF
+% \tagpdfsetup{math/tex/AF=false} 
+
+% suppress attaching of mathml-AF (local setting) 
+% \tagpdfsetup{math/mathml/AF=false}
+
+inline $E=mc^2$
+
+display
+\[a^2+b^2=c^2\]
+
+\end{document}
diff --git a/required/latex-lab/math-tagging-examples/math-17-alt+mathmlAF+texAF.tlg b/required/latex-lab/math-tagging-examples/math-17-alt+mathmlAF+texAF.tlg
@@ -0,0 +1,3 @@
+***************
+Compilation 1 of test file completed with exit status 0
+Compilation 2 of test file completed with exit status 0
diff --git a/required/latex-lab/math-tagging-examples/math-17-alt+structelem+rolemap+mathmlAF+texAF.lvt b/required/latex-lab/math-tagging-examples/math-17-alt+structelem+rolemap+mathmlAF+texAF.lvt
@@ -0,0 +1,57 @@
+% template for math reading. 
+
+\DocumentMetadata
+ {
+  uncompress,testphase={phase-III,title,math},
+  pdfversion=1.7,
+  pdfstandard=ua-1
+  %pdfversion=2.0,
+  %pdfstandard=ua-2
+ }
+
+\documentclass{article}
+\makeatletter
+\ExplSyntaxOn
+\tl_put_right:Nn\cdp@list{\cdp@elt {TU}{lmr}{m}{n}} 
+\ExplSyntaxOff
+\makeatother
+
+\usepackage{unicode-math}
+
+\title{Test math tagging \jobname}
+
+% global setups
+% rolemap mathml to Span default false  (probably senseless)
+\tagpdfsetup{role/mathml-tags}  
+
+% suppress loading of luamml
+%\tagpdfsetup{math/mathml/luamml/load=false} %
+
+% suppress writing of luamml-mathml
+%\tagpdfsetup{math/mathml/luamml/write=false} %
+
+% suppress mathml-AF inclusion
+%\tagpdfsetup{math/mathml/sources=} %
+
+% enable structure elements
+\tagpdfsetup{math/mathml/structelem} %
+
+\begin{document}
+
+% local settings. Can also be in the preamble but used here for clarity
+
+% alt text, default currently false if not ua-1
+% \tagpdfsetup{math/alt/use = true}      
+
+% suppress tex source AF
+% \tagpdfsetup{math/tex/AF=false} 
+
+% suppress attaching of mathml-AF (local setting) 
+% \tagpdfsetup{math/mathml/AF=false}
+
+inline $E=mc^2$
+
+display
+\[a^2+b^2=c^2\]
+
+\end{document}
diff --git a/required/latex-lab/math-tagging-examples/math-17-alt+structelem+rolemap+mathmlAF+texAF.tlg b/required/latex-lab/math-tagging-examples/math-17-alt+structelem+rolemap+mathmlAF+texAF.tlg
@@ -0,0 +1,3 @@
+***************
+Compilation 1 of test file completed with exit status 0
+Compilation 2 of test file completed with exit status 0
diff --git a/required/latex-lab/math-tagging-examples/math-17-alt-noluamml.lvt b/required/latex-lab/math-tagging-examples/math-17-alt-noluamml.lvt
@@ -0,0 +1,56 @@
+% template for math reading. 
+\DocumentMetadata
+ {
+  uncompress,testphase={phase-III,title,math},
+  pdfversion=1.7,
+  pdfstandard=ua-1
+  %pdfversion=2.0,
+  %pdfstandard=ua-2
+ }
+
+
+\documentclass{article}
+\makeatletter
+\ExplSyntaxOn
+\tl_put_right:Nn\cdp@list{\cdp@elt {TU}{lmr}{m}{n}} 
+\ExplSyntaxOff
+\makeatother
+
+\usepackage{unicode-math}
+
+\title{Test math tagging \jobname}
+
+% global setups
+% rolemap mathml to Span default false  (probably senseless)
+\tagpdfsetup{role/mathml-tags}  
+
+% suppress loading of luamml
+\tagpdfsetup{math/mathml/luamml/load=false} %
+
+% suppress writing of luamml-mathml
+%\tagpdfsetup{math/mathml/luamml/write=false} %
+
+% suppress mathml-AF reading
+\tagpdfsetup{math/mathml/sources=} %
+
+% enable structure elements
+%\tagpdfsetup{math/mathml/structelem} %
+
+\begin{document}
+% local settings. Can also be in the preamble but used here for clarity
+
+% alt text, default currently false if not ua-1
+%\tagpdfsetup{math/alt/use = true}      
+
+% suppress tex source AF
+\tagpdfsetup{math/tex/AF=false} 
+
+% suppress attaching of mathml-AF (local setting) 
+% \tagpdfsetup{math/mathml/AF=false}
+
+inline $E=mc^2$
+
+display
+\[a^2+b^2=c^2\]
+
+\end{document}
diff --git a/required/latex-lab/math-tagging-examples/math-17-alt-noluamml.tlg b/required/latex-lab/math-tagging-examples/math-17-alt-noluamml.tlg
@@ -0,0 +1,3 @@
+***************
+Compilation 1 of test file completed with exit status 0
+Compilation 2 of test file completed with exit status 0
diff --git a/required/latex-lab/math-tagging-examples/math-17-default.lvt b/required/latex-lab/math-tagging-examples/math-17-default.lvt
@@ -0,0 +1,56 @@
+% template for math reading. 
+
+\DocumentMetadata
+ {
+  uncompress,testphase={phase-III,title,math},
+  pdfversion=1.7,
+  pdfstandard=ua-1
+  %pdfversion=2.0,
+  %pdfstandard=ua-2
+ }
+
+\documentclass{article}
+\makeatletter
+\ExplSyntaxOn
+\tl_put_right:Nn\cdp@list{\cdp@elt {TU}{lmr}{m}{n}} 
+\ExplSyntaxOff
+\makeatother
+
+\usepackage{unicode-math}
+
+\title{Test math tagging \jobname}
+
+% global setups
+% rolemap mathml to Span default false  (probably senseless)
+%\tagpdfsetup{role/mathml-tags}  
+
+% suppress loading of luamml
+%\tagpdfsetup{math/mathml/luamml/load=false} %
+
+% suppress writing of luamml-mathml
+%\tagpdfsetup{math/mathml/luamml/write=false} %
+
+% suppress mathml-AF reading
+%\tagpdfsetup{math/mathml/sources=} %
+
+% enable structure elements
+%\tagpdfsetup{math/mathml/structelem} %
+
+\begin{document}
+% local settings. Can also be in the preamble but used here for clarity
+
+% alt text, default currently false if not ua-1
+% \tagpdfsetup{math/alt/use = true}      
+
+% suppress tex source AF
+% \tagpdfsetup{math/tex/AF=false} 
+
+% suppress attaching of mathml-AF (local setting) 
+% \tagpdfsetup{math/mathml/AF=false}
+
+inline $E=mc^2$
+
+display
+\[a^2+b^2=c^2\]
+
+\end{document}
diff --git a/required/latex-lab/math-tagging-examples/math-17-default.tlg b/required/latex-lab/math-tagging-examples/math-17-default.tlg
@@ -0,0 +1,3 @@
+***************
+Compilation 1 of test file completed with exit status 0
+Compilation 2 of test file completed with exit status 0
diff --git a/required/latex-lab/math-tagging-examples/math-20-alt+structelem+mathmlAF+texAF.lvt b/required/latex-lab/math-tagging-examples/math-20-alt+structelem+mathmlAF+texAF.lvt
@@ -0,0 +1,57 @@
+% template for math reading. 
+
+\DocumentMetadata
+ {
+  uncompress,testphase={phase-III,title,math},
+  %pdfversion=1.7,
+  %pdfstandard=ua-1
+  pdfversion=2.0,
+  pdfstandard=ua-2
+ }
+
+\documentclass{article}
+\makeatletter
+\ExplSyntaxOn
+\tl_put_right:Nn\cdp@list{\cdp@elt {TU}{lmr}{m}{n}} 
+\ExplSyntaxOff
+\makeatother
+
+\usepackage{unicode-math}
+
+\title{Test math tagging \jobname}
+
+% global setups
+% rolemap mathml to Span default false  (probably senseless)
+%\tagpdfsetup{role/mathml-tags}  
+
+% suppress loading of luamml
+%\tagpdfsetup{math/mathml/luamml/load=false} %
+
+% suppress writing of luamml-mathml
+%\tagpdfsetup{math/mathml/luamml/write=false} %
+
+% suppress mathml-AF inclusion
+%\tagpdfsetup{math/mathml/sources=} %
+
+% enable structure elements
+\tagpdfsetup{math/mathml/structelem} %
+
+\begin{document}
+
+% local settings. Can also be in the preamble but used here for clarity
+
+% alt text, default currently false if not ua-1
+\tagpdfsetup{math/alt/use = true}      
+
+% suppress tex source AF
+% \tagpdfsetup{math/tex/AF=false} 
+
+% suppress attaching of mathml-AF (local setting) 
+% \tagpdfsetup{math/mathml/AF=false}
+
+inline $E=mc^2$
+
+display
+\[a^2+b^2=c^2\]
+
+\end{document}
diff --git a/required/latex-lab/math-tagging-examples/math-20-alt+structelem+mathmlAF+texAF.tlg b/required/latex-lab/math-tagging-examples/math-20-alt+structelem+mathmlAF+texAF.tlg
@@ -0,0 +1,3 @@
+***************
+Compilation 1 of test file completed with exit status 0
+Compilation 2 of test file completed with exit status 0
diff --git a/required/latex-lab/math-tagging-examples/math-20-alt-noluamml.lvt b/required/latex-lab/math-tagging-examples/math-20-alt-noluamml.lvt
@@ -0,0 +1,57 @@
+% template for math reading. 
+
+\DocumentMetadata
+ {
+  uncompress,testphase={phase-III,title,math},
+  %pdfversion=1.7,
+  %pdfstandard=ua-1
+  pdfversion=2.0,
+  pdfstandard=ua-2
+ }
+
+
+\documentclass{article}
+\makeatletter
+\ExplSyntaxOn
+\tl_put_right:Nn\cdp@list{\cdp@elt {TU}{lmr}{m}{n}} 
+\ExplSyntaxOff
+\makeatother
+
+\usepackage{unicode-math}
+
+\title{Test math tagging \jobname}
+
+% global setups
+% rolemap mathml to Span default false  (probably senseless)
+%\tagpdfsetup{role/mathml-tags}  
+
+% suppress loading of luamml
+\tagpdfsetup{math/mathml/luamml/load=false} %
+
+% suppress writing of luamml-mathml
+%\tagpdfsetup{math/mathml/luamml/write=false} %
+
+% suppress mathml-AF reading
+\tagpdfsetup{math/mathml/sources=} %
+
+% enable structure elements
+%\tagpdfsetup{math/mathml/structelem} %
+
+\begin{document}
+% local settings. Can also be in the preamble but used here for clarity
+
+% alt text, default currently false if not ua-1
+\tagpdfsetup{math/alt/use = true}      
+
+% suppress tex source AF
+\tagpdfsetup{math/tex/AF=false} 
+
+% suppress attaching of mathml-AF (local setting) 
+% \tagpdfsetup{math/mathml/AF=false}
+
+inline $E=mc^2$
+
+display
+\[a^2+b^2=c^2\]
+
+\end{document}
diff --git a/required/latex-lab/math-tagging-examples/math-20-alt-noluamml.tlg b/required/latex-lab/math-tagging-examples/math-20-alt-noluamml.tlg
@@ -0,0 +1,3 @@
+***************
+Compilation 1 of test file completed with exit status 0
+Compilation 2 of test file completed with exit status 0