Annotation of loncom/html/adm/help/tex/Testbank_Formatting.tex, revision 1.2

1.1       albertel    1: \label{Testbank_Formatting}
                      2: 
1.2     ! raeburn     3: The following requirements must be met to ensure that you will succeed in building LON-CAPA problem files from a file containing testbank questions.
1.1       albertel    4: 
                      5: \begin{enumerate}
                      6: 
1.2     ! raeburn     7: \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).
1.1       albertel    8: 
                      9: \item All questions must occur before any of the answers.  Each
1.2     ! raeburn    10: question should begin on a new line starting with a number followed
1.1       albertel   11: immediately by a space, a period, or enclosed in parentheses, i.e., 1
1.2     ! raeburn    12: , 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.  
1.1       albertel   13: 
1.2     ! raeburn    14: \item One or more correct answers need to be provided for all questions
        !            15: (although the answer text may be blank for \textit{essay} questions).
        !            16: Each answer should begin on a new line using the same numbering scheme as used
        !            17: for the questions, and all answers must occur after all the questions.
1.1       albertel   18: 
                     19: \item \textit{Multiple choice} and \textit{multiple answer correct}
                     20: questions should consist of (i) the question number followed by (ii) a
                     21: question stem beginning on the same line and (iii) two or more foils,
                     22: with each foil beginning on a new line and prefixed by a unique
                     23: letter, or Roman numeral, listed in alphabetic or numeric order,
                     24: beginning at a (alphabetic) or i (Roman numeral), followed by a
                     25: period, or enclosed in parentheses, i.e., a., (a), i., or (i)
                     26: 
                     27: \item If \textit{fill-in-the-blank} or \textit{multiple answer}
                     28: questions have more than one correct answer, each answer should appear
1.2     ! raeburn    29: 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)]
1.1       albertel   30: 
                     31: \end{enumerate}
                     32: 

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>