File:  [LON-CAPA] / loncom / html / adm / help / tex / Course_Prefs_Display.tex
Revision 1.10: download - view: text, annotated - select for diffs
Sun Aug 28 02:41:30 2022 UTC (22 months, 1 week ago) by raeburn
Branches: MAIN
CVS tags: version_2_12_X, version_2_11_4_msu, HEAD
- Bug 6972.
  Option in course to display every External Resource Item as link (and
  launch in a tab or window) instead of in iframe.

    1: \label{Course_Prefs_Display}
    2: 
    3: This panel lets you set various display options for content.
    4: \begin{itemize}
    5: 	\item Default XML style sheet
    6: 	\item Visibly Separate Items on a Page
    7: 	\item Disable Display of Problem Receipts
    8: 	\item Force use of a specific math rendering engine
    9: 	\item Set default options for $<$m$>$ tags when 
   10: converting \LaTeX{} to html. 
   11:         \item Student formula entry uses inline preview, not DragMath pop-up
   12:         \item Molecule editor uses JSME (HTML5) in place of JME (Java)
   13:         \item Chemical reaction response uses inline preview, not pop-up
   14:         \item Display of external resources
   15: \end{itemize}
   16: 
   17: Style files (.sty extension) created in Authoring Space and published to the shared content pool
   18: can be selected for use when rendering resources in the course by clicking the 
   19: \underline{Select Style File} link. See the ``Resource Types'' item in the ``Introduction to LON-CAPA
   20: Authoring'' section in the Authoring manual for more information about .sty files.  An alternative to
   21: 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. 
   22: 
   23: Composite Pages include two or more resources on a single web page.  By selecting ``Yes'' for 
   24: visible separation, adjacent resources will be separated by a horizontal rule.
   25: 
   26: 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}).
   27: 
   28: 
   29: 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:
   30: \begin{enumerate}
   31: \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
   32: \item Domain default set by a Domain Coordinator 
   33: \item System default set for the LON-CAPA version installed on the server (tth in 2.11 and earlier)
   34: \end{enumerate}
   35: This can be overriden by setting the attribute display to one of \textbf{MathJax},  
   36: \textbf{mimetex} (i.e., Convert to Images) or
   37: \textbf{tth} (i.e., TeX to HTML) which will force a specific display mechanism.
   38: 
   39: 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.
   40: 
   41: 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.
   42: 
   43: 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.
   44: 
   45: 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.
   46: 
   47: The automatic display adjustments described above occur on a case-by-case basis depending on the external resource itself.
   48: 
   49: 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.
   50: 

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