Support alt text in LaTeX output

Charles Staats <[email protected]> Thu, 23 Jul 2026 11:07:25 -0600
Newsgroups gmane.comp.tex.texinfo.bugs
Message-ID <CAP-6jhFh+=w_6MpMBnCN2VQKGRVjmu0cnKzXetxoaxxrOCNBgg@mail.gmail.com>
--000000000000fe56d606574a4a57
Content-Type: text/plain; charset="UTF-8"

Hello,

Currently, `texi2any --latex` appears to discard any alt text tag, see
https://github.com/latex3/tagging-project/issues/1491#issuecomment-5061006949.
Would it be possible to change this?

Ideally, there would be some sort of flag like `--accessible` or
`--latex-tagging` that could be passed to the texi2any script that would
cause certain changes to the TeX and pdf output, such as the following:

* Forward any alt text to the `\includegraphics` commands.
* Insert a `\DocumentMetadata` command (with appropriate settings) at the
beginning of the document.
* (For pdf output) compile with lualatex instead of pdflatex.
* Ideally, we would also have "actual" and "artifact" tags as well. If I
understand correctly, the "actual=<stuff>" tag indicates to screenreaders
that the image should be treated as if it were the text "<stuff>"; the
"artifact" tag tells the screenreader to ignore the image altogether (used,
e.g., for logos). All of these tags are supported by `\includegraphics`,
although I don't know what version is needed.

There may be other changes needed, as discussed in the issue linked above.
(Note: Some of these may be better dealt with on the TeX side rather than
the texinfo side.)

Best,

Charles Staats

--000000000000fe56d606574a4a57
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Hello,<div><br></div><div>Currently, `texi2any --latex` ap=
pears to discard any alt text tag, see=C2=A0<a href=3D"https://github.com/l=
atex3/tagging-project/issues/1491#issuecomment-5061006949">https://github.c=
om/latex3/tagging-project/issues/1491#issuecomment-5061006949</a>. Would it=
 be possible to change this?</div><div><br></div><div>Ideally, there would =
be some sort of flag like `--accessible` or `--latex-tagging` that could be=
 passed to the texi2any script that would cause certain changes to the TeX =
and pdf output, such as the following:</div><div><br></div><div>* Forward a=
ny alt text to the `\includegraphics` commands.</div><div>* Insert a `\Docu=
mentMetadata` command (with appropriate settings) at the beginning of the d=
ocument.</div><div>* (For pdf output) compile with lualatex instead of pdfl=
atex.</div><div>* Ideally, we would also have &quot;actual&quot; and &quot;=
artifact&quot; tags as well. If I understand correctly, the &quot;actual=3D=
&lt;stuff&gt;&quot; tag indicates to screenreaders that the image should be=
 treated as if it were the text &quot;&lt;stuff&gt;&quot;; the &quot;artifa=
ct&quot; tag tells the screenreader=C2=A0to ignore the image altogether (us=
ed, e.g., for logos). All of these tags are supported by `\includegraphics`=
, although I don&#39;t know what version is needed.</div><div><br></div><di=
v>There may be other changes needed, as discussed in the issue linked above=
. (Note: Some of these may be better dealt with on the TeX side rather than=
 the texinfo side.)</div><div><br></div><div>Best,</div><div><br></div><div=
>Charles Staats</div></div>

--000000000000fe56d606574a4a57--