From f963592a5cad6f4daad7603c236b0d7d4a526b12 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 25 Jan 2022 17:27:53 +0000 Subject: alt text for all images, for minimal VPAT compliance git-svn-id: svn://tug.org/texlive/trunk@61734 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/texlive/texlive-en/ChangeLog | 14 ++++++++++ Master/texmf-dist/doc/texlive/texlive-en/Makefile | 26 +++++++++++------- .../texmf-dist/doc/texlive/texlive-en/live4ht.cfg | 7 +---- .../texmf-dist/doc/texlive/texlive-en/tex-live.sty | 13 ++++----- .../doc/texlive/texlive-en/texlive-en.tex | 31 +++++++++++++--------- 5 files changed, 57 insertions(+), 34 deletions(-) create mode 100644 Master/texmf-dist/doc/texlive/texlive-en/ChangeLog (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/texlive/texlive-en/ChangeLog b/Master/texmf-dist/doc/texlive/texlive-en/ChangeLog new file mode 100644 index 00000000000..2b6fecedbc2 --- /dev/null +++ b/Master/texmf-dist/doc/texlive/texlive-en/ChangeLog @@ -0,0 +1,14 @@ +2022-01-25 Karl Berry + + * tex-live.sty (\tlpng): require new third argument for alt text. + * texlive-en.tex: change all \tlpng calls. + * live4ht.cfg (graphics*): remove \Configure, redundant with + \tlpng macro now. + + * Makefile (env): texlive-en before texlive-common, + for sake of example. + (run_htlatex, htopts1, htopts2): new variables to separate out the + htlatex invocation. + (html1 h): new targets to just run htlatex once. + +(Public domain.) diff --git a/Master/texmf-dist/doc/texlive/texlive-en/Makefile b/Master/texmf-dist/doc/texlive/texlive-en/Makefile index 1ec27126f48..ae145d67565 100644 --- a/Master/texmf-dist/doc/texlive/texlive-en/Makefile +++ b/Master/texmf-dist/doc/texlive/texlive-en/Makefile @@ -5,7 +5,7 @@ doc = texlive-en all: pdf html tlpre = # possible prefix to run from the pretest -env = TEXINPUTS=.:../texlive-common:../texlive-en:; export TEXINPUTS; $(tlpre) +env = TEXINPUTS=.:../texlive-en:../texlive-common:; export TEXINPUTS; $(tlpre) pdflatex_opts = --file-line-error pdflatex = pdflatex $(pdflatex_opts) '\nonstopmode\def\Status{1}\input $(doc)' @@ -30,8 +30,9 @@ pdf: $(env) $(texfot_pdf) $(pdflatex) $(env) $(texfot_pdf) $(pdflatex) -# It is better to use htlatex than the individual runs since then we can -# easily specify these options; \Preamble in live4ht.cfg is not equivalent. +# It is best to use the htlatex wrapper since then we can easily specify +# these options; using \Preamble in live4ht.cfg is not equivalent. +# # The options here: # live4ht - reads our live4ht.cfg. # info - extra debugging info. @@ -40,13 +41,16 @@ pdf: # charset - UTF-8 is more likely to work well than Latin 1. # fn-in - keep footnotes in the main output file. # -# The other option, -cunihtf -utf8, goes along with the charset and -# tells tex4ht to look for Unicode font encodings. See https://tug.org/tex4ht. -html h: +# The other argument, where we pass, -cunihtf -utf8, goes along with the +# charset and tells tex4ht to look for Unicode font encodings. See +# https://tug.org/tex4ht. +# +htopts1 = "live4ht,info,xhtml,html5,charset=utf-8,fn-in" +htopts2 = " -cunihtf -utf8" +run_htlatex = $(env) $(texfot_html) htlatex $(doc) $(htopts1) $(htopts2) \Hnewline \Hnewline }} -% use png graphics as-is -\Configure{graphics*} - {png} - {\Needs{""}% - \Picture[pict]{../texlive-common/\csname Gin@base\endcsname.png}% - } + % or LaTeX complains it is missing. \begin{document} diff --git a/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty b/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty index cd4da00ee60..a832ec21e8c 100644 --- a/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty +++ b/Master/texmf-dist/doc/texlive/texlive-en/tex-live.sty @@ -217,12 +217,13 @@ \providecommand*{\web}{\texttt{WEB}\xspace} % Include a png image. -% #1 - name of image file in ../texlive-common/, always .png +% #1 - basename of image file in ../texlive-common/, always .png % #2 - width for TeX -% -\def\tlpng#1#2{% - \ifnum \Status=2 % html, want relative path in output - \includegraphics{../texlive-common/#1.png}% +% #3 - alt text for image; used only in html +\def\tlpng#1#2#3{% + \ifnum \Status=2 % html, have to have explicit relative path in output + \includegraphics[alt={#3}]{../texlive-common/#1.png}% + % % We intentionally are not specifying the size, so that the natural % size of the graphic is used in the HTML output. Thus we do not % get a graphics.sty warning about "cannot determine size of graphic @@ -294,7 +295,7 @@ \else \providecommand{\Status}{2}% running TeX4ht \fi -%\typeout{Status is \Status} +#\typeout{Status is \Status} % \newif\ifSingleColumn % diff --git a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex index 749e55fe3f6..97ac690aae4 100644 --- a/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex +++ b/Master/texmf-dist/doc/texlive/texlive-en/texlive-en.tex @@ -491,8 +491,9 @@ Internet, please see section~\ref{sec:dvd-install-net-updates}. \end{description} \begin{figure}[tb] -\tlpng{nsis_installer}{.6\linewidth} -\caption{First stage of Windows \code{.exe} installer}\label{fig:nsis} +\def\figdesc{First stage of Windows \code{.exe} installer} +\tlpng{nsis_installer}{.6\linewidth}{\figdesc} +\caption{\figdesc}\label{fig:nsis} \end{figure} The same installer program is run, whatever the source. The most @@ -635,13 +636,13 @@ Actions: \end{figure} \begin{figure}[tb] -\tlpng{basic-w32}{.6\linewidth} +\tlpng{basic-w32}{.6\linewidth}{Basic installer screen (Windows)} \caption{Basic installer screen (Windows); the Advanced button will result in something like figure~\ref{fig:advanced-lnx}}\label{fig:basic-w32} \end{figure} \begin{figure}[tb] -\tlpng{advanced-lnx}{\linewidth} +\tlpng{advanced-lnx}{\linewidth}{Advanced installer screen (\GNU/Linux)} \caption{Advanced \GUI{} installer screen (\GNU/Linux)}\label{fig:advanced-lnx} \end{figure} @@ -765,8 +766,9 @@ just plain and \LaTeX, \optname{small} for a few more programs specialized and country-specific schemes. \begin{figure}[tb] -\centering \tlpng{stdcoll}{.7\linewidth} -\caption{Collections menu}\label{fig:collections-gui} +\def\figdesc{Collections menu} +\centering \tlpng{stdcoll}{.7\linewidth}{\figdesc} +\caption{\figdesc}\label{fig:collections-gui} \end{figure} You can refine your scheme selection with the `collections' menu @@ -1515,7 +1517,7 @@ of the installation and create a temporary `tray menu' offering a choice of a few common tasks, as shown in this screenshot: \medskip -\tlpng{tray-menu}{4cm} +\tlpng{tray-menu}{4cm}{Windows tray menu} \smallskip \noindent The `More\ldots' entry explains how you can customize this menu. @@ -1582,20 +1584,23 @@ choice of a few common tasks, as shown in this screenshot: \label{sec:tlmgr} \begin{figure}[tb] -\tlpng{tlshell-macos}{\linewidth} -\caption{\prog{tlshell} \GUI, showing the Actions menu (\MacOSX)} +\def\figdesc{\prog{tlshell} \GUI, showing the Actions menu (\MacOSX)} +\tlpng{tlshell-macos}{\linewidth}{\figdesc} +\caption{\figdesc} \label{fig:tlshell} \end{figure} \begin{figure}[tb] -\tlpng{tlcockpit-packages}{.8\linewidth} -\caption{\prog{tlcockpit} \GUI{} for \prog{tlmgr}} +\def\figdesc{\prog{tlcockpit} \GUI{} for \prog{tlmgr}} +\tlpng{tlcockpit-packages}{.8\linewidth}{\figdesc} +\caption{\figdesc} \label{fig:tlcockpit} \end{figure} \begin{figure}[tb] -\tlpng{tlmgr-gui}{\linewidth} -\caption{Legacy \prog{tlmgr} \GUI\ mode: main window, after `Load'} +\def\figdesc{Legacy \prog{tlmgr} \GUI\ mode: main window, after `Load'} +\tlpng{tlmgr-gui}{\linewidth}{\figdesc} +\caption{\figdesc} \label{fig:tlmgr-gui} \end{figure} -- cgit v1.2.3