From 29458b25776677bea7ac847f20cda7161a9d816b Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Thu, 28 May 2020 14:00:54 +0900 Subject: eqexam 20200528 --- texmf-dist/doc/latex/eqexam/README.md | 7 ++- texmf-dist/doc/latex/eqexam/eqexam.pdf | Bin 790391 -> 806244 bytes texmf-dist/doc/latex/eqexam/eqexamman.pdf | Bin 618511 -> 624926 bytes texmf-dist/doc/latex/eqexam/eqexamman.tex | 69 ++++++++++++++++++++++-- texmf-dist/doc/latex/eqexam/examples/test01.tex | 2 +- texmf-dist/doc/latex/eqexam/fortextbook.zip | Bin 718935 -> 812490 bytes 6 files changed, 71 insertions(+), 7 deletions(-) (limited to 'texmf-dist/doc/latex') diff --git a/texmf-dist/doc/latex/eqexam/README.md b/texmf-dist/doc/latex/eqexam/README.md index 60949c12..ab464cab 100644 --- a/texmf-dist/doc/latex/eqexam/README.md +++ b/texmf-dist/doc/latex/eqexam/README.md @@ -1,5 +1,5 @@ The eqexam Package -Dated: 2020-01-06 +Dated: 2020-03-14 Author: D. P. Story eqExam is a LaTeX package for writing exams, tests, quizzes, @@ -40,6 +40,11 @@ this package are as follows: folder. See also the series of blogs at http://www.acrotex.net/blog/?tag=fortextbook +What's New (2020-03-14) Defined several commands and one environment to +support the insertion of a figure into a problem. Demo file that illustrates +these new commands and environment is found at +http://www.acrotex.net/blog/?p=1419 + What's New (2020-01-06) Fixed a bug in eqexam, so that now comment.sty is fully supported. For consistency, aeb-comment.sty is nothing more than version 3.8 dating to July 2016. diff --git a/texmf-dist/doc/latex/eqexam/eqexam.pdf b/texmf-dist/doc/latex/eqexam/eqexam.pdf index 7441d010..ea03c1f8 100644 Binary files a/texmf-dist/doc/latex/eqexam/eqexam.pdf and b/texmf-dist/doc/latex/eqexam/eqexam.pdf differ diff --git a/texmf-dist/doc/latex/eqexam/eqexamman.pdf b/texmf-dist/doc/latex/eqexam/eqexamman.pdf index 97f43ca1..9684fd4f 100644 Binary files a/texmf-dist/doc/latex/eqexam/eqexamman.pdf and b/texmf-dist/doc/latex/eqexam/eqexamman.pdf differ diff --git a/texmf-dist/doc/latex/eqexam/eqexamman.tex b/texmf-dist/doc/latex/eqexam/eqexamman.tex index bef910e6..258bf562 100644 --- a/texmf-dist/doc/latex/eqexam/eqexamman.tex +++ b/texmf-dist/doc/latex/eqexam/eqexamman.tex @@ -150,7 +150,7 @@ part of the\texorpdfstring{\\}{ }\texorpdfstring{\AcroTeX}{AcroTeX} eDucation Bu \keywords{LaTeX, hyperref, PDF, exercises, quizzes} \university{{\AcroT} Software Development Team} \email{dpstory@acrotex.net} -\version{5.1.8, 2020/01/06} +\version{5.1.10, 2020/03/14} \copyrightyears{2005-\the\year} \renewcommand{\exsectitletext}{Solutions to exams in this manual} @@ -1727,7 +1727,7 @@ parameter is the value of the \texttt{label} key. I have a couple of crazy gizmos that you can use. -\subsubsection{The \texttt{workarea} Environment} +\subsubsection{The \texttt{workarea} Environment}\label{sss:workarea} For a mathematics test, we often pose a question that needs to be worked out. Vertical space is created @@ -1784,7 +1784,7 @@ is not provided, and the \texttt{workarea} does nothing. If \texttt{solutionsafter} is specified, that space is replaced by the provided solution. -\subsubsection{The \texorpdfstring{\cs{placeAtxy}}{\textbackslash placeAtxy} Command} +\subsubsection{The \texorpdfstring{\cs{placeAtxy}}{\textbackslash placeAtxy} Command}\label{sss:placeatxy} The \cs{placeAtxy} command is another device that I've used to place a block of text or a graphic on top of the vertical space @@ -1829,7 +1829,7 @@ combination with the \texttt{workarea} environment. % on the \hyperref[problem]{\texttt{problem} environment}, on % page~\hyperref[problem]{\pageref*{problem}}. -\subsubsection{The \texttt{splitsolution} Environment} +\subsubsection{The \texttt{splitsolution} Environment}\label{sss:splitsoln} I developed this environment to solve a problem with the \texttt{online} and \texttt{email} options. The white space @@ -5126,7 +5126,66 @@ in your \texttt{exam} environment. %\handpoint The demo file for this feature is named \texttt{markqs.tex}. \exAeBBlogPDF{p=1231} The demo file for this feature is named -\texttt{\href{\urlAcroTeXBlog/?p=1231}{markqs.pdf}} +\texttt{\href{\urlAcroTeXBlog/?p=1231}{markqs.pdf}} and is found on the {\AcroBlog}. + +\subsection{Methods for working figures into a problem}\label{s:insFigProbs} + +A figure is sometimes an integral part of a problem and is referred to in the +statement of the problem. This section discusses methods of incorporating the +figure into the problem. + +There are two placement locations for the figure: (1) in the work area or +solution area depending on the state of the exam document, and (2) in the +questions area. Traditionally, a figure is included as part of the work area; +these methods are documented and illustrated in the earlier discussions on +the \env{workarea} environment on page~\pageref{sss:workarea}, the +\cs{placeAtxy} command on page~\pageref{sss:placeatxy}, and the +\env{splitsolution} environment on page~\pageref{sss:splitsoln}. The primary +focus, therefore, is on positioning the figure within the question itself. + +To insert a figure into the question, there are two methods: (1) enclose the +problem in a \env{minipage}, enclose the figure in a \env{minipage}, and +place them side-by-side; and~(2) use a wrapping package, such as \pkg{picins}, to +insert and wrap the question text around the figure. We present commands in +support of these two methods. + +\paragraph*{The \env{minipage} approach.} +When a \env{problem} environment or an \cs{item} in a \env{problem*} +environment is enclosed in a \env{minipage} to reduce the width of the +problem to accommodate a figure, precede the outer \env{minipage} with +the command \cs{probInMinipage} and follow the outer \env{minipage} with the +environment \env{vadjustForSolnInBx}. +%\begin{fullwidthEnv}[priorskip=0pt] +\settowidth{\aebdimen}{\ttfamily\string\begin\darg{vadjForSolnInBx}\darg{\meta{width}}}% +\def\1{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ marks a problem in a \env{minipage}}}}% +\def\2{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ an environment that follows a problem ...}}}% +\def\3{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ marked with \cs{probInMinipage}}}}% +\begin{dCmd}[commandchars=!()]{\aebdimen+2\fboxsep+2\fboxrule} +!1\probInMinipage +!2\begin{vadjForSolnInBx}{!meta(width)} +!3!qquad!ameta(solution) +\end{vadjForSolnInBx} +\end{dCmd} + +\paragraph*{The wrap-the-figure method.} The next set of command supports wrapping +the figure around the text of the question. + +\settowidth{\aebdimen}{\ttfamily\string\probInsertSoln\darg{\meta{content}}}% +\def\2{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ for \env{problem} env}}}% +\def\3{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ for \cs{item} of \env{problem*} environment}}}% +\def\4{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ close group begun by two prior cmds}}}% +\def\5{\rlap{\hskip\linewidth\texttt{ \%}\textsf{ write figure to the solution page}}}% +\begin{dCmd}[commandchars=!()]{\aebdimen+2\fboxsep+2\fboxrule} +!2\bProbInsert{!meta(content)} +!3\bItemInsert{!meta(content)} +!4\eProbInsert +!5\probInsertSoln{!meta(content)} +\end{dCmd} + +\exAeBBlogPDF{p=1419} The demo file that illustrates these commands and +environment, named \texttt{\href{\urlAcroTeXBlog/?p=1419}{ins-fig.pdf}}, +is found on the {\AcroBlog}. + \newpage \markright{References} diff --git a/texmf-dist/doc/latex/eqexam/examples/test01.tex b/texmf-dist/doc/latex/eqexam/examples/test01.tex index 4f7d39e4..102b7b61 100644 --- a/texmf-dist/doc/latex/eqexam/examples/test01.tex +++ b/texmf-dist/doc/latex/eqexam/examples/test01.tex @@ -2,7 +2,7 @@ \usepackage{amsmath} \usepackage{graphicx} \usepackage[% - online, % try commenting out this option to get a paper document +% online, % try commenting out this option to get a paper document % nosolutions, % answerkey, vspacewithsolns, diff --git a/texmf-dist/doc/latex/eqexam/fortextbook.zip b/texmf-dist/doc/latex/eqexam/fortextbook.zip index e3210cfd..a21725cb 100644 Binary files a/texmf-dist/doc/latex/eqexam/fortextbook.zip and b/texmf-dist/doc/latex/eqexam/fortextbook.zip differ -- cgit v1.2.3