%% This document created by Scientific Notebook (R) Version 3.0


\documentclass[12pt,thmsa]{article}
\usepackage{amssymb}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\usepackage{sw20jart}

%TCIDATA{TCIstyle=article/art4.lat,jart,sw20jart}

%TCIDATA{<META NAME="ViewSettings" CONTENT="31">}
%TCIDATA{<META NAME="GraphicsSave" CONTENT="32">}
%TCIDATA{<META NAME="Title" CONTENT="Ch. 3: Creating Exam Source Files">}
%TCIDATA{Created=Mon Aug 19 14:52:24 1996}
%TCIDATA{LastRevised=Thu Feb 13 16:17:00 1997}
%TCIDATA{Language=American English}
%TCIDATA{CSTFile=Booklet.cst}
%TCIDATA{PageSetup=61,61,114,114,1}
%TCIDATA{<LINK REL="author" HREF="EBfront.tex">}
%TCIDATA{<LINK REL="contents" HREF="EBcontents.tex">}
%TCIDATA{<LINK REL="copyright" HREF="EBfront.tex">}
%TCIDATA{<LINK REL="end" HREF="EBIndex.tex">}
%TCIDATA{<LINK REL="index" HREF="EBIndex.tex">}
%TCIDATA{<LINK REL="next" HREF="EBfrontsection.tex">}
%TCIDATA{<LINK REL="parent" HREF="EBcontents.tex">}
%TCIDATA{<LINK REL="previous" HREF="EBvariations.tex">}
%TCIDATA{<LINK REL="publisher" HREF="EBfront.tex">}
%TCIDATA{<LINK REL="top" HREF="EBcontents.tex">}
%TCIDATA{<LINK REL="trademark" HREF="EBfront.tex">}
%TCIDATA{AllPages=
%H=78
%F=36
%}


\input{tcilatex}
\begin{document}


\subsection{\textit{Chapter 3 \hrulefill }}

\quad

\section{Creating Exam Source Files\label{Creating Source Files}}

You create the source files for the Exam Builder the same way you create any
other \textit{Scientific Notebook }file, using the software's powerful
features to write and edit your text and mathematics. In the source files,
you arrange your text and mathematics in sections and head the sections with
special \emph{keywords }that convey information and instructions to the Exam
Builder.

\subsection{Starting source files\label{Starting source files}}

When you write an exam, you can either create a completely new file or you
can work from an existing source file, changing the content of the file as
necessary. The style and tag settings for the file you use determine the
appearance of your exam. You can change the appearance easily by \hyperref{%
changing to a different style}{}{}{Choose_style.tex} or by changing the
appearance of \hyperref{tagged elements}{}{}{Tags.tex}. For more information
on formatting exams and other \textit{Scientific Notebook} documents, refer
to the \hyperref{Help Contents}{}{}{Contents.tex}.

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To start a new
file\label{Starting a new file}}}

\begin{enumerate}
\item  Click\FRAME{itbpF}{22.4375pt}{21.0625pt}{2pt}{}{}{filenew.wmf}{%
\special{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 22.4375pt;height 21.0625pt;depth
2pt;original-width 20.3125pt;original-height 18.8125pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'filenew.wmf';file-properties
"XNPEU";}}or, from the File menu, choose New.

\item  Select the shell file you want to use. The Exam shell provides a
basic exam format.

\item  Choose OK.\medskip 
\end{enumerate}

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To work from an
existing file\label{Working from an existing file}}}

\begin{enumerate}
\item  Click\FRAME{itbpF}{22.4375pt}{21.0625pt}{2pt}{}{}{fileopen.wmf}{%
\special{language "Scientific Word";type "GRAPHIC";maintain-aspect-ratio
TRUE;display "PICT";valid_file "F";width 22.4375pt;height 21.0625pt;depth
2pt;original-width 17.8125pt;original-height 16.9375pt;cropleft "0";croptop
"1";cropright "1";cropbottom "0";filename 'fileopen.wmf';file-properties
"XNPEU";}}or, from the File menu, choose Open.

\item  Select the file you want to use and choose OK.

\item  Save the file under a different name:

\begin{enumerate}
\item  Choose Save As from the File menu.

\item  Specify a new name for the file.

\item  Choose OK.\medskip 
\end{enumerate}
\end{enumerate}

\subsection{Organizing source files in sections\label%
{Organizing source files in sections}}

Exam Builder source files must be organized in sections. Source files begin
with a front section that identifies the file as an Exam Builder source
file. The front section contains additional sections that set up certain
features of the exam, such as any text that appears at the top of the exam
or the values of global variables.

The front section is followed by a series of question-and-answer sections,
one for each question on the exam. In turn, each question section contains
additional sections that provide a problem statement, a series of possible
answers or a space where the student can enter a free-form answer, and,
optionally, both simple and detailed explanations of the problem solution.
The sections can contain tables, graphics, matrices, 2D and 3D plots, and
any other elements that can be contained in \textit{Scientific Notebook }%
files.

Each section in the source file must begin with a section heading, although
the level of the heading is unimportant. The Exam Builder ignores the level
of the heading, but you may find different heading levels useful when you're
organizing the material in your source file.

\subparagraph{\noindent $\blacktriangleright $\quad \textbf{To start a
section}}

\begin{enumerate}
\item  Press Enter to begin a new paragraph.

\item  \hyperref{Apply a tag}{}{}{Apply.tex} for a section heading using the
Section/Body Tag popup list, the function keys, or the Apply command on the
Tag menu.
\end{enumerate}

\subsection{Using keywords\label{Using keywords}}

The Exam Builder generates exams based on the information you supply in the
source file with predefined \emph{keywords. \vspace{1pt}}The keywords
indicate the purpose of each section in the source file, the kind of
information the section contains, and the action to be taken with the
information. When the Exam Builder compiles the file, keywords trigger
certain effects, such as the inclusion and formatting of a list of choices
for a multiple-choice question or the selection and ordering of certain
question variants.

Keywords can appear in three locations in your source file: in section
headings, at the beginning of a paragraph, or in a list following a keyword.

\subsubsection{Keywords in section headings}

When the Exam Builder encounters a keyword in a section heading, it
associates all subsequent material with that keyword until it encounters
another keyword in another section heading. Otherwise, the Exam Builder
ignores headings and heading levels entirely. In particular, the Exam
Builder does not use a section heading containing a keyword to create a
corresponding heading in the generated exam.

The Exam Builder recognizes these keywords when they occur in headings:

\begin{center}
\begin{tabular}{ll}
\textbf{Keyword} & \textbf{Effect} \\ 
\textsf{Answer} & Begins the correct answer to a question \\ 
\textsf{Assignment} & Identifies a file as an Exam Builder source file \\ 
\textsf{Choices} & Begins the list of possible answers for a multiple-choice
question \\ 
\textsf{Comment} & Identifies information that appears only in the source
file \\ 
\textsf{Exam} & Identifies a file as an Exam Builder source file \\ 
\textsf{Question} & Begins the information required to generate a question
\\ 
\textsf{Quiz} & Identifies a file as an Exam Builder source file \\ 
\textsf{Response} & Identifies the area in which students enter a free-form
response to a question \\ 
\textsf{Setup} & Begins a section in which certain values and variables are
set \\ 
\textsf{Solution} & Begins a detailed explanation of a problem solution \\ 
\textsf{Statement} & Presents the text of a question \\ 
\textsf{Test} & Identifies a file as an Exam Builder source file \\ 
\textsf{Text} & Begins a section of text to be transferred without change to
the generated exam \\ 
\textsf{Tutorial} & Identifies a file as an Exam Builder source file \\ 
\textsf{Variant} & Begins an alternative to the question in which the
variant occurs
\end{tabular}
\end{center}

\subsubsection{Keywords at the beginning of a paragraph}

In a Setup section certain keywords are recognized. A keyword must occur at
the start or a paragraph and be followed by a colon and then by a list of
additional keywords that serve as parameters. The Exam Builder associates
each keyword in the list with the keyword at the beginning of the paragraph.
The Exam Builder recognizes these keywords when they occur at the beginning
of a paragraph:

\begin{center}
\begin{tabular}{ll}
\textbf{Keyword} & \textbf{Effect} \\ 
\textsf{Choice Space} & Establishes the horizontal space between
multiple-choice answers \\ 
\textsf{Choices} & Begins a set of specifications for multiple-choice answers
\\ 
\textsf{Condition} & Establishes parameters for the random values assigned
to variables \\ 
\textsf{CST\ File} & Specifies a style file for formatting the exam \\ 
\textsf{Images} & Names .bmp or .dib graphics to be inserted instead of
radio buttons \\ 
\textsf{Points} & Assigns a point value to an exam question \\ 
\textsf{Print Choices} & Specifies the elements that appear instead of radio
buttons \\ 
& when multiple-choice questions are printed \\ 
\textsf{Question Space} & Establishes the vertical space between questions
\\ 
\textsf{Questions} & Begins a set of specifications for questions \\ 
\textsf{Seed} & Sets a seed value for random number generation \\ 
\textsf{Select} & Specifies the number of question variants to include on an
exam \\ 
\textsf{Submit} & Submits answers for online grading and sets the label on
the Submit button \\ 
\textsf{Text Area} & Defines the size of a free-form response area \\ 
\textsf{Title} & Establishes the information to be displayed on the title bar
\\ 
& when a generated exam is viewed online
\end{tabular}
\end{center}

\subsubsection{Keywords in lists}

When the Exam Builder encounters one of the following keywords, it
associates it with the keyword at the beginning of the paragraph. When
several of these keywords occur in a list, they must be separated by commas.

\begin{center}
\begin{tabular}{ll}
\textbf{Keyword} & \textbf{Effect} \\ 
\textsf{Break} & Places multiple-choice answers on separate lines \\ 
\textsf{Check} & Places a checkbox next to each choice in a multiple-choice
list \\ 
\textsf{No} & Prevents effects when used in combination with other keywords
\\ 
& such as \textsf{Break}, \textsf{Permute} or \textsf{Number} \\ 
\textsf{Number} & Numbers the questions on an exam \\ 
\textsf{Permute} & Changes the order in which bulleted multiple-choice items
appear \\ 
& in a list of choices or the order in which questions appear on the exam \\ 
\textsf{Radio Buttons} & Places a clickable button next to each choice in a
multiple-choice list
\end{tabular}
\end{center}

The chapters that follow explain in more detail how each keyword works.

\end{document}
