File:  [LON-CAPA] / loncom / html / adm / help / tex / Course_Prefs_Display.tex
Revision 1.9: download - view: text, annotated - select for diffs
Fri Dec 24 14:19:38 2021 UTC (2 years, 6 months ago) by raeburn
Branches: MAIN
CVS tags: version_2_11_X, version_2_11_5, version_2_11_4_uiuc, version_2_11_4, HEAD
- Update documentation for "Display of resources" course setting.

\label{Course_Prefs_Display}

This panel lets you set various display options for content.
\begin{itemize}
	\item Default XML style sheet
	\item Visibly Separate Items on a Page
	\item Disable Display of Problem Receipts
	\item Force use of a specific math rendering engine
	\item Set default options for $<$m$>$ tags when 
converting \LaTeX{} to html. 
        \item Student formula entry uses inline preview, not DragMath pop-up
        \item Molecule editor uses JSME (HTML5) in place of JME (Java)
        \item Chemical reaction response uses inline preview, not pop-up

Style files (.sty extension) created in Authoring Space and published to the shared content pool
can be selected for use when rendering resources in the course by clicking the 
\underline{Select Style File} link. See the ``Resource Types'' item in the ``Introduction to LON-CAPA
Authoring'' section in the Authoring manual for more information about .sty files.  An alternative to
the use of .sty files is to create a CSS file (.css extension) in Authoring Space, and publish to the shared content pool.  Note: in this case you would use a problem parameter ``CSS file to link (cssfile)'', accessed via Content Settings, instead of Course Settings, to apply the style to resource(s) in your course. 

Composite Pages include two or more resources on a single web page.  By selecting ``Yes'' for 
visible separation, adjacent resources will be separated by a horizontal rule.

Problem Receipts will be displayed by default when feedback on correctness is being displayed to a student, and the student has submitted the correct solution. See the ``Verify a Submission Receipt Number'' section (\ref{Grade_Verify}).


If ``Force use of a specific math rendering engine'' is set to none, then the math display mechanism used to render LaTeX within <m></m> tags is determined in the following order, with the first one set being the one in effect:
\begin{enumerate}
\item User's own personal preference set by the user hovering over the user's name at top left of a LON-CAPA page, and selecting Preferences $>$ Math display settings
\item Domain default set by a Domain Coordinator 
\item System default set for the LON-CAPA version installed on the server (tth in 2.11 and earlier)
\end{enumerate}
This can be overriden by setting the attribute display to one of \textbf{MathJax},  
\textbf{mimetex} (i.e., Convert to Images) or
\textbf{tth} (i.e., TeX to HTML) which will force a specific display mechanism.

The behavior of the textboxes where students enter either an algebraic formula (formularesponse) or a chemical reaction (reactionresponse) is inherited from settings in the domain.  The default, in the absence of a specific domain setting, is to use an inline preview which appears below the textbox, as the expression is typed.  The domain default can be overridden within a specific course if it is preferred to use the old pop-up window displays in either case.

Similarly, the the molecular editor display will use the domain setting, unless overridden within a specific course.  If nothing is explicitly set in the domain or the course, then the default is to use JSME instead of its JME predecessor.


\end{itemize}


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>