--- loncom/html/adm/help/tex/Creating_Online_Problems.tex 2005/02/04 20:51:22 1.3 +++ loncom/html/adm/help/tex/Creating_Online_Problems.tex 2013/06/26 08:14:55 1.4 @@ -1,12 +1,61 @@ \label{Creating_Online_Problems} -If you're following this as a tutorial, create one of each of -these problem types now. We'll be using them later as raw material to assemble -maps and sequences. - -While several problem types are listed here, in LON-CAPA all problems are -actually the same. All problems are written in XML, which can be obtained -and edited with the \textbf{EditXML} button. The problem types -listed in this manual are just templates. As your knowledge advances, -you may wish to play with the XML representation directly to see what you -can do. +When you create a new problem as in the figure \ref{New Content Menu}, LON-CAPA will offer +to you example templates that are highly recommended for beginners. A subset of the +problem templates is illustrated by the multiple choice selections shown in the figure +\ref{Multiple Choice Menu Figure}. Click the \textbf{Example} link next to menu item to see +an example problem. Once you make a selection, you can use the template +and edit the content to convert the template into your own problem. By default, the template problem +will be displayed in the problem testing mode with a header shown in the figure \ref{Problem Testing Menu Figure}. The problem +statement appears below the testing menu (not shown here). The menu will be described later. Click the \textbf{Edit} +button in the lower left to open the colorful editor. The EditXML button is for +advanced users. + +The menu for the colorful editor is shown in the figure \ref{Colorful Editor Menu Figure}. +\index{colorful editor}The button functions are: +\begin{itemize} + \item \textbf{Discard Edits and View} - return to the testing menu without saving + \item \textbf{EditXML} - switch to the XML Editor + \item \textbf{Undo} - forget last edits + \item \textbf{Save and Edit} - Save and continue editing in the colorful editor + \item \textbf{Save and View} - Save and return to the testing menu +\end{itemize} +An example of the colorful editor is shown in Figure \ref{Radio Response Creation Form}. +Each box in the colorful editor has a purpose, and the boxes are colored by their purpose. + +While several problem types are covered in this manual, in LON-CAPA all problems involve +similar XML elements. \index{XML editor}The menu for the XML editor is shown in the +figure \ref{XML Editor Menu Figure}. +Note that the editor includes help links at the top. The \textbf{Edit} button starts the +colorful editor. The \textbf{Edit Math} button adds latex math. The other buttons are the same as the +colorful editor buttons. If you find yourself uncertain about the name or function of an LON-CAPA xml +tag, consult the reference in section \ref{Authoring_XML_Intro}. + +\begin{figure} +\begin{center}\includegraphics[width=0.5\paperwidth]{multiple_choice_problem_menu}\end{center} + +\caption{Multiple Choice Problem Menu\label{Multiple Choice Menu Figure}} + +\end{figure} + +\begin{figure} +\begin{center}\includegraphics[width=0.8\paperwidth]{problem_testing}\end{center} + +\caption{Problem Testing Menu\label{Problem Testing Menu Figure}} + +\end{figure} + +\begin{figure} +\begin{center}\includegraphics[width=0.8\paperwidth]{problem_editing_colorful}\end{center} + +\caption{Colorful Problem Editor Menu\label{Colorful Editor Menu Figure}} + +\end{figure} + +\begin{figure} +\begin{center}\includegraphics[width=0.8\paperwidth]{problem_editing_xml}\end{center} + +\caption{XML Problem Editor Menu\label{XML Editor Menu Figure}} + +\end{figure} +