[LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Authoring_Equations.tex doc/help author.manual.texxml

[lira]

lira		Thu Dec 29 01:57:13 2016 EDT

  Added files:                 
    /loncom/html/adm/help/tex	Authoring_Equations.tex 

  Modified files:              
    /doc/help	author.manual.texxml 
  Log:
  Adding description of equation editing
  
Index: doc/help/author.manual.texxml
diff -u doc/help/author.manual.texxml:1.33 doc/help/author.manual.texxml:1.34
--- doc/help/author.manual.texxml:1.33	Thu May 28 02:29:03 2015
+++ doc/help/author.manual.texxml	Thu Dec 29 01:57:09 2016
@@ -99,6 +99,9 @@
 			<subsection name="Authoring and Editing Content Pages">
 				<file name="Creating_New_Content_Pages.tex"/>
 			</subsection>
+		<subsubsection name="Creating Equations">
+				<file name="Authoring_Equations.tex"/>
+			</subsubsection>
 		<subsubsection name="How to Edit Existing Content Pages">
 		        <file name="How_To_Edit_Existing_Content_Pages.tex"/>
 			</subsubsection>

Index: loncom/html/adm/help/tex/Authoring_Equations.tex
+++ loncom/html/adm/help/tex/Authoring_Equations.tex
\label{Authoring_Equations}

\index{Latex}\index{tex}\index{math equations}LON-CAPA renders math using LaTeX. LaTeX can be entered directly as described below or the LaTeX can be generated using the DragMath math editor. Some LON-CAPA editors provide an `Edit Math' menu button.  To use DragMath, after inserting the cursor in the desired equation location, the `Edit Math' button launches a pop-up window
containing the DragMath equation editor (which requires Java plugin support in the user's
browser).  Math templates are provided for basic mathematical expressions. At the bottom of the DragMath pop-up is a ``Render LaTeX'' button that
will insert the DragMath expression as LaTeX within \texttt{$<$m$>$\$ \$$<$/m$>$} tags in the original file editor window.

The DragMath editor may not offer the template that you need, or the expression may not appear as you expect. The most powerful method of entering math or touching up DragMath output is to learn about the LaTeX syntax. An Internet search for ``LaTeX math quick reference'' will result in many resources.

Within the \texttt{$<$m$>$} tag, additional tags control the display of LaTeX math. The \$ open and closing syntax will create an inline equation. To create an equation in a separate paragraph, use double signs, \$\$. Alternative notations are also accepted, \textbackslash{}( opening with \textbackslash{}) closing can be used for an inline equation, and \textbackslash{}[ opening with \textbackslash{}] closing results in a separate paragraph. The \$ and \$\$ methods are recommended as ``LaTeX robust'' and the \textbackslash{}( and \textbackslash{}[ methods are considered ``LaTeX fragile.'' The robust methods should be used if the fragile methods result in unexpected behavior.

Some simple sytax from common LaTeX math:
\begin{itemize}
\item \texttt{\symbol{92}frac\{numerator\}\{denominator\}} results in $\frac{numerator}{denominator}$
\item \texttt{\^{}} superscript, e.g. \texttt{x\^{}2} results in $x^{2}$
\item \_ subscript, e.g. \texttt{x\^{}2\_i} results in $x^{2}_i$
\item use \texttt{\{} and \texttt{\}} as delimiters, e.g. \texttt{x\_\{upper\}} for $x_{upper}$
\end{itemize}