Uploaded image for project: 'Sakai'
  1. Sakai
  2. SAK-22384

Support MathJax Rendering Across Sakai

    Details

    • Property addition/change required:
      Yes

      Description

      Add support for the MathJax (http://www.mathjax.org/) rendering engine throughout Sakai. It's features are outlined at: http://www.mathjax.org/ and it's accessibility benefits can be found at: http://www.mathjax.org/resources/articles-and-presentations/accessible-pages-with-mathjax/

      This would allow the use of LaTeX, MathML and ASCIIMath rendering across all Sakai pages. Ideally two properties would be set in sakai.properties. One property to enable the rendering, as well as one property to specify the location of the MathJax library (a .js file).

      There was a previous issue (since closed) concerning adding MathJax to Sakai's WYSIWIG editor (SAK-19807). Assuming CKEditor being Sakai's default WYSIWIG editor moving forward (in 2.9), some internal testing using the MathJax library and CKEditor with LaTeX code was done. No changes needed to be made to the CKEditor to allow rendering of the math formula once saved(no rendering is done in the editor window). Simply including the MathJax library on page load will complete the rendering.

      FCKEditor does try to interpret some of the LaTeX and MathML that is input (plain text would be required for institutions using FCKEditor).

      A formula editor is out of scope of this request. We find Faculty wanting to construct complex math equations will do so in their editor of choice and then port to Sakai.

      As well, MathJax is distributed under the Apache License, Version 2.0 (http://www.mathjax.org/resources/faqs/#License) which should play nice with the Educational Community License, Version 2.0 (http://opensource.org/licenses/ecl2.php).

      Properties:

      1. URL to MathJax.js, you can use the one on the mathjax CDN or put one locally. Currently this is not included with Sakai
        #portal.mathjax.src.path=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=default,Safe
      1. Whether to allow useres to enable or disable MathJAX, this still has to be enabled on a per site basis
        #portal.mathjax.enabled=true

        Gliffy Diagrams

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  jonespm Matthew Jones
                  Reporter:
                  mbrousseau Michael Brousseau
                • Votes:
                  6 Vote for this issue
                  Watchers:
                  24 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: