[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Testbank_Formatting.tex

[raeburn]

raeburn		Tue Jul  8 01:56:44 2008 EDT

  Modified files:              
    /loncom/html/adm/help/tex	Testbank_Formatting.tex 
  Log:
  - Testbank import supports RTF and HTML as well as plain text
  - Description of answer format for Ordering/Ranking questions. 
  
  
Index: loncom/html/adm/help/tex/Testbank_Formatting.tex
diff -u loncom/html/adm/help/tex/Testbank_Formatting.tex:1.1 loncom/html/adm/help/tex/Testbank_Formatting.tex:1.2
--- loncom/html/adm/help/tex/Testbank_Formatting.tex:1.1	Wed Jul  5 18:23:12 2006
+++ loncom/html/adm/help/tex/Testbank_Formatting.tex	Tue Jul  8 01:56:44 2008
@@ -1,22 +1,20 @@
 \label{Testbank_Formatting}
 
-Four requirements must be met to ensure that you will succeed in building LON-CAPA problem files using your plain text file containing testbank questions.
+The following requirements must be met to ensure that you will succeed in building LON-CAPA problem files from a file containing testbank questions.
 
 \begin{enumerate}
 
-\item The questions and answers you upload must be in plain text
-format.  Any header lines should occur before the text containing the
-questions and answers.
+\item The uploaded testbank file containing questions and answers must be either plain text, rich text format (RTF), or a web page (i.e., HTML format). Testbank files in RTF and HTML formats may contain images.  If conversion to LON-CAPA fails for RTF or HTML formats, re-saving the testbank file from the application originally used to generate it in plain text, and re-uploading the file to LON-CAPA may solve the problem (albeit with the loss of formatting information).
 
 \item All questions must occur before any of the answers.  Each
-question should be numbered sequentially using a number followed
+question should begin on a new line starting with a number followed
 immediately by a space, a period, or enclosed in parentheses, i.e., 1
-, 1., (1), 1), or (1 .
+, 1., (1), 1), or (1 .  If you use a word processor to create the testbank questions you must disable auto-formatting of lists, otherwise the formatting will not conform to the new line requirement.  
 
-\item One or more correct answers should be provided for all questions
-(although blank answers may be provided for \textit{essay} questions).
-Answers should be numbered sequentially, using the same scheme as used
-for the questions, and must occur after all the questions.
+\item One or more correct answers need to be provided for all questions
+(although the answer text may be blank for \textit{essay} questions).
+Each answer should begin on a new line using the same numbering scheme as used
+for the questions, and all answers must occur after all the questions.
 
 \item \textit{Multiple choice} and \textit{multiple answer correct}
 questions should consist of (i) the question number followed by (ii) a
@@ -28,7 +26,7 @@
 
 \item If \textit{fill-in-the-blank} or \textit{multiple answer}
 questions have more than one correct answer, each answer should appear
-in a comma-, tab-, space-, or new line-delimited list.
+in a comma-, tab-, space-, or new line-delimited list. For a  \textit{ranking/ordering} question, the "answer" should contain the foil identifiers correctly ordered in a similarly delimited list. If two or more foils have the same ranking, they should occur together, with an equals sign separating equally ranked foils [e.g., (b),(e)=(a),(d),(c)]
 
 \end{enumerate}