\documentclass[11pt]{article}
\usepackage{web}
\screensize{11in}{8.5in}
\margins{1in}{1in}{1in}{1in}
\usepackage{exerquiz}[2021/02/15]
\usepackage[ignorecfg,useverses=none]{fetchbibpes}[2021/03/08]
\usepackage{eq-fetchbbl}
\addtoBibles{NKJV}

\title{Matching-type questions for a Quiz\texorpdfstring{\\[1ex]}{: }Bible Passages with their Verses}
\author{D. P. Story}
\subject{Matching-type questions}
\date{\today}
\keywords{AcroTeX, LaTeX, quiz, matching, randomized}
\version{\url{http://blog.acrotex.net}}
\versionLabel{}
\revisionLabel{Published:}
\university
{%
      The {Acro\negthinspace\TeX} Blog
}
\email{dpstory@acrotex.net}

\useBeginQuizButton[\CA{Start}\textColor{blue}]
\useEndQuizButton[\CA{End}\textColor{blue}]

\def\cs#1{\texttt{\eqbs#1}}
\let\pkg\textsf
\let\env\texttt

\begin{declareBVs*}
\BV(Mat 10:26 NKJV) Therefore do not fear them. For there is nothing covered that will not be
    revealed, and hidden that will not be known.\null
\BV(Mar 1:11 NKJV) Then a voice came from heaven, \textcolor{red}{``You are My beloved Son, in whom I am well
    pleased.''}\null
\BV(Luk 12:2 NKJV) For there is nothing covered that will not be revealed, nor hidden that
    will not be known.\null
\BV(Act 10:15 NKJV) dummy entry\null
\end{declareBVs*}

\useBookStyle{abbr=none,from=NKJV}

\PTsHook{($\eqPTs^{\scriptsize\mbox{pts}}$)}

\begin{document}

\maketitle

\section*{Examples that appear in the documentation}

Match the Bible quotations in the left column with their reference passages.
Quotations are taken from the \textsf{New King James Version (NKJV)}.

\section*{First Example}

\begin{quiz}{q1}
Match the quotations (\textsf{NKJV)} with the Bible references on the right.
Each problem is worth 2 points; passing is 100\%.

The \textsf{Ans} button (\cs{CorrAnsButton}) appears in its default location
on the last line and up against the right margin. This may be a problem if
one or more Bible passages ends close to the right margin; the use of
\cs{adjCAB} or of \cs{priorRBT} may be needed.


\noindent
\begin{minipage}[t]{.75\linewidth}
%\useNumbersOn
\begin{questions}
\begin{BblPsg}
  \item\PTs*{2}\qFP{Mat 10:26}
  \item\PTs*{2}\qFP{Mar 1:11}
  \item\PTs*{2}\qFP{Luk 12:2}
\end{BblPsg}
\end{questions}
\end{minipage}
\hfill
\begin{minipage}[t][0pt]{.25\linewidth-1em}
\begin{questions}[itemsep={0pt},labelwidth={.5em}]
\begin{BblVrs}
  \item\qFV{Act 10:15}
  \item\qFV{Luk 12:2}
  \item\qFV{Mar 1:11}
  \item\qFV{Eph 6:1}
  \item\qFV{Mat 10:26}
  \item\qFV{Joh 6:20}
\end{BblVrs}
\end{questions}
\end{minipage}\hfill
\par\medskip
\end{quiz}\quad\PointsField\currQuiz\olBdry\CorrButton\currQuiz\cgBdry[6pt]
Answers: \AnswerField[\Q{1}\textColor{blue}\rectW{\RBTWidth}]{\currQuiz}


\section*{Second Example}

\begin{quiz*}{q2}
Match the quotations (\textsf{NKJV)} with the Bible references on the right.
Each problem is worth 2 points; passing is 100\%.

In this example, \cs{useNumbersOn} is declared. An additional non-matching
question is included as well. The command \cs{adjCAB} positions the
\textsf{Ans} button in the space between the mini-pages, aligned with the
last line.

% get the width of  \CorrAnsButton to determine how much space between
% mini-pages is needed.
\setlength{\eflength}{\widthof{\enspace\CorrAnsButton{A}\enspace}}
\useMCCircles

\noindent
\begin{minipage}[t]{.75\linewidth-\eflength}
\useNumbersOn
\adjCAB{\makebox[0pt][l]{\enspace#2\enspace}}
\everyRespBoxTxt{\textColor{blue}}
\begin{questions}
\begin{BblPsg}
  \item\PTs*{2}\qFP{Mat 10:26}
  \item\PTs*{2}\qFP{Mar 1:11}
  \item\PTs*{2}\qFP{Luk 12:2}
\end{BblPsg}
\item\PTs*{2} The quotation ``Treasures of wickedness profit nothing, But
    righteousness delivers from death'' is a verse from which of the
    following books?
\begin{answers}{4}
  \bChoices
    \Ans0 Psalms\eAns
    \Ans0 Isaiah\eAns
    \Ans1 Proverbs\eAns
    \Ans0 Jonah\eAns
    \eChoices
\end{answers}
\end{questions}
\end{minipage}
\hfill
\begin{minipage}[t]{.25\linewidth}
\begin{questions}[itemsep={0pt},labelwidth={1em}]
\begin{BblVrs}
  \item\qFV{Act 10:15}
  \item\qFV{Luk 12:2}
  \item\qFV{Mar 1:11}
  \item\qFV{Eph 6:1}
  \item\qFV{Mat 10:26}
  \item\qFV{Joh 6:20}
\end{BblVrs}
\end{questions}
\end{minipage}\hfil
\par\medskip
\end{quiz*}\quad\PointsField\currQuiz\olBdry\CorrButton\currQuiz\cgBdry[6pt]
Answers: \AnswerField[\Q{1}\textColor{blue}\rectW{\RBTWidth}]{\currQuiz}

\newpage

\section*{Third Example}

\begin{quiz*}{q3}
Match the quotations (\textsf{NKJV)} with the Bible references on the right.
Each problem is worth 2 points; passing is 100\%.

\cs{useNumbersOff} is declared and \cs{priorRBT} is used to position the `\textsf{Ans}'
button aligned with the first line.

\setlength{\eflength}{\widthof{\enspace\CorrAnsButton{A}\enspace}} %\previewOn
\useMCCircles

\noindent
\begin{minipage}[t]{.75\linewidth-\eflength}
\useNumbersOff
\priorRBT{\makebox[0pt][l]{\hspace{\RBTWidth}\hspace{\labelsep}\hspace{\linewidth}\enspace#1\enspace}}
\adjCAB{}
\everyRespBoxTxt{\textColor{blue}}
\begin{questions}
\begin{BblPsg}
  \item\PTs*{2}\qFP{Mat 10:26}
  \item\PTs*{2}\qFP{Mar 1:11}
  \item\PTs*{2}\qFP{Luk 12:2}
\end{BblPsg}

\end{questions}
\end{minipage}
\hfill
\begin{minipage}[t]{.25\linewidth}
\begin{questions}[itemsep={0pt},labelwidth={1em}]
\begin{BblVrs}
  \item\qFV{Act 10:15}
  \item\qFV{Luk 12:2}
  \item\qFV{Mar 1:11}
  \item\qFV{Eph 6:1}
  \item\qFV{Mat 10:26}
  \item\qFV{Joh 6:20}
\end{BblVrs}
\end{questions}
\end{minipage}\hfil
\par\medskip
\end{quiz*}\quad\PointsField\currQuiz\olBdry\CorrButton\currQuiz\cgBdry[6pt]
Answers: \AnswerField[\Q{1}\textColor{blue}\rectW{\RBTWidth}]{\currQuiz}

\begin{quiz*}{q4}
Match the quotations (\textsf{NKJV)} with the Bible references on the right.
Each problem is worth 2 points; passing is 100\%.

\cs{useNumbersOn} is declared and \cs{priorRBT} is used to position the \textsf{Ans}
button between mini-pages.

\setlength{\eflength}{\widthof{\enspace\CorrAnsButton{A}\enspace}}
\useMCCircles

\noindent
\begin{minipage}[t]{.75\linewidth-\eflength}
\useNumbersOn
\priorRBT{\makebox[0pt][l]{\hspace{\linewidth}\enspace#1\enspace}}
\adjCAB{}
\everyRespBoxTxt{\textColor{blue}}
\begin{questions}
\begin{BblPsg}
  \item\PTs*{2}\qFP{Mat 10:26}
  \item\PTs*{2}\qFP{Mar 1:11}
  \item\PTs*{2}\qFP{Luk 12:2}
\end{BblPsg}

\end{questions}
\end{minipage}
\hfill
\begin{minipage}[t]{.25\linewidth}
\begin{questions}[itemsep={0pt},labelwidth={1em}]
\begin{BblVrs}
  \item\qFV{Act 10:15}
  \item\qFV{Luk 12:2}
  \item\qFV{Mar 1:11}
  \item\qFV{Eph 6:1}
  \item\qFV{Mat 10:26}
  \item\qFV{Joh 6:20}
\end{BblVrs}
\end{questions}
\end{minipage}\hfil
\par\medskip
\end{quiz*}\quad\PointsField\currQuiz\olBdry\CorrButton\currQuiz\cgBdry[6pt]
Answers: \AnswerField[\Q{1}\textColor{blue}\rectW{\RBTWidth}]{\currQuiz}

\newpage

\section*{Other Ideas for placing auxiliary controls}

The positioning of the \textsf{Ans} button can be a problem. There are two other
ideas that occurred to me. These ideas are illustrated in the quiz below.

\begin{quiz*}{q5}
Match the quotations (\textsf{NKJV)} with the Bible references on the right.
Each problem is worth 2 points; passing is 100\%.

We return to the ``natural'' spacing between mini-pages of the
\textcolor{blue}{First Example}. In the three items below, we try different
strategies for placing the \textsf{Ans} button.

\setlength{\eflength}{\widthof{\enspace\CorrAnsButton{A}\enspace}}
\useMCCircles

\noindent
\begin{minipage}[t]{.75\linewidth}
\begin{questions}
\everyRespBoxTxt{\textColor{blue}}
\useNumbersOff
\adjCAB{}
\begin{BblPsg}
\priorRBT{\makebox[0pt][r]{#1\hskip\marginparsep}}
  \item\PTs*{2}\qFP{Mat 10:26}
\end{BblPsg}
\useNumbersOn
\priorRBT{\makebox[0pt][r]{#1\hskip\labelwidth\hskip\marginparsep\efKern{1bp}{0pt}}}
\begin{BblPsg}
  \item\PTs*{2}\qFP{Mar 1:11}
\end{BblPsg}
\useNumbersOff
\priorRBT{}
\priorPsg{\makebox[0pt][l]{#1}}
\begin{BblPsg}
  \item\PTs*{2}\qFP{Luk 12:2}
\end{BblPsg}
\end{questions}
\end{minipage}
\hfill
\begin{minipage}[t][0pt]{.25\linewidth-1em}
\begin{questions}[itemsep={0pt},labelwidth={.5em}]
\begin{BblVrs}
  \item\qFV{Act 10:15}
  \item\qFV{Luk 12:2}
  \item\qFV{Mar 1:11}
  \item\qFV{Eph 6:1}
  \item\qFV{Mat 10:26}
  \item\qFV{Joh 6:20}
\end{BblVrs}
\end{questions}
\end{minipage}\hfill
\par\medskip

\end{quiz*}\quad\PointsField\currQuiz\olBdry\CorrButton\currQuiz\cgBdry[6pt]
Answers: \AnswerField[\Q{1}\textColor{blue}\rectW{\RBTWidth}]{\currQuiz}

\section*{Customizations of the quiz}

In this section, customizations of the matching-type quiz are explored. We
redefine the \env{BblVrs} environment, changing from capital letters to
numbers; to avoid confusion, \cs{useNumbersOff} is declared. All fonts are
changed to bold and red, look for changes in the source file involving
\textsf{HeBo} (Helvetica-Bold) and the color red. Also, sans serif is used
for the numbering of the verse references.

\makeatletter
\renewenvironment{BblVrs}{%
%  \renewcommand{\theeqquestionnoi}{\Alph{eqquestionnoi}}%  old def
  \renewcommand{\theeqquestionnoi}{\arabic{eqquestionnoi}}% new def
  \renewcommand{\labeleqquestionnoi}{%
%    \color{\eq@quesNumCol}\bfseries\theeqquestionnoi}% old def
    \color{\eq@quesNumCol}\sffamily\bfseries\theeqquestionnoi}% new def
    \eqfQorS
}{}
\makeatother
\quesNumColor{red}

\begin{quiz*}{q6}
Match the quotations (\textsf{NKJV)} with the Bible references on the right.
Each problem is worth 2 points; passing is 100\%.

\setlength{\eflength}{\widthof{\enspace\CorrAnsButton{A}\enspace}}
\useMCCircles

\noindent
\begin{minipage}[t]{.75\linewidth}
\begin{questions}
\everyRespBoxTxt{\textFont{HeBo}\textColor{red}}
\useNumbersOff
\begin{BblPsg}
  \item\PTs*{2}\qFP{Mat 10:26}
  \item\PTs*{2}\qFP{Mar 1:11}
  \item\PTs*{2}\qFP{Luk 12:2}
\end{BblPsg}
\end{questions}
\end{minipage}
\hfill
\begin{minipage}[t][0pt]{.25\linewidth-1em}
\begin{questions}[itemsep={0pt},labelwidth={.5em}]
\begin{BblVrs}
  \item\qFV{Act 10:15}
  \item\qFV{Luk 12:2}
  \item\qFV{Mar 1:11}
  \item\qFV{Eph 6:1}
  \item\qFV{Mat 10:26}
  \item\qFV{Joh 6:20}
\end{BblVrs}
\end{questions}
\end{minipage}\hfill
\par\medskip

\end{quiz*}\quad\PointsField\currQuiz\olBdry\CorrButton\currQuiz\cgBdry[6pt]
Answers: \AnswerField[\Q{1}\textFont{HeBo}\textColor{red}\rectW{\RBTWidth}]{\currQuiz}\vcgBdry[6pt]

Now that the verses are referenced using numbers, you are free to ask hundreds of Biblical
matching questions; the only problem is arranging them on the page. \verb~:-{)~




\end{document}
