summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/acrotex/web.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2021-04-27 03:00:54 +0000
committerNorbert Preining <norbert@preining.info>2021-04-27 03:00:54 +0000
commit95b070aee1a6351879af117f723c84d50b48338d (patch)
tree214e27cd933a5d3216ef0d0db495cbca43415e3c /macros/latex/contrib/acrotex/web.dtx
parent03117c94362b2fed2fd4aabe50f3106fbf1e0a70 (diff)
CTAN sync 202104270300
Diffstat (limited to 'macros/latex/contrib/acrotex/web.dtx')
-rw-r--r--macros/latex/contrib/acrotex/web.dtx156
1 files changed, 87 insertions, 69 deletions
diff --git a/macros/latex/contrib/acrotex/web.dtx b/macros/latex/contrib/acrotex/web.dtx
index d423a0681a..76375a62d5 100644
--- a/macros/latex/contrib/acrotex/web.dtx
+++ b/macros/latex/contrib/acrotex/web.dtx
@@ -36,6 +36,8 @@
\let\env\texttt
\let\app\textsf
\let\uif\textsf
+\def\STRUT{\rule{0pt}{14pt}}
+\def\negSTRUT{\rule[-8pt]{0pt}{0pt}}
\def\nmpsep#1{\hskip-\marginparsep\texttt{#1}}
\def\visispace{\symbol{32}}
\def\ameta#1{\ensuremath{\langle\textit{\texttt{#1}}\rangle}}
@@ -88,7 +90,7 @@
% \texttt{dvipdfm}, \texttt{dvipdfmx}, \texttt{xetex}, and \texttt{textures}.
%\par\medskip\noindent
% We introduce these two packages early. We use them to automatically
-% detect pdftex and xetex.
+% detect \app{pdf(la)tex} and \app{xe(la)tex}.
%\changes{v4.2k}{2012/06/18}{New requirement \string\textsf{ifpdf}}%
% \begin{macrocode}
\RequirePackage{ifpdf}[2006/02/20]
@@ -131,10 +133,10 @@
% Below is the original definition of \cs{web@set@paper}, this has now
% changed with \texttt{v4.2j} to accommodate \cs{addtoWebHeight} and
% \cs{addtoWebWidth}.
-%\begin{verbatim}
-% \def\web@set@paper{%
-% \special{papersize=\the\paperwidth,\the\paperheight}}%
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\def\web@set@paper{\special{papersize=\the\paperwidth,\the\paperheight}}%
+%\end{Verbatim}
% \changes{v4.2j}{2012/05/11}{In support of \string\cs{addtoWebHeight}, we introduce
% the pagesize special at the beginning of the document. Changes are in the
% \string\texttt{dvipsone} and \string\texttt{dvips} options only.}
@@ -182,10 +184,11 @@
\def\i@web@ddtoHyOpts{setpagesize=false}%
% \end{macrocode}
% The old definition of \cs{web@set@paper}
-%\begin{verbatim}
-% \def\web@set@paper{%
-% \special{papersize=\the\paperwidth,\the\paperheight}}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\def\web@set@paper{!%
+%!quad\special{papersize=\the\paperwidth,\the\paperheight}}
+%\end{Verbatim}
% New definitions (\texttt{v4.2j}). See comments for the \texttt{dvipsone} option.
% \begin{macrocode}
\let\web@set@paper\@empty
@@ -880,9 +883,10 @@
% \end{macrocode}
% \subsection{Load Configuration File: web.cfg}
% Look for configuration file, \texttt{web.cfg}, for example
-%\begin{verbatim}
-% \ExecuteOptionsX{dvips}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\ExecuteOptionsX{dvips}
+%\end{Verbatim}
% sets \texttt{dvips} as the default driver.
% \begin{macro}{\minPanelWidth}
% This definition is moved here so a user can set the minimal
@@ -1122,11 +1126,12 @@
\addtolength{\textheight}{-\@Topmargin}
\addtolength{\textheight}{-\@Bottommargin}
% \end{macrocode}
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!~$},codes={\catcode`\%=9}]
%\topmargin = \web@Topmargin - 1in
%\@Topmargin = \web@Topmargin + \headheight + \headsep
-% so \headsep = \@Topmargin - \headheight - \web@Topmargin (\topmargin)
-%\end{verbatim}
+%!textsf~so $\headsep = \@Topmargin - \headheight - \web@Topmargin (\topmargin)
+%\end{Verbatim}
% \begin{macrocode}
\setlength{\headsep}{\@Topmargin}
\addtolength\headsep{-\headheight}
@@ -1192,13 +1197,12 @@
% press quality have this parameter at 2400. The second and third parameters are the
% width and height, respectively, of the \textbf{/PageSize}. For greatest accuracy, the values of
% width and height should be entered in printers points (without dimensions). For example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\setPageDevice{1400}{1400}
-%\end{verbatim}
-% is preferred to
-%\begin{verbatim}
+%!STRUT!negSTRUT!textsf(is preferred to)
%\setPageDevice{20in}{20in}
-%\end{verbatim}
+%\end{Verbatim}
% \texttt{20in} gets converted to \texttt{1439.9965}. The conversion, if necessary, is done
% by \cs{@convLtoP}
%
@@ -1238,11 +1242,12 @@
% and \cs{paperheight} will be the default values set by the class, but take \cs{textwidth} to be
% the value of \#2. The second and third parameters are the width and height, respectively, as measured
% in printer points ($72\,\mbox{points} = 1\,\mbox{inch}$, or measures in the \texttt{bp} points of \TeX.)
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%Parameters:
-% #1 = \paperheight (height of the display screen to be created)
-% #2 = \paperwidth (width of the display screen to be created)
-%\end{verbatim}
+%!quad#1 = \paperheight (height of the display screen to be created)
+%!quad#2 = \paperwidth (width of the display screen to be created)
+%\end{Verbatim}
% \begin{macrocode}
\def\screensize#1#2{%
\def\webSaveSSDim{{#1}{#2}}%
@@ -1281,22 +1286,24 @@
% cannot be deformed to fit one of the standard designs. The solution is to
% create a screen size matching the graphic, then using that graphic as a template.
% Example usage,
-%\begin{verbatim}
-% \margins{1in}{1in}{24pt}{.25in}
-% \setScreensizeFromGraphic{acro_30}
-% \template{acro_30}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%!quad\margins{1in}{1in}{24pt}{.25in}
+%!quad\setScreensizeFromGraphic{acro_30}
+%!quad\template{acro_30}
+%\end{Verbatim}
% This command takes two arguments, the first is optional and is passed
% to the \cs{includegraphics} command, the second it the path to the file.
%
% It may become necessary with some graphics to use the
% \texttt{hiresbb} option for \cs{includegraphics}, both in
% \cs{setScreensizeFromGraphic} and \cs{template} like so,
-%\begin{verbatim}
-% \margins{1in}{1in}{24pt}{.25in}
-% \setScreensizeFromGraphic[hiresbb]{acro_30}
-% \template[hiresbb]{acro_30}
-%\end{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%!quad\margins{1in}{1in}{24pt}{.25in}
+%!quad\setScreensizeFromGraphic[hiresbb]{acro_30}
+%!quad\template[hiresbb]{acro_30}
+%\end{Verbatim}
% \changes{v4.0f}{2007/06/11}
% {
% This command measures the dimensions of an EPS file, and sets the
@@ -1387,7 +1394,8 @@
% \subsubsection{\texorpdfstring{\protect\cs{margins}}{\CMD{margins}}}
% \begin{macro}{\margins}
% Sets the left, right, top and bottom margins.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%Parameters:
% [#1] = width of panel to be used if a panel option
% is specified (default is 1in)
@@ -1395,7 +1403,7 @@
% #3 = right margin
% #4 = top margin
% #5 = bottom margin
-%\end{verbatim}
+%\end{Verbatim}
% \begin{macrocode}
\newcommand{\@margins}[5][\web@minpanelwidth]{%
\def\webSaveMargDim{[#1]{#2}{#3}{#4}{#5}}%
@@ -1422,9 +1430,10 @@
% |\addtoWebWidth| and |\addtoWebHeight|, this command readjusts
% the margins. Within the arguments \cs{incby}
% refer to the current dimension.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\resetsmargins{\incby+.25in}{\incby+.25in}{}{}
-%\end{verbatim}
+%\end{Verbatim}
% This line adds .25in to each of the side margins.
% \begin{macrocode}
\newcommand\get@MargDim[5][]{%
@@ -1955,7 +1964,7 @@
\@ifundefined{aeb@talksite}{\webversion}
{\ifx\aeb@talksite\@empty\webversion
\else\aeb@talksite\fi}%
- }%
+ }%
}%
}%
\bigskip
@@ -2161,7 +2170,8 @@
% \begin{macro}{\@newNaviIconMenu}
% This command uses the hyperref command \cs{Acrobatmenu} to create navigation link button. The
% action for this type is restricted to named menu actions.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%Parameters
% [#1] = optional parameter for setting the highlight, N (none),
% I (invert, the default), O (outline), P (push, also called Inset)
@@ -2170,7 +2180,7 @@
% #4 = height of icon
% #5 = text to appear in the center of the icon.
% #6 = named menu action, e.g., NextPage, PrevPage, etc.
-%\end{verbatim}
+%\end{Verbatim}
% The color of the text is controlled by \cs{navibarTextColor}, and the background color
% is determined by \cs{@menuBgColor}.
% \begin{macrocode}
@@ -2188,7 +2198,8 @@
% \end{macro}
% \begin{macro}{\@newNaviIconJS}
% Another navigation icon/button, but this one allows for arbitrary JavaScript actions.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%Parameters
% [#1] = optional parameter for setting the highlight, N (none),
% I (invert, the default) O (outline), P (push, also called Inset)
@@ -2197,7 +2208,7 @@
% #4 = height of icon
% #5 = text to appear in the center of the icon.
% #6 = JavaScript commands to be executed when the button is clicked.
-%\end{verbatim}
+%\end{Verbatim}
% The color of the text is controlled by \cs{navibarTextColor}, and the background color
% is determined by \cs{@menuBgColor}.
% \begin{macrocode}
@@ -2242,7 +2253,8 @@
% \end{macrocode}
% \end{macro}
% Another navigation icon/button, this one allows jumping to a named destination.
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%Parameters
% [#1] = optional parameter for setting the highlight, N (none),
% I (invert, the default), O (outline), P (push, also called Inset)
@@ -2251,12 +2263,13 @@
% #4 = height of icon
% #5 = text to appear in the center of the icon.
% #6 = \hyperlink or \href with its first argument
-%\end{verbatim}
+%\end{Verbatim}
% For example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\newNaviIcon[l]{\Home}{40pt}{15pt}{\footnotesize Home}
% {\href{http://www.math.uakron.edu/}}
-%\end{verbatim}
+%\end{Verbatim}
% The color of the text is controlled by \cs{navibarTextColor}, and the background color
% is determined by \cs{@menuBgColor}.
% \begin{macrocode}
@@ -2452,9 +2465,10 @@
% \begin{macro}{\ArrowUp}
% \begin{macro}{\ArrowDown}
% Pre-Fab Rule Icons \cs{Uparrow} and \cs{Downarrow}, for example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\insertnaviiconhere{\ArrowUp{\href{http://www.adobe.com/}}}
-%\end{verbatim}
+%\end{Verbatim}
% \begin{macrocode}
\newcommand\ArrowUp[1]{%
\normalsize\ifeqforpaper
@@ -3067,11 +3081,12 @@
\begingroup
% \end{macrocode}
% Sample line from .aux
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
% \contentsline {section}{\numberline {1}Introduction}{4}{section.1}
% \contentsline {section}{\numberline {}References}{56}{section*.1}
% #1 #2 #3
-%\end{verbatim}
+%\end{Verbatim}
% \begin{macrocode}
\global\let\isChapter\web@NO
\parskip0pt\parindent\toc@indent\relax
@@ -3217,9 +3232,10 @@
% is optional. Use any of the \emph{boolean keys} of the
% \cs{includegraphics} command. Do not use the \texttt{width} or
% \texttt{height} keys in this optional argument. For example,
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
% \template[hiresbb]{myBG}
-%\end{verbatim}
+%\end{Verbatim}
% Causes the driver to import the graphic using the high resolution bounding
% box.
% It is assumed that a graphic defined by \cs{template} is intended to fill the entire
@@ -3948,8 +3964,9 @@
% in the \texttt{web} package. This command should appear in the preamble.
%
%\medskip\noindent Example usage:
-%\begin{verbatim}
-%\DeclareDocInfo{%
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
+%\DeclareDocInfo{!%
% title=My First Presentation,
% author=D. P. Speaker,
% university=My University,
@@ -3958,7 +3975,7 @@
% talksite=The Talking University,
% subject=The Art of Talking
%}
-%\end{verbatim}
+%\end{Verbatim}
% \begin{macrocode}
\newcommand{\DeclareDocInfo}[1]{\setkeys{aebDocInfo}{#1}%
\ifx\web@talkdate@value\@empty\else\let\webversion\webtalkdate\fi}
@@ -4048,15 +4065,16 @@
% ignored when the \texttt{forpaper} option is in effect.
%
%\medskip\noindent Example usage:
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\DeclarePageLayout
-%{%
+%{!%
% screensizeOf=designv,
% margins={.75in}{.75in}{.75in}{.75in},
% topmargin=40pt,
% webfootskip=30pt
%}
-%\end{verbatim}
+%\end{Verbatim}
% This sets the \texttt{\texttt{screensize}} to the same as the
% \texttt{screensize} of \texttt{designv}. We then adjust the
% margins, the \texttt{topmargin} key is used to position the running
@@ -5186,9 +5204,10 @@
% The \cs{selectColors} is a convenience command for setting
% many of the colors involved in the design of an \textsf{APB} document.
% The default colors are \dots
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\selectColors
-%{
+%{!%
% universityColor = blue,
% titleColor = black,
% authorColor = black,
@@ -5199,7 +5218,7 @@
% linkColor = webgreen,
% fileColor = webbrown
%}
-%\end{verbatim}
+%\end{Verbatim}
% \begin{macrocode}
\newcommand{\selectColors}[1]{\setkeys{aebcolordesign}{#1}}
% \end{macrocode}
@@ -5235,14 +5254,15 @@
% \begin{macro}{\selectTocDings}
% This is an \textsf{xkeyval} interface to setting the dings used by
% the structured lists and the table of contents. Usage:
-%\begin{verbatim}
+%\begin{Verbatim}[xleftmargin=\parindent,fontsize=\small,
+%commandchars={!()},codes={\catcode`\%=9}]
%\selectTocDings
-%{
+%{!%
% dDing=\ding{082},
% ddDing=\ding{079},
% dddDing=\ding{254}
%}
-%\end{verbatim}
+%\end{Verbatim}
% \begin{macrocode}
\newcommand{\selectTocDings}[1]{\setkeys{aebDings}{#1}}
% \end{macrocode}
@@ -5265,10 +5285,8 @@
% comment environments one \texttt{forpaper} and another for
% \texttt{forscreen}.
% \begin{macrocode}
- \includecomment{forpaper}\excludecomment{forscreen}
-\else
- \includecomment{forscreen}\excludecomment{forpaper}
-\fi
+ \includecomment{forpaper}\excludecomment{forscreen}\else
+ \includecomment{forscreen}\excludecomment{forpaper}\fi
% \end{macrocode}
% \end{environment}
% \end{environment}