diff --git a/docs/course_authors/source/Images/MathJax_HTML.gif b/docs/course_authors/source/Images/MathJax_HTML.gif new file mode 100644 index 0000000000..4d97c7734b Binary files /dev/null and b/docs/course_authors/source/Images/MathJax_HTML.gif differ diff --git a/docs/course_authors/source/Images/MathJax_Problem.gif b/docs/course_authors/source/Images/MathJax_Problem.gif new file mode 100644 index 0000000000..63a8801864 Binary files /dev/null and b/docs/course_authors/source/Images/MathJax_Problem.gif differ diff --git a/docs/course_authors/source/advanced_problems.rst b/docs/course_authors/source/advanced_problems.rst index 2d67fe95cc..0095e1415d 100644 --- a/docs/course_authors/source/advanced_problems.rst +++ b/docs/course_authors/source/advanced_problems.rst @@ -151,8 +151,7 @@ symbolic expressions. When you create a math expression input problem for your students in Studio, you'll use `MathJax `_ to change your plain text into "beautiful math." For more information about how to use -MathJax in Studio, see *A Brief Introduction to MathJax in -Studio*. +MathJax in Studio, see :ref:`MathJax in Studio`. .. image:: Images/MathExpressionInputExample.gif diff --git a/docs/course_authors/source/appendices/g.rst b/docs/course_authors/source/appendices/g.rst new file mode 100644 index 0000000000..f89e07600d --- /dev/null +++ b/docs/course_authors/source/appendices/g.rst @@ -0,0 +1,58 @@ +.. _MathJax in Studio: + +A Brief Introduction to MathJax in Studio +========================================= + +To write clear and professional-looking symbols and equations, we use a LaTeX-like +language called +`MathJax `_. +Your MathJax equations can appear with other text in the paragraph (inline equations) or +on their own lines (display equations). + +- For inline equations, you can do either of the following. + + - Surround your Mathjax expression with backslashes and **parentheses**. + + ``\( equation \)`` + + - Surround your Mathjax expression with [mathjaxinline] tags. Note that these + tags use square brackets ([]). + + [mathjaxinline] equation [/mathjaxinline] + +- For display equations, you can do either of the following. + + - Surround your Mathjax expression with backslashes and **brackets**. + + ``\[ equation \]`` + + - Surround your Mathjax expression with [mathjax] tags. Note that these tags use + square brackets ([]). + + [mathjax] equation [/mathjax] + +You can use MathJax in HTML (text) components and in Problem components. + +.. note:: Complete MathJax documentation (together with a testing tool) can be + found at `http://www.onemathematicalcat.org/MathJaxDocumentation/TeXSyntax.htm `_. + + +HTML (Text) Components +---------------------- + +In the HTML component editor, you can use MathJax both in Visual view and in HTML view. + +.. image:: ../Images/MathJax_HTML.gif + +Problem Components +------------------ + +In the Problem component editor, you can use MathJax both in the Simple Editor +and in the Advanced Editor. + +In the example problem below, note that the Einstein equation in the +explanation is enclosed in backslashes and parentheses, so it appears inline with the text. The +Navier-Stokes equation is enclosed in backslashes and brackets, so it appears on its +own line. + +.. image:: ../Images/MathJax_Problem.gif \ No newline at end of file