# [LON-CAPA-cvs] cvs: loncom /html/adm/help/tex About_Authors_Manual.tex Author_Menu.tex Author_Remote_Control.tex Construction_Space_Overview.tex Content_Page_Overview.tex Creating_Content_Overview.tex Creating_Formula_Response.tex Creating_Math_Response_Problems.tex Creating_New_Content_Pages.tex Creating_Online_Problems.tex Creating_Radio_Response_Problems.tex Custom_Response_Problem_Creation.tex Custom_Response_Problems.tex Dynamic_Plot_Overview.tex Foils.tex Formula_Response_Problems.tex Function_Plot_Response_Evaluation_Rule.tex Function_Plot_Response_Overview.tex Function_Plot_Response_Question.tex How_To_Edit_Existing_Content_Pages.tex Latex_Footer.tex Latex_Header.tex Math_Response_Problems.tex Numerical_Response_Advanced_Example.tex Numerical_Response_Introduction.tex Option_Response_Problem_Creation.tex Problem_Types.tex Publishing_A_Resource.tex Publishing_Copyright.tex Resource_Types.tex Roles_Screen.tex Sequence_Editor_Selection.tex String_Response_Problem_Creation.tex! Variables_in_the_Text_Block.tex

lira lira at source.lon-capa.org
Wed Jun 26 04:14:56 EDT 2013

lira		Wed Jun 26 08:14:56 2013 EDT

Creating_Content_Overview.tex
Creating_Formula_Response.tex
Creating_Math_Response_Problems.tex
Custom_Response_Problem_Creation.tex
Dynamic_Plot_Overview.tex
Function_Plot_Response_Overview.tex

Modified files:
Author_Remote_Control.tex
Construction_Space_Overview.tex
Creating_New_Content_Pages.tex
Creating_Online_Problems.tex
Custom_Response_Problems.tex Foils.tex
Formula_Response_Problems.tex
Function_Plot_Response_Evaluation_Rule.tex
Function_Plot_Response_Question.tex
How_To_Edit_Existing_Content_Pages.tex
Math_Response_Problems.tex
Numerical_Response_Introduction.tex
Option_Response_Problem_Creation.tex
Problem_Types.tex
Publishing_A_Resource.tex
Resource_Types.tex Roles_Screen.tex
Sequence_Editor_Selection.tex
String_Response_Problem_Creation.tex
Variables_in_the_Text_Block.tex
Log:
editing author manual

-------------- next part --------------
@@ -1,11 +1,10 @@
-
-Throughout this manual, keywords and phrases literally present on the computer
-screen will be referred to in \textbf{bold type}. Function names and scripts
-will be shown in a \texttt{typewriter font}.
-
-Much of this document can be used as a tutorial that will introduce you to
-the authoring system.
-
-For additional help, search the loncapa listservs at \texttt{http://mail.lon-capa.org/mailman/swish.cgi}.
-
+
+Throughout this manual, keywords and phrases literally present on the computer
+screen will be referred to in \textbf{bold type}. Function names and scripts
+will be shown in a \texttt{typewriter font}.
+
+Much of this document can be used as a tutorial that will introduce you to
+the authoring system. For additional help, contact the helpdesk or search the loncapa listservs at\\
+\texttt{http://mail.lon-capa.org/mailman/swish.cgi}.
+
@@ -2,4 +2,4 @@

--- loncom/html/adm/help/tex/Author_Remote_Control.tex:1.4	Mon Jun 10 21:29:19 2013
+++ loncom/html/adm/help/tex/Author_Remote_Control.tex	Wed Jun 26 08:14:55 2013
@@ -2,31 +2,30 @@

\textbf{Remote Control}

-LON-CAPA also offers a \textbf{Remote Control} menu. The Remote Control is a separate pop-up browser window, and is automatically
-sized and placed in the upper left of the screen. To enable and experiment with the Remote Control menu, navigate to: Main Menu>My Space>Set my user preferences>Content Display Settings>Launch Remote Control. To exit from the remote, either close the window, or look for the inline menu command to exit on the upper right of the parent browser window.
+LON-CAPA also offers a \textit{Remote Control} menu. The Remote Control is a separate pop-up browser window, and is automatically
+sized and placed in the upper left of the screen. To enable and experiment with the Remote Control menu, navigate to: Main Menu $\rangle$ My Space $\rangle$ Set my user preferences $\rangle$ Content Display Settings $\rangle$ Launch Remote Control. To exit from the remote, either close the window, or look for the inline menu command to exit on the upper right of the parent browser window.

Hints for each button appear when hovering over the buttons. Click the words \textit{Extended Display} immediately above the remote command display to obtain a list of hints.
%
\begin{figure}
-\begin{center}\includegraphics[  height=0.50\paperwidth]{authorRemote}\end{center}
+\begin{center}\includegraphics[  height=0.30\paperwidth]{authorRemote}\end{center}

\caption{Author Remote Control\label{Author Remote Control Figure}}
\end{figure}

-The commands on the remote change depending on whether you are in a construction space role or course role. Some of the important commands on the Remote Control are:
+The commands on the remote change depending on whether you are in a authoring role or course role. Some of the important commands on the Remote Control are:

\begin{itemize}
-\item \textbf{ROLES (CHOOSE ROLE)} allows you to select which user role to assume
-for this session.
+\item \textbf{ROLES (CHOOSE ROLE)} opens the roles screen for you to select which user role to assume.
+\item \textbf{CCAT (COURSE CATALOG)} opens search for courses/communities.
+\item \textbf{CUSR (CHANGE USER PRIV)} add/manage user privileges.
+\item \textbf{CSTR (CONSTRUCTION SPACE)} displays the authoring (construction) space for your account.
+\item \textbf{RES (RESOURCE SPACE)} allows you to browse the LON-CAPA network directory. (Searching resource space is usually preferred unless you know where to look for a particular resource.)
\item \textbf{COM (COMMUNICATION)} allows you to access the communication functions
in the system.
-\item \textbf{CUSR (USER ROLES)} brings up a page that allows you to create new
-users and change user privileges.
-\item \textbf{CSTR (CONSTRUCT)} displays the construction space for your account.
-\item \textbf{RES (RESOURCE SPACE)} allows you to browse the LON-CAPA network directory.
-\item \textbf{SRC (SEARCH LIBRARY)} brings up a screen that lets you search the
+\item \textbf{SRCH (SEARCH LIBRARY)} brings up a screen that lets you search the
LON-CAPA resources using multiple criteria.
\item \textbf{PREF (PREFERENCES)} brings up a screen that allows you to change
some preferences.
--- loncom/html/adm/help/tex/Construction_Space_Overview.tex:1.3	Tue Jun  4 23:19:42 2013
+++ loncom/html/adm/help/tex/Construction_Space_Overview.tex	Wed Jun 26 08:14:55 2013
@@ -1,50 +1,47 @@
-\label{Construction_Space_Overview}
-
-%
-\begin{figure}
-\begin{center}\includegraphics[  width=0.80\paperwidth]{constructionSpace}\end{center}
-
-
-\caption{Authoring Space\label{Authoring Space Figure}}
-
-Contents of the Authoring Space:
-
-\begin{tabular}{|c|p{5in}|}
-\hline
-\textbf{Button Name}&
-\textbf{Description}\\
-\hline
-\hline
-Publish this Resource&
-Opens the Resource Publishing window.\\
-\hline
-List Directory&
-Lists the contents of the current working directory\\
-\hline
-Copy&
-Type a new name in the entry box to make a copy the current resource\\
-\hline
-Browse&
-Helps you select a file to upload\\
-\hline
-\hline
-Retrieve Old Version&
-Load an older version of a resource if you have multiple versions\\
-\hline
-Delete&
-Deletes the current resource\\
-\hline
-Rename&
-Type a new name in the associated entry box to rename a resource\\
-\hline
-New Subdirectory&
-Type a name in the entry box to create a new directory\\
-\hline
-\end{tabular}
-\end{figure}
-The Authoring Space
-is the section of LON-CAPA where you create and manage your course resources.
-The figure explains what each button does.
-
+\label{Construction_Space_Overview}
+
+%
+The Authoring Space is the environment of LON-CAPA where you create and manage your course resources. Creating content involves both \textit{authoring} the resource during editing, and then \textit{publishing} the resource to make it available for use in courses. The figure \ref{Authoring Space Figure} shows the top menu. The username includes a dropdown box where you can edit preferences.
+
+\begin{itemize}
+	\item\textbf{Authoring Space} returns you to the current authoring space.
+	\item\textbf{Browse} provides a link to published resources.
+\end{itemize}
+The gray bar under the menu provides a clickable bread crumb trail. The current \textbf{authoring space} folder location is displayed near the bottom of the figure \ref{Authoring Space Figure}, and is clickable. The \textbf{Recent} dropdown box lists recent folder locations for quick navigation.
+
+The upper right menu is not shown here, but includes the following links:
+\begin{itemize}
+	\item\textbf{Roles} returns you to your roles page.
+	\item\textbf{Logout} is a link to close the session.
+\end{itemize}
+
+At the bottom of the page is a directory as shown in the figure \ref{Example Directory Figure}. On the left edge, icons help identify the content type. The \textbf{Actions} dropdown provides commands to move, copy, paste, publish the resource or other content-type-dependent options. The \textbf{Name} column provides a link to the resource or folder. The \textbf{Title} column provides a link to the meta data provided to help other users find your resource. The \textbf{Status} column shows whether the resource is \textbf{Published, Unpublished, or Obsolete.} The vertical bar (pink in the figure) color denotes the status: Green (published); Pink (unpublished); Gray (obsolete).
+
+ In the center of the page are three action menus: \textbf{Actions for current directory, Upload a new document, Create a new directory or LON-CAPA document}. The first two menus are intuitive when exploring them. The third menu is shown in the figure \ref{New Content Menu} and new content types are described later in this manual.
+
+\begin{figure}
+
+\caption{Authoring Space Upper Menu\label{Authoring Space Figure}}
+
+\end{figure}
+
+\begin{figure}
+\begin{center}\includegraphics[width=0.8\paperwidth]{author_example_directory}\end{center}
+
+\caption{Example of Author Directory\label{Example Directory Figure}}
+
+\end{figure}
+
+\begin{figure}
+\begin{center}\includegraphics[width=0.5\paperwidth]{author_new_content}\end{center}
+
+
+\end{figure}
+
--- loncom/html/adm/help/tex/Creating_New_Content_Pages.tex:1.7	Tue Jun  4 23:19:42 2013
+++ loncom/html/adm/help/tex/Creating_New_Content_Pages.tex	Wed Jun 26 08:14:55 2013
@@ -1,34 +1,33 @@
-\label{Creating_New_Content_Pages}
-\label{Creating New Content Pages}
-
-\textbf{Content Pages} are HTML documents that display the course information
-you are presenting.
-
-Many users use tools such as Dreamweaver to create web pages. To upload HTML
-files generated with such tools, you can use the \textbf{Browse} button in
-File} button to create a content page in LON-CAPA. Remember to upload any
-graphics your generated web pages may have included.
-
-To create new Content Pages, do the following:
-
-\begin{enumerate}
-\item Click the \textbf{CSTR} button on the LON-CAPA remote. Your web page will
-\item In the Location bar of your browser, type in the full URL of the new Content
-Page. Make sure the last part of the URL ends with {}.html'', for example,
-\\
-Press the Return or Enter key.
-\item Type the content into the editor, \emph{OR} copy and paste HTML source code
-obtained through the use of some other HTML authoring program into the editor.
-\item Optionally, click the \textbf{View} button to preview your Content Page.
-\item Finally, click the \textbf{Save this} button \emph{OR} click the \textbf{Save
-and then attempt to clean HTML} button.
-\end{enumerate}
-Repeat this process as many times as necessary to create your Content Pages.
-
-If you're following this as a tutorial, create at least one content page,
-which we'll use later as raw material. Visit the FAQ at \texttt{http://help.lon-capa.org/} if you get {}unmatched
-tag'' warnings.
-
+\label{Creating_New_Content_Pages}
+
+\index{HTML pages}Many users use tools stand-alone editing programs such as Dreamweaver to create
+files generated with such tools, you can use the \textbf{Browse...} button in
+File} button to upload a HTML file in LON-CAPA. Remember to upload any local
+graphics your generated web pages may have referenced using similar procedures. The links to graphics in your html page must match the relative locations for the uploaded files.
+
+To create a new html page using the Inline Menus, browse to the desired folder using the folder navigation links in the lower part of the authoring screen. Then select 'HTML file' from the new content dropdown menu on the right of the authoring space page as shown in the dropdown menu of the figure \ref{New Content Menu}
+
+You will be presented with a plain text editor as shown in the figure \ref{Plain Text HTML Editor}. Clicking the link for the Rich Formatting displays the HTML WYSIWYG editor with buttons to help you create html entities with correct tags as shown in the figure \ref{Rich Text HTML Editor}. If the rich layout is not as you expect, look for the button to view/edit the source, and then manually make adjustments to the html tags. Note that buttons are available to select graphics to include in the HTML file. Buttons are also provided to create/edit links.
+
+To create equations, you can use the 'Edit Math' button in the plain text editor, or you can type LATEX equations directly in the \texttt{<m></m>} tags in the plain text editor.
+
+Note that convenient help links for \textbf{Greek Symbols, Other Symbols, and Output Tags}\index{Greek symbols}\index{symbols, html}\index{output tags} immediately above the editor in the figures. Also note the link to check spelling below the editor.\index{spelling checker}
+
+The URL of the page in the root of your space would look something like
+\\
+\begin{figure}
+\begin{center}\includegraphics[  width=0.80\paperwidth]{html_page_plaintext}\end{center}
+
+
+\caption{Plain Text HTML Editor}\label{Plain Text HTML Editor}
+\end{figure}
+\begin{figure}
+\begin{center}\includegraphics[  width=0.80\paperwidth]{html_page_richtext}\end{center}
+
+
+\caption{Rich Text HTML Editor}\label{Rich Text HTML Editor}
+\end{figure}
+
--- loncom/html/adm/help/tex/Creating_Online_Problems.tex:1.3	Fri Feb  4 20:51:22 2005
+++ loncom/html/adm/help/tex/Creating_Online_Problems.tex	Wed Jun 26 08:14:55 2013
@@ -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
-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
+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
+
+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{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
+\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
+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}
+
+
+\end{figure}
+
+\begin{figure}
+\begin{center}\includegraphics[width=0.8\paperwidth]{problem_testing}\end{center}
+
+
+\end{figure}
+
+\begin{figure}
+\begin{center}\includegraphics[width=0.8\paperwidth]{problem_editing_colorful}\end{center}
+
+
+\end{figure}
+
+\begin{figure}
+\begin{center}\includegraphics[width=0.8\paperwidth]{problem_editing_xml}\end{center}
+
+
+\end{figure}
+
@@ -1,16 +1,9 @@

-%
-\begin{figure}
-\begin{center}\includegraphics[  width=0.80\paperwidth]{creatingNewProblemResource}\end{center}
-
-
-\caption{Creating A New Problem Resource\label{Creating a new problem resource}}
-\end{figure}
-as described in section \ref{Creating New Content Pages}. This is a {}problem''
+as described in section \ref{Creating_Content_Overview}. This is a {}problem''
resource so the URL must end in {}.problem''. You should see a screen
-as in figure \ref{Creating a new problem resource}.%
+as in figure \ref{New Content Menu}.
\begin{figure}

@@ -20,11 +13,8 @@
You will need to specify the question text and foil statements.

\begin{enumerate}
-\item In the drop-down option box,
-select \textbf{Radio Response Problem}, and click the \textbf{New Problem}
-button.
-\item Click the \textbf{Edit} button above the sample problem to enter edit mode.
-You should see an editing screen.
+\item Select a radio response template from the menu. You will be presented a form such as in
+the figure \ref{Radio Response Creation Form}
\item In the \textbf{Text Block} at the top of the problem, remove the sample text
and type the question for your problem. Ex: {}What is two plus
two?''
@@ -49,7 +39,7 @@

\caption{Hint Element\label{Radio Response Hint Element Figure}}
\end{figure}
-\item Scroll down to the Hint element.
+\item Scroll down to the Hint element. See the figure \ref{Radio Response Hint Element Figure}
Type some text that will help students when they answer incorrectly. You
may delete the hint by selecting \textbf{Yes} from the \textbf{Delete} drop-down
box.
--- loncom/html/adm/help/tex/Custom_Response_Problems.tex:1.6	Fri Jan 20 04:14:04 2012
+++ loncom/html/adm/help/tex/Custom_Response_Problems.tex	Wed Jun 26 08:14:55 2013
@@ -1,64 +1,2 @@
-\label{Custom_Response_Problems}
-Custom Response is a way to have a problem graded based on an algorithm. The use of this response type is
-generally discouraged, since the responses will not be analyzable by the LON-CAPA statistics tools.
-
-For a single textfield, the student's answer will be in a variable \$submission. If the Custom Response has multiple textfields, the answers will be in an array -reference, and can be accessed as \$\$submission[0], \$\$submission[1], etc. - -The student answer needs to be evaluated by Perl code inside the <answer>-tag. Custom Response needs to return a standard LON-CAPA. The most common response are: -\begin{itemize} -\item EXACT\_ANS: return if solved exactly correctly -\item APPROX\_ANS: return if solved approximately -\item INCORRECT: return if not correct, uses up a try -\item ASSIGNED\_SCORE: partial credit (also return the credit factor, e.g. return(ASSIGNED\_SCORE,0.3);) -\item SIG\_FAIL, NO\_UNIT, EXTRA\_ANSWER, MISSING\_ANSWER, BAD\_FORMULA, -WANTED\_NUMERIC, WRONG\_FORMAT: return if not correct for different reasons, does not use up a try -\end{itemize} -The answer display is shown instead of the student response in 'show answer' mode. -The following example illustrates this: -\begin{verbatim} -<problem> -<startouttext />Accept an answer of around 90 or -90<endouttext /> - <customresponse answerdisplay="something near 90 or -90"> - <answer type="loncapa/perl"> -# We do not want a vector -if ($submission=~/\,/) { return 'EXTRA_ANSWER'; }
-# Need a numerical answer here
-if ($submission!~/^[\d\.\-\e]+$/i) { return 'WANTED_NUMERIC'; }
-$difference=abs(90-abs($submission));
-if ($difference==0) { return 'EXACT_ANS'; } -if ($difference < 0.1) { return 'APPROX_ANS'; }
-  </customresponse>
-</problem>
-\end{verbatim}
-
-
-Full list of possible return codes:
-\begin{itemize}
-\item EXACT\_ANS: student is exactly correct
-\item APPROX\_ANS:  student is approximately correct
-\item NO\_RESPONSE: student submitted no response
-\item MISSING\_ANSWER: student submitted some but not all parts of a response
-\item EXTRA\_ANSWER: student submitted a vector of values when a scalar was expected
-\item WANTED\_NUMERIC: expected a numeric answer and didn't get one
-\item SIG\_FAIL: incorrect number of Significant Figures
-\item UNIT\_FAIL: incorrect unit
-\item UNIT\_NOTNEEDED: submitted a unit when one shouldn't
-\item UNIT\_INVALID\_INSTRUCTOR: the unit provided by the author of the problem is unparsable
-\item UNIT\_INVALID\_STUDENT: the unit provided by the student is unparasable
-\item UNIT\_IRRECONCIBLE: the unit from the student and the instructor are of different types
-\item NO\_UNIT: needed a unit but none was submitted
-\item BAD\_FORMULA: syntax error in submitted formula
-\item WRONG\_FORMAT: student submission did not have the expected format
-\item DRAFT: submission only stored
-\item MISORDERED\_RANK: student submitted a poorly order rank response
-\item ERROR: unable to get a grade
-\item ASSIGNED\_SCORE: partial credit; the customresponse needs to return the award followed by the partial credit factor
-\item TOO\_LONG: answer submission was deemed too long
-\item INVALID\_FILETYPE: student tried to upload a file that was of an extension that was not specifically allowed
-\item COMMA\_FAIL: answer requires the use of comma grouping and it wasn't provided or was incorrect
-\end{itemize}
+\label{Custom_Response_Problems}
+Custom Response is a way to have a problem graded based on an algorithm constructed in the perl script. The use of this response type is generally discouraged, since the responses will not be analyzable by the LON-CAPA statistics tools.
--- loncom/html/adm/help/tex/Foils.tex:1.2	Thu Jul 18 15:52:27 2002
+++ loncom/html/adm/help/tex/Foils.tex	Wed Jun 26 08:14:55 2013
@@ -1,5 +1,5 @@
\label{Foils}

-In the LON-CAPA system, a \textbf{Foil\index{Foil}} is the statement after
+In the LON-CAPA system, a \textbf{Foil\index{Foil}} is the statement next to
the drop-down box or radio button in a Radio Response or Option Response
problem. Foils do not need to be text; they can be images or other resources.
--- loncom/html/adm/help/tex/Formula_Response_Problems.tex:1.3	Fri Feb  4 21:02:54 2005
+++ loncom/html/adm/help/tex/Formula_Response_Problems.tex	Wed Jun 26 08:14:55 2013
@@ -1,14 +1,7 @@
\label{Formula_Response_Problems}

\index{Formula Response}\label{Formula Response}
-
%
-\begin{figure}
-\begin{center}\includegraphics[  width=0.80\paperwidth]{formulaResponse}\end{center}
-
-
-\caption{Formula Response Problem}
-\end{figure}
\textbf{Formula Response} problems ask the student to type in a formula as an answer.
If the answer is $2x^{2}+4$, the student is allowed to type {}2{*}x{*}x+4'',
{}x{*}x + x{*}x + 4'', {}2{*}x\textasciicircum{}2 + 14 - 10'', or
--- loncom/html/adm/help/tex/Function_Plot_Response_Evaluation_Rule.tex:1.5	Thu Dec  1 19:15:34 2011
+++ loncom/html/adm/help/tex/Function_Plot_Response_Evaluation_Rule.tex	Wed Jun 26 08:14:55 2013
@@ -24,7 +24,7 @@

The figure below shows some examples of rules.

-\includegraphics[width=0.8\paperwidth]{FPRexamples}
+\includegraphics[height=1\paperwidth]{FPRexamples}

\begin{enumerate}

--- loncom/html/adm/help/tex/Function_Plot_Response_Question.tex:1.1	Fri Jan 14 01:56:37 2011
+++ loncom/html/adm/help/tex/Function_Plot_Response_Question.tex	Wed Jun 26 08:14:55 2013
@@ -1,5 +1,7 @@
\label{Function_Plot_Response_Question}

+Creating a \textbf{Function Plot Response} problem involves several steps. This section introduces the major settings and subsequent sections cover other details.
+
Label x-axis'' and Label y-axis'' - Enter the label and/or units for the axes on the graph.  Leaving them blank will result in no axis labels.

Minimum x-value'', Maximum x-value'', Minimum y-value'', and Maximum y-value'' - Entering values here will set the value of the graph at the left, right, bottom, and top edges (respectively).  Default is -10, 10, -10, and 10 respectively.
@@ -10,7 +12,7 @@

Background plot(s) for answer'' - This is a green curve the computer will display once the correct answer has been submitted.  It is static, and can be given as a piecewise function.  Since some problems will have multiple correct answers, this necessarily will only be a possible answer.  Only the left hand side of the equation is necessary.  For example, entering $x+2$ will display the line $y=x+2$.  The syntax must be syntax recognized by GeoGebra.  To test syntax for Geogebra directly, visit http://www.geogebra.org/webstart/geogebra.html .

-The tag should include
+The tag should include the following additional subsections
\begin{itemize}
\item Response Elements
\item Rule Set
--- loncom/html/adm/help/tex/How_To_Edit_Existing_Content_Pages.tex:1.3	Tue Jun  4 23:19:42 2013
+++ loncom/html/adm/help/tex/How_To_Edit_Existing_Content_Pages.tex	Wed Jun 26 08:14:55 2013
@@ -5,16 +5,7 @@
To edit Content Pages:

\begin{enumerate}
-\item Click the \textbf{CSTR} button on the LON-CAPA Remote. Your web page will
-\item Click on the link for the name of the Content Page to edit. The Content Page
-editor will load and display the current edition of the Content Page.
-\item Press the \textbf{Edit} button. Edit the HTML code, or copy and paste HTML
-source code into the editor.
-\item Finally, click the \textbf{Save this} button \emph{OR} click the \textbf{Save
-and then attempt to clean HTML} button. If you do not do this, your work
-will not be saved.
+\item Navigate to the folder with the HTML file.
+\item Click on the link for the name of the HTML file to edit.
\end{enumerate}
-Once you've saved your page, you can click the \textbf{View} button to preview

--- loncom/html/adm/help/tex/Latex_Footer.tex:1.2	Thu Jul 18 15:52:27 2002
+++ loncom/html/adm/help/tex/Latex_Footer.tex	Wed Jun 26 08:14:55 2013
@@ -1,3 +1,4 @@
\label{Latex_Footer}
+\printindex

\end{document}
@@ -1,38 +1,38 @@
-%% Do not edit unless you really know what you are doing.
-\documentclass[12pt,english]{article}
-%\usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
-\usepackage{geometry}
-\usepackage{amsmath}
-\usepackage{graphicx}
-\usepackage{longtable}
-\usepackage{makeidx}
-\makeindex
-
-\makeatletter
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LyX specific LaTeX commands.
-\providecommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Textclass specific LaTeX commands.
- \usepackage{verbatim}
- \newenvironment{lyxcode}
-   {\begin{list}{}{
-     \setlength{\rightmargin}{\leftmargin}
-     \raggedright
-     \setlength{\itemsep}{0pt}
-     \setlength{\parsep}{0pt}
-     \normalfont\ttfamily}%
-    \item[]}
-   {\end{list}}
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
-\usepackage{floatflt}
-
-\usepackage{babel}
-\makeatother
-\begin{document}
-
+%% Do not edit unless you really know what you are doing.
+\documentclass[12pt,english]{article}
+%\usepackage[T1]{fontenc}
+\usepackage[latin1]{inputenc}
+\usepackage{geometry}
+\usepackage{amsmath}
+\usepackage{graphicx}
+\usepackage{longtable}
+\usepackage{makeidx}
+\makeindex
+
+\makeatletter
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% LyX specific LaTeX commands.
+\providecommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Textclass specific LaTeX commands.
+ \usepackage{verbatim}
+ \newenvironment{lyxcode}
+   {\begin{list}{}{
+     \setlength{\rightmargin}{\leftmargin}
+     \raggedright
+     \setlength{\itemsep}{0pt}
+     \setlength{\parsep}{0pt}
+     \normalfont\ttfamily}%
+    \item[]}
+   {\end{list}}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
+\usepackage{floatflt}
+
+\usepackage{babel}
+\makeatother
+\begin{document}
+
--- loncom/html/adm/help/tex/Math_Response_Problems.tex:1.3	Mon Aug  6 22:01:24 2012
+++ loncom/html/adm/help/tex/Math_Response_Problems.tex	Wed Jun 26 08:14:55 2013
@@ -1,84 +1,7 @@
\label{Math_Response_Problems}
-Math Response is a way to have a problem graded based on an algorithm that is executed inside of a computer algebra system.
-It is extremely powerful, as it tests answers for conditions rather than agreement with a particular correct answer. An unfortunate
-byproduct, however, is that it cannot be analyzed by several of the LON-CAPA statistics tools.
-
-Which computer algebra system is to be used is specified in the cas argument of the mathresponse tag; currently, only Maxima is available.
-LON-CAPA sets up two arrays inside the computer algebra system: RESPONSE and LONCAPALIST. RESPONSE contains the student input by component, for example, if "3,42,17" is entered, RESPONSE[2] would be 42. LONCAPALIST contains the arguments passed in the args of mathresponse.
-
-The answerdisplay is what is displayed when the problem is in "Show Answer" mode.
-
-The following example illustrates this.
-\begin{verbatim}
-<problem>
-  <script type="loncapa/perl">
-$a1 = random(-6,6,4); -$a2 = random(-6,6,4);
-$n1 = random(3,11,2); -$n2 = random(2,10,2);
-$function = "$a1*cos($n1*x)+$a2*sin($n2*x)"; -$example=&xmlparse('An example would be <m eval="on">$(sin($n1\cdot x)+cos($n2\cdot x))/\sqrt{2}$</m>');
-  </script>
-
-<startouttext />
-  Give an example of a function
-  <ol>
-    <li>
-        which is orthogonal to <algebra>$function</algebra> with respect to the - scalar product - <m> - $<g \mid h> = - \frac{1}{\pi} \int_{-\pi}^{\pi}dx g(x) \cdot h(x)$ - </m> - </li> - <li> - whose norm is 1. - </li> - </ol> -<endouttext /> - -<mathresponse answerdisplay="$example" cas="maxima" args="$function"> - <answer> -overlap:integrate((RESPONSE[1])*(LONCAPALIST[1]),x,-%pi,%pi)/%pi; -norm:integrate((RESPONSE[1])*(RESPONSE[1]),x,-%pi,%pi)/%pi; -is(overlap=0 and norm=1); - </answer> - <textline readonly="no" size="50" /> - <hintgroup showoncorrect="no"> - <mathhint name="ortho" args="$function" cas="maxima">
-overlap: integrate((LONCAPALIST[1])*(RESPONSE[1]),x,-%pi,%pi)/%pi;
-is(not overlap = 0);
-        </mathhint>
-        <mathhint name="norm" args="$function" cas="maxima"> - <answer> -norm: integrate((RESPONSE[1])*(RESPONSE[1]),x,-%pi,%pi)/%pi; -is(not norm = 1); - </answer> - </mathhint> - <hintpart on="norm"> - <startouttext /> -The function you have provided does not have a norm of one. - <endouttext /> - </hintpart> - <hintpart on="ortho"> - <startouttext /> -The function you have provided is not orthogonal. - <endouttext /> - </hintpart> - </hintgroup> -</mathresponse> +Math Response is a way to have a problem graded based on an algorithm that is executed inside of a +computer algebra system based on an algorithm written by the problem author. It is extremely powerful, +as it tests answers for conditions rather than agreement with a particular correct answer. An unfortunate +byproduct, however, is that it cannot be analyzed by several of the LON-CAPA statistics tools. -<postanswerdate> - <startouttext /> - <p> -Note that with respect to the above norm, <m>$\cos(nx)$</m> is perpendicular -to <m>$\sin(nx)$</m> and perpendicular to <m>$\cos(mx)$</m> for -<m>$n\ne m$</m>. - </p> - <endouttext /> -</postanswerdate> -</problem> -\end{verbatim} Index: loncom/html/adm/help/tex/Numerical_Response_Advanced_Example.tex diff -u loncom/html/adm/help/tex/Numerical_Response_Advanced_Example.tex:1.3 loncom/html/adm/help/tex/Numerical_Response_Advanced_Example.tex:1.4 --- loncom/html/adm/help/tex/Numerical_Response_Advanced_Example.tex:1.3 Tue Feb 15 14:59:30 2005 +++ loncom/html/adm/help/tex/Numerical_Response_Advanced_Example.tex Wed Jun 26 08:14:55 2013 @@ -7,8 +7,10 @@ \caption{Slope Problem Parameters\label{Slope Problem Parameters Figure}} \end{figure} - Try filling out your problem with the parameters shown in the Slope - Problem Parameters'' figure. +Now you have all the tools to create those wonderful dynamic, randomized problems that you've seen in +LON-CAPA. Consider a Numerical Response problem where the equations for two lines are randomly generated +and the students are asked to find the intercept. Try filling out your problem with the parameters shown +in Figure \ref{Slope Problem Parameters Figure}.. When creating randomized problems, you want to make sure that the problems always have an answer. Consider what might happen if two Index: loncom/html/adm/help/tex/Numerical_Response_Introduction.tex diff -u loncom/html/adm/help/tex/Numerical_Response_Introduction.tex:1.3 loncom/html/adm/help/tex/Numerical_Response_Introduction.tex:1.4 --- loncom/html/adm/help/tex/Numerical_Response_Introduction.tex:1.3 Tue Feb 15 14:45:13 2005 +++ loncom/html/adm/help/tex/Numerical_Response_Introduction.tex Wed Jun 26 08:14:55 2013 @@ -8,6 +8,6 @@ knowledge necessary. The more you learn, the more you will find you can do. If you like, you can follow this chapter as its own tutorial. Create -a Numerical Response problem using the instructions in section \ref{Creating New Content Pages}, +a Numerical Response problem using the instructions in section \ref{Creating_Content_Overview}, ending your resource name with {}.problem'', and create a new \textbf{Simple Numerical Response} problem. Index: loncom/html/adm/help/tex/Option_Response_Problem_Creation.tex diff -u loncom/html/adm/help/tex/Option_Response_Problem_Creation.tex:1.3 loncom/html/adm/help/tex/Option_Response_Problem_Creation.tex:1.4 --- loncom/html/adm/help/tex/Option_Response_Problem_Creation.tex:1.3 Tue Feb 8 16:32:18 2005 +++ loncom/html/adm/help/tex/Option_Response_Problem_Creation.tex Wed Jun 26 08:14:55 2013 @@ -1,12 +1,12 @@ \label{Option_Response_Problem_Creation} To create an Option Response problem, create a new resource as described -in section \ref{Creating New Content Pages}. This is a {}problem'' resource +in section \ref{Creating_Content_Overview}. This is a {}problem'' resource so the URL must end in {}.problem''. You should see a screen as in figure Option Response Editor''. \begin{enumerate} -\item In the drop-down option box as seen in figure \ref{Creating a new problem resource}, +\item In the drop-down option box as seen in figure \ref{New Content Menu}, select \textbf{Option Response Problem with} \textbf{\emph{N}} \textbf{Concept Groups}, where \textbf{\emph{N}} is the number of Concept Groups you wish the problem to have, and click the \textbf{New Problem} button. Index: loncom/html/adm/help/tex/Problem_Types.tex diff -u loncom/html/adm/help/tex/Problem_Types.tex:1.2 loncom/html/adm/help/tex/Problem_Types.tex:1.3 --- loncom/html/adm/help/tex/Problem_Types.tex:1.2 Thu Jul 18 15:52:27 2002 +++ loncom/html/adm/help/tex/Problem_Types.tex Wed Jun 26 08:14:55 2013 @@ -1,6 +1,7 @@ \label{Problem_Types} -In this manual we will cover five basic types of problems: Radio Response, -Option Response, String Response, Numerical Response, and Formula Response. +In this manual we will cover basic types of problems: Radio Response, +Option Response, String Response, Numerical Response, and Formula Response, Math +Response, You will need to identify which types of problem you want to use and create appropriate questions for your course. Index: loncom/html/adm/help/tex/Publishing_A_Resource.tex diff -u loncom/html/adm/help/tex/Publishing_A_Resource.tex:1.5 loncom/html/adm/help/tex/Publishing_A_Resource.tex:1.6 --- loncom/html/adm/help/tex/Publishing_A_Resource.tex:1.5 Tue Jun 4 23:19:42 2013 +++ loncom/html/adm/help/tex/Publishing_A_Resource.tex Wed Jun 26 08:14:55 2013 @@ -1,20 +1,11 @@ \label{Publishing_A_Resource} - - \index{Resource, Publishing}\index{Publishing Resource} % -\begin{figure} -\begin{center}\includegraphics[ width=0.80\paperwidth]{constructionSpaceForPublishing}\end{center} - - -\caption{Authoring Space for Publishing\label{Authoring Space for Publishing Figure}} -\end{figure} -To publish a resource, log in and choose your Author role. Then -click \textbf{CSTR} to go to your construction space. You should see something -like the Authoring Space for Publishing''. Click on the -\textbf{Publish} button for the resource you wish to publish.% +To publish a resource, log in and choose your Author role. You should see something +like the resource listing of the figure \ref{Example Directory Figure}. Use the \textbf{Actions} +dropdown to select \textbf{Publish} for the resource you wish to publish.% \begin{figure} \begin{center}\includegraphics[ width=0.80\paperwidth]{publishMetadata}\end{center} Index: loncom/html/adm/help/tex/Publishing_Copyright.tex diff -u loncom/html/adm/help/tex/Publishing_Copyright.tex:1.5 loncom/html/adm/help/tex/Publishing_Copyright.tex:1.6 --- loncom/html/adm/help/tex/Publishing_Copyright.tex:1.5 Tue Aug 26 22:32:31 2008 +++ loncom/html/adm/help/tex/Publishing_Copyright.tex Wed Jun 26 08:14:55 2013 @@ -1,5 +1,5 @@ \label{Publishing_Copyright} -You need to set the copyright and distribution permissions in the +You need to set the copyright and distribution permissions in the \\ \textbf{COPYRIGHT/DISTRIBUTION} drop-down. This setting controls who is allowed to use your resource as follows: Index: loncom/html/adm/help/tex/Resource_Types.tex diff -u loncom/html/adm/help/tex/Resource_Types.tex:1.2 loncom/html/adm/help/tex/Resource_Types.tex:1.3 --- loncom/html/adm/help/tex/Resource_Types.tex:1.2 Thu Jul 18 15:52:27 2002 +++ loncom/html/adm/help/tex/Resource_Types.tex Wed Jun 26 08:14:55 2013 @@ -1,25 +1,25 @@ \label{Resource_Types} LON-CAPA provides three types of resources for organizing your course website. -LON-CAPA refers to these resources as Content Pages, Problems, and Maps. -Maps may be either of two types: Sequences or Pages. You will use these LON-CAPA +LON-CAPA refers to these resources as HTML files, Problems, and Maps. +Maps may be either of two types: Sequences or Composite Pages. You can use LON-CAPA Maps resources to build the outline, or structure, for the presentation of your course to your students. \begin{itemize} -\item A \textbf{Content Page}\index{Content Page} displays course content. It -is essentially a conventional HTML page. These resources use the extension +\item A \textbf{HTML file}\index{HTML file}\index{Content Page}, (formerly known as a Content Page), displays course content. It +is a conventional HTML page. These resources use the extension {}.html''. \item A \textbf{Problem}\index{Problem} resource represents problems for the students to solve, with answers stored in the system. These resources are stored in files that must use the extension {}.problem''. \item A \textbf{Sequence}\index{Sequence} is a type of \textbf{Map}\index{Map} which is used to link other resources together. The users of this resource -can use directional buttons on their remote or the NAV button to follow the +can use directional buttons on the web page or remote to follow the sequence. Sequences are stored in files that must use the extension {}.sequence''. Sequences can contain other sequences and pages. -\item A \textbf{Page}\index{Page} is a type of \textbf{Map\index{Map}} which +\item A \textbf{Composite Page}\index{Page} is a type of \textbf{Map\index{Map}} which is used to join other resources together into one HTML page. For example, a page of problems will appears as a problem set. These resources are stored -in files that must use the extension {}.page''. +in files that must use the extension {}.page''. The course manual describes ways to combine resources in folders, which is an alternative to creating composite pages. \end{itemize} Index: loncom/html/adm/help/tex/Roles_Screen.tex diff -u loncom/html/adm/help/tex/Roles_Screen.tex:1.13 loncom/html/adm/help/tex/Roles_Screen.tex:1.14 --- loncom/html/adm/help/tex/Roles_Screen.tex:1.13 Tue Jun 4 23:19:42 2013 +++ loncom/html/adm/help/tex/Roles_Screen.tex Wed Jun 26 08:14:55 2013 @@ -1,4 +1,13 @@ \label{Roles_Screen} -After logging into LON-CAPA with your username and password, you will see a screen where you can select your ROLE. LON-CAPA is a roles-based system. You can always use the same login even though your roles may change. You can be an instructor in one class, a TA for another class, and an author of resources -- all with the same username. Selecting \textbf{Roles} on the Main Menu will bring you back to the \textbf{Roles} screen. +After logging into LON-CAPA with your username and password, you will see a screen +where you can select your ROLE. LON-CAPA is a roles-based system. You can always use +the same login even though your roles may change. You can be an instructor in one +class, a TA for another class, and an author of resources -- all with the same +username. Selecting \textbf{Roles} on the Main Menu will bring you back to the +\textbf{Roles} screen. -Two types of Roles exist in LON-CAPA: Authoring Roles, and Course Roles. Construction roles are used to develop learning resources. The course role is where resources are used. You may have multiple instances of either type of role. For example, each separate course has a course role. You may develop more than one construction space role depending on your depth of usage of LON-CAPA. +Two types of Roles exist in LON-CAPA: Authoring Roles, and Course Roles. +Authoring roles are used to develop learning resources. The course role is where +resources are inserted into courses. You may have multiple instances of either +type of role. For example, each separate course has a course role. You may develop +more than one construction space role depending on your depth of usage of LON-CAPA. Index: loncom/html/adm/help/tex/Sequence_Editor_Selection.tex diff -u loncom/html/adm/help/tex/Sequence_Editor_Selection.tex:1.2 loncom/html/adm/help/tex/Sequence_Editor_Selection.tex:1.3 --- loncom/html/adm/help/tex/Sequence_Editor_Selection.tex:1.2 Thu Jul 18 15:52:27 2002 +++ loncom/html/adm/help/tex/Sequence_Editor_Selection.tex Wed Jun 26 08:14:55 2013 @@ -8,7 +8,7 @@ \caption{Map Editor Selection\label{Map Editor Selection Figure}} \end{figure} To create a Sequence resource, create a new resource as described in section -\ref{Creating New Content Pages}. This is a {}sequence'' resource so +\ref{Creating_Content_Overview}. This is a {}sequence'' resource so the URL must end in {}.sequence''. After you enter in the URL ending in {}.sequence'', you should see a screen as in figure \ref{Map Editor Selection Figure}. You can use either the advanced editor or the simplified editor. Index: loncom/html/adm/help/tex/String_Response_Problem_Creation.tex diff -u loncom/html/adm/help/tex/String_Response_Problem_Creation.tex:1.3 loncom/html/adm/help/tex/String_Response_Problem_Creation.tex:1.4 --- loncom/html/adm/help/tex/String_Response_Problem_Creation.tex:1.3 Tue Feb 8 16:37:41 2005 +++ loncom/html/adm/help/tex/String_Response_Problem_Creation.tex Wed Jun 26 08:14:55 2013 @@ -1,51 +1,51 @@ -\label{String_Response_Problem_Creation} - -To create a \textbf{String Response} problem, create a new resource (described in -\ref{Creating New Content Pages}). This is a {}problem'' resource -so the URL must end in {}.problem''. - -\begin{enumerate} -\item In the drop-down option box as seen in \ref{Creating a new problem resource}, -select \textbf{String Response Problem}, and click the \textbf{New Problem} -button. -\item Click the \textbf{Edit} button above the sample problem to enter edit mode.% -\begin{figure} -\begin{center}\includegraphics[ width=0.80\paperwidth]{stringResponseEditor}\end{center} - - -\caption{String Response Editor\label{String Response Editor Figure}} -\end{figure} - You should see the String Response editor page open up, which should look -something like what you see in the String Response Editor'' figure. -\item Clear the text from the \textbf{Text Block} at the top of the problem, and -type in your problem. -\item In the \textbf{Answer Box}, type the correct answer. -\item Select the answer condition from the drop-down. There are three cases to -choose from: - -\begin{enumerate} -\item \textbf{cs}: This means {}Case Sensitive''. For example, this is useful -in chemistry, where HO and Ho are completely different answers. The student must match the case of the answer. -\item \textbf{ci}: This means {}Case Insensitive''. The system does not use -the case of the letters to determine the correctness of the answer. If the -correct answer is {}car'', the system will accept {}car'', {}CAR'', -{}Car'', {}caR'', etc. -\item \textbf{mc}: This means {}Multiple Choice''. The student's answers must -contain the same letters as the question author's, but order is unimportant. -This is usually used to give a multiple choice question in the question's -\textbf{Text Block}, which may have several correct parts. If the author -sets the correct answer as {}bcg'', the system will accept {}bcg'', -{}cbg'', {}gcb'', etc., but not {}bc'' or {}abcg''. -\end{enumerate} -It is conventional to inform the students if the problem is case sensitive, -or that the order of the answers doesn't matter. - -\item Optionally, locate the \textbf{Single Line Text Entry Area} block and set -a length in the Size box. This will only affect the size of the box on the -screen; if you set the box size to 2, the student can still enter 3 or more -letters in their answer. -\item Scroll down to the \textbf{Hint} element, and type some text that will help -students when they answer incorrectly, or delete the hint by setting the -\textbf{Delete} field to \textbf{Yes}. -\item Click the \textbf{Submit Changes} button. -\end{enumerate} +\label{String_Response_Problem_Creation} + +To create a \textbf{String Response} problem, create a new resource (described in +\ref{Creating_Content_Overview}. This is a {}problem'' resource +so the URL must end in {}.problem''. + +\begin{enumerate} +\item In the drop-down option box as seen in \ref{New Content Menu}, +select \textbf{String Response Problem}, and click the \textbf{New Problem} +button. +\item Click the \textbf{Edit} button above the sample problem to enter edit mode.% +\begin{figure} +\begin{center}\includegraphics[ width=0.80\paperwidth]{stringResponseEditor}\end{center} + + +\caption{String Response Editor\label{String Response Editor Figure}} +\end{figure} + You should see the String Response editor page open up, which should look +something like what you see in the String Response Editor'' figure. +\item Clear the text from the \textbf{Text Block} at the top of the problem, and +type in your problem. +\item In the \textbf{Answer Box}, type the correct answer. +\item Select the answer condition from the drop-down. There are three cases to +choose from: + +\begin{enumerate} +\item \textbf{cs}: This means {}Case Sensitive''. For example, this is useful +in chemistry, where HO and Ho are completely different answers. The student must match the case of the answer. +\item \textbf{ci}: This means {}Case Insensitive''. The system does not use +the case of the letters to determine the correctness of the answer. If the +correct answer is {}car'', the system will accept {}car'', {}CAR'', +{}Car'', {}caR'', etc. +\item \textbf{mc}: This means {}Multiple Choice''. The student's answers must +contain the same letters as the question author's, but order is unimportant. +This is usually used to give a multiple choice question in the question's +\textbf{Text Block}, which may have several correct parts. If the author +sets the correct answer as {}bcg'', the system will accept {}bcg'', +{}cbg'', {}gcb'', etc., but not {}bc'' or {}abcg''. +\end{enumerate} +It is conventional to inform the students if the problem is case sensitive, +or that the order of the answers doesn't matter. + +\item Optionally, locate the \textbf{Single Line Text Entry Area} block and set +a length in the Size box. This will only affect the size of the box on the +screen; if you set the box size to 2, the student can still enter 3 or more +letters in their answer. +\item Scroll down to the \textbf{Hint} element, and type some text that will help +students when they answer incorrectly, or delete the hint by setting the +\textbf{Delete} field to \textbf{Yes}. +\item Click the \textbf{Submit Changes} button. +\end{enumerate} Index: loncom/html/adm/help/tex/Variables_in_the_Text_Block.tex diff -u loncom/html/adm/help/tex/Variables_in_the_Text_Block.tex:1.3 loncom/html/adm/help/tex/Variables_in_the_Text_Block.tex:1.4 --- loncom/html/adm/help/tex/Variables_in_the_Text_Block.tex:1.3 Fri Oct 12 13:26:55 2012 +++ loncom/html/adm/help/tex/Variables_in_the_Text_Block.tex Wed Jun 26 08:14:55 2013 @@ -1,12 +1,14 @@ \label{Variables_in_the_Text_Block} -Once you've defined variables in the \textbf{Script}, you can use them in +\index{variables in text block} +Once you've defined variables in the \textbf{Script}, you can display them in the \textbf{Text Block}. For example, using the previous three-line script we've created so far, you can place the following in the \textbf{Text Block}: -See~the~3:~\$variable<br~/>
-
+\begin{lyxcode}
+See~the~3:~\$variable<br~/>\\ See~the~string:~<b>\$stringVar</b><br~/>
+\end{lyxcode}
%
\begin{figure}
\begin{center}\includegraphics{numericalResponseVarInText}\end{center}
@@ -19,3 +21,8 @@
was turned into a 3, and the {}\$stringVar'' was turned into {}I have a variable with the value 3.'' +If you a generating numbers by a formula by division, you will want to format your output. +For example, if \$variable=1/3, it will display with too many digits. You can adjust the format
+using the \textbf{num} output tag \index{num output tag} \index{format numbers in text block}
+described in section \ref{Authoring_Output_Tags}
+

\label{Content_Page_Overview}
\textbf{HTML files} are HTML documents that display the course information
you are presenting. They have been previously called Content Pages.\index{HTML files}\index{Content Pages}

You may create HTML files and then upload them, or you may create HTML files within the Authoring Space.

\label{Creating_Content_Overview}
LON-CAPA internally recognizes the types of resources by the filename extension. Within the authoring space, there are two methods to create a new resource:

\begin{itemize}
\item If you are using Inline Menus, you may use the dropdrown menu on the right of the authoring screen to indicate the type of resource you want to create as shown in the figure \ref{New Content Menu}. The filename extension will be specified when you select the resource type. This method is best for new authors.
\item Or, you may type the full url of the new resource in URL bar of your browser. You must use a valid file extension. LON-CAPA will recognize the new resource type by the filename extension and present you the appropriate menus to create your resource. This method is appropriate for advanced authoring.
\end{itemize}

\label{Creating_Formula_Response}

\index{Formula Response, Creating}\label{Formula Response, Creating}
%
\begin{figure}
\begin{center}\includegraphics[  width=0.80\paperwidth]{formulaResponse}\end{center}

\caption{Formula Response Problem}\label{Authoring Formula Response}
\end{figure}

Formula Response problems authoring is illustrated by Figure \ref{Authoring Formula Response}

\label{Creating_Math_Response_Problems}

Math response problems use a cas system to evaluate the student response. Which computer algebra system is to be used is specified in the cas argument of the mathresponse tag; currently, only Maxima is available.
LON-CAPA sets up two arrays inside the computer algebra system: RESPONSE and LONCAPALIST. RESPONSE contains the student input by comman-separated entities, for example, if "3,42,17" is entered by the student, RESPONSE[2] would be 42. LONCAPALIST contains the arguments passed in the args of mathresponse passed from the script in an vector.

The answerdisplay tag contains what is displayed when the problem is in "Show Answer" mode. You will want to include this field so that the students can see the correct answer after the "Show Answer Date" configured when the problem is assigned in the course space.

The following example illustrates this.
\begin{verbatim}
<problem>
<script type="loncapa/perl">
$a1 = random(-6,6,4);$a2 = random(-6,6,4);
$n1 = random(3,11,2);$n2 = random(2,10,2);
$function = "$a1*cos($n1*x)+$a2*sin($n2*x)";$example=&xmlparse('An example would be <m eval="on">$(sin($n1\cdot x)+cos($n2\cdot x))/\sqrt{2}$</m>');
</script>

<startouttext />
Give an example of a function
<ol>
<li>
which is orthogonal to <algebra>$function</algebra> with respect to the scalar product <m> $<g \mid h> = \frac{1}{\pi} \int_{-\pi}^{\pi}dx g(x) \cdot h(x)$ </m> </li> <li> whose norm is 1. </li> </ol> <endouttext /> <mathresponse answerdisplay="$example" cas="maxima" args="$function"> <answer> overlap:integrate((RESPONSE[1])*(LONCAPALIST[1]),x,-%pi,%pi)/%pi; norm:integrate((RESPONSE[1])*(RESPONSE[1]),x,-%pi,%pi)/%pi; is(overlap=0 and norm=1); </answer> <textline readonly="no" size="50" /> <hintgroup showoncorrect="no"> <mathhint name="ortho" args="$function" cas="maxima">
overlap: integrate((LONCAPALIST[1])*(RESPONSE[1]),x,-%pi,%pi)/%pi;
is(not overlap = 0);
</mathhint>
<mathhint name="norm" args="$function" cas="maxima"> <answer> norm: integrate((RESPONSE[1])*(RESPONSE[1]),x,-%pi,%pi)/%pi; is(not norm = 1); </answer> </mathhint> <hintpart on="norm"> <startouttext /> The function you have provided does not have a norm of one. <endouttext /> </hintpart> <hintpart on="ortho"> <startouttext /> The function you have provided is not orthogonal. <endouttext /> </hintpart> </hintgroup> </mathresponse> <postanswerdate> <startouttext /> <p> Note that with respect to the above norm, <m>$\cos(nx)$</m> is perpendicular to <m>$\sin(nx)$</m> and perpendicular to <m>$\cos(mx)$</m> for <m>$n\ne m$</m>. </p> <endouttext /> </postanswerdate> </problem> \end{verbatim} Index: loncom/html/adm/help/tex/Custom_Response_Problem_Creation.tex +++ loncom/html/adm/help/tex/Custom_Response_Problem_Creation.tex \label{Custom_Response_Problem_Creation} Custom Response is a way to have a problem graded based on an algorithm. The use of this response type is generally discouraged, since the responses will not be analyzable by the LON-CAPA statistics tools. For a single textfield, the student's answer will be in a variable \$submission. If the Custom Response has multiple textfields, the answers will be in an array
reference, and can be accessed as \$\$submission[0], \$\$submission[1], etc.

The student answer needs to be evaluated by Perl code inside the <answer>-tag. Custom Response needs to return a standard LON-CAPA. The most common response are:
\begin{itemize}
\item EXACT\_ANS: return if solved exactly correctly
\item APPROX\_ANS: return if solved approximately
\item INCORRECT: return if not correct, uses up a try
\item ASSIGNED\_SCORE: partial credit (also return the credit factor, e.g. return(ASSIGNED\_SCORE,0.3);)
WANTED\_NUMERIC, WRONG\_FORMAT: return if not correct for different reasons, does not use up a try
\end{itemize}
The following example illustrates this:
\begin{verbatim}
<problem>
<startouttext />Accept an answer of around 90 or -90<endouttext />
<customresponse answerdisplay="something near 90 or -90">
# We do not want a vector
if ($submission=~/\,/) { return 'EXTRA_ANSWER'; } # Need a numerical answer here if ($submission!~/^[\d\.\-\e]+$/i) { return 'WANTED_NUMERIC'; }$difference=abs(90-abs($submission)); if ($difference==0) { return 'EXACT_ANS'; }
if (\$difference < 0.1) { return 'APPROX_ANS'; }
</customresponse>
</problem>
\end{verbatim}

Full list of possible return codes:
\begin{itemize}
\item EXACT\_ANS: student is exactly correct
\item APPROX\_ANS:  student is approximately correct
\item NO\_RESPONSE: student submitted no response
\item MISSING\_ANSWER: student submitted some but not all parts of a response
\item EXTRA\_ANSWER: student submitted a vector of values when a scalar was expected
\item WANTED\_NUMERIC: expected a numeric answer and didn't get one
\item SIG\_FAIL: incorrect number of Significant Figures
\item UNIT\_FAIL: incorrect unit
\item UNIT\_NOTNEEDED: submitted a unit when one shouldn't
\item UNIT\_INVALID\_INSTRUCTOR: the unit provided by the author of the problem is unparsable
\item UNIT\_INVALID\_STUDENT: the unit provided by the student is unparasable
\item UNIT\_IRRECONCIBLE: the unit from the student and the instructor are of different types
\item NO\_UNIT: needed a unit but none was submitted
\item BAD\_FORMULA: syntax error in submitted formula
\item WRONG\_FORMAT: student submission did not have the expected format
\item DRAFT: submission only stored
\item MISORDERED\_RANK: student submitted a poorly order rank response
\item ERROR: unable to get a grade
\item ASSIGNED\_SCORE: partial credit; the customresponse needs to return the award followed by the partial credit factor
\item TOO\_LONG: answer submission was deemed too long
\item INVALID\_FILETYPE: student tried to upload a file that was of an extension that was not specifically allowed
\item COMMA\_FAIL: answer requires the use of comma grouping and it wasn't provided or was incorrect
\end{itemize}

\label{Dynamic_Plot_Overview}
\index{Dynamic Plots}\index{Plots}

Dynamic Plots can be generated from calculations based on random numbers. The student can be asked to respond to the plot. Another option is to use student input to display a graphical result to students based on an input that they provide.