--- loncom/html/adm/help/tex/Course_Prefs_Display.tex	2013/11/28 02:10:45	1.5
+++ loncom/html/adm/help/tex/Course_Prefs_Display.tex	2022/08/28 02:41:30	1.10
@@ -8,6 +8,11 @@ This panel lets you set various display
 	\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
+        \item Display of external resources
+\end{itemize}
 
 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 
@@ -20,13 +25,26 @@ visible separation, adjacent resources w
 
 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}).
 
-The 
-default for math rendering\index{math rendering} is to convert using the display 
-mechanism that the user has selected in preferences.
+
+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{jsMath}, \textbf{mimetex} or
-\textbf{tth} which will force a specfic display mechanism. Note, however, that setting
-the attribute display to jsmath is generally discouraged as it requires users to have
-installed jsmath fonts on their computer. See \\ \texttt{http://www.math.union.edu/\char`~ dpvc/jsmath/}.
-\end{itemize}
+\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.
+
+The Course Editor can be used to add the URL for an external resource to be displayed within a LON-CAPA course. By default, the remote content will be displayed in an iframe with standard LON-CAPA menu links/icons present in the page header above the resource. LON-CAPA attempts to gracefully handle mixed active content issues for external resources by injecting usehttp=1 into the query string for the LON-CAPA URL, in order to force serving of an http:// external URL in an http:// LON-CAPA page, where the LON-CAPA server uses https:// by default for all other pages.  A separate session cookie which confers reduced rights is used when usehttp=1 is present in the query string because LON-CAPA's standard session cookie includes the 'secure' attribute.
+
+LON-CAPA also attempts to circumvent the lack of scrolling for multi-page PDFs in iframes on iOS by replacing inline display in an iframe with a link when viewing on a mobile device.  Another instance where LON-CAPA replaces display of an external resource in an iframe with a link to display the resource in a separate browser tab is when Content-Security-Policy or X-Frame-Options prevent display in an iframe.
+
+The automatic display adjustments described above occur on a case-by-case basis depending on the external resource itself.
+
+The ``Display of external resources'' item can be used to force display of all external resources in a course in either a separate browser tab, or in a new browser window. In the latter case an optional width and height (in pixels) can be specified.  When tab or window are selected, there is also an option to re-use the same (named) tab or window when displaying different external resources in a course in order to limit the number of tabs or windows which may be created by browsing in a single course.