summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex')
-rw-r--r--macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex53
1 files changed, 52 insertions, 1 deletions
diff --git a/macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex b/macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex
index 4c78545c2d..dcd04b3338 100644
--- a/macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex
+++ b/macros/latex/contrib/univie-ling/doc/univie-ling-poster.tex
@@ -65,7 +65,7 @@
\author{\texorpdfstring{Jürgen Spitzmüller%
\thanks{Please report issues via \protect\url{https://github.com/jspitz/univie-ling}.}}{Jürgen Spitzmüller}}
-\date{Version 2.4, 2023/03/31}
+\date{Version 2.5, 2024/05/09}
\maketitle
@@ -110,6 +110,7 @@ The following class and packages are required and loaded by \uvlt:
\item \textsf{l3keys}: Key-value interface for class options.
\item \textsf{translator}: Localization machinery.
\item \textsf{url}: Support for typesetting URLs.
+ \item \textsf{tikzpagenodes}: Page measuring (for accessibility).
\end{itemize}
The following packages are required for specific features and loaded by default. However, the loading can be individually and generally omitted (see sec.~\ref{coptions}):
\begin{itemize}
@@ -481,6 +482,52 @@ Please refer to the comprehensive beamer manual \cite{beamer} for information.
Please also refer to the template files included in the package for some further usage instructions and hints.
+
+\subsection{Accessibility helpers}
+
+For visually impaired users, setting up posters is quite a challenge, as \LaTeX\ does not really give you good feedback
+on whether the poster is filled evenly, or even in the crucial case if the text overruns the poster page.
+In the latter case, you could watch out for \emph{overfull vbox} warnings, but these are quite ambiguous.
+
+To enhance accessibility in this regard, \uvlt\ provides the following helper function:
+\begin{description}
+ \item{\jcsmacro{restspace[<label>]}}
+\end{description}
+%
+If you insert this to your poster, it will tell you through a package warning in the log file how many normal lines
+there are still available (in the current column, if you are using columns) after the point where the command
+has been inserted:
+\begin{quote}
+ \enquote{Package univie-ling-poster warning: Remaining space: <n> normal lines}
+ (with <n> being the actual number of lines)
+\end{quote}
+%
+With \emph{normal lines}, the warning refers to lines in the normal font size of running text.
+In the warning, the package also provides you with its own evaluation on how to deal with the result.
+Either of these four verdicts will be given:
+\begin{enumerate}
+ \item \enquote{Good, still space left}: poster/column is not full yet, you can safely add more text
+ (more than one normal line left).
+ \item \enquote{All good, but this is full now}: poster/column is filled, and not too crowded,
+ but you should not add more text (one line more will make it look less good).
+ \item \enquote{It is still OK, but the poster is quite full}: The content already touches the footer line.
+ If you don't have space available in other columns and need all text, you can keep this, but it will
+ probably look a bit crowded. So if you can, re-arrange (take out at least one line).
+ \item \enquote{Text exceeds poster! You need to re-arrange the content}:
+ If you get this warning, text runs out of the poster page, and you definitely need to fix that.
+\end{enumerate}
+%
+The optional argument of the macro allows you to set an arbitrary label which is used in the warning.
+This might be helpful if you use multiple \verb|\restspace| macros (e.\,g., in multiple columns).
+So if you insert, for instance \verb|\restspace[1]|, the warning will read
+\enquote{Remaining space (1): <n> normal lines}.
+
+Note that \verb|\restspace| should always be the last element in the column or the text. This means that if
+you are using boxes, set the macro \emph{after} the end of the box, not within the box.
+
+Note further that the \verb|\restspace| macro does not print anything on the poster itself, so you can safely keep
+them in the published version.
+
\subsection{\LyX\ layouts and templates}
A layout for \LyX\footnote{See \url{https://www.lyx.org}.}\ can be retrieved from \url{https://github.com/jspitz/univie-ling/raw/master/lyx/layouts/univie-ling-poster.layout}.
@@ -498,6 +545,10 @@ Templates are provided as well:
\section{Release History}
\begin{description}
+ \item 2024/05/09 (v.\,2.5)
+ \begin{itemize}
+ \item Add \verb|\restspace| accessibility helper function.
+ \end{itemize}
\item 2023/03/31 (v.\,2.4)
\begin{itemize}
\item No change to this class.