--- 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}
+