Note: You are currently viewing documentation for Moodle 3.8. Up-to-date documentation for the latest stable version of Moodle may be available here: TinyMCE Mathslate.

TinyMCE Mathslate: Difference between revisions

From MoodleDocs
No edit summary
Line 2: Line 2:
{{Infobox plugin
{{Infobox plugin
|type = TinyMCE plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|entry = https://github.com/dthies/moodle-editor_tinymce-mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]

Revision as of 00:25, 7 June 2014

Mathslate Screenshot.png

Description

Mathslate is a mathematics editor that this plugin adds to TinyMCE toolbar. It is similar in functionality to the DragMath which is included in the Moodle core for TinyMCE. Mathslate however has no Java dependency, and consequently it should usable in a larger variety of browsers including those on mobile devices.

Adminstation

Requirements

Plugins are available for Moodle 2.5 and 2.6. In addition MathJax 2.0 or better needs to be available either by users connecting to the internet or with a local installation on the server

Installation

The TinyMCE Mathslate plugin installs as a single package in the lib/editor/tinymce/plugins directory of the Moodle root. Administrator must log in and complete the installation process.

Configuration Options

TinyMCE Mathslate has a setting page under in the Administration panel under Plugins->Text Editors->TinyMCE->TinyMCE Mathslate. There is a box to hide the plugin button when the TeX filter is not in use. This is probably not desirable if MathJax is enabled throughout the site so it is disabled by default. There is also a text input for a url for the plugin to locate MathJax.js file from a server hosting a MathJax installation. This is not needed if MathJax is configured throughout the system, but is needed if the TeX Filter is normally the way mathematics is rendered for display. The correct url (http or https) for your site should be used to prevent browsers from rejecting it as mixed content.

Usage

Selecting mathematics

Mathslate does not the allow the selection of individual characters as with a word processor, but instead treats mathematics as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the work space, and the block of code appears with a cursor in front of it below the work space.

Moving mathematics

To move an expression simply select an element after the place it should be inserted on work space and then click the expression to move there. Alternatively, you may simply drag the expression to where it should be inserted.

Editing functions

There is a row of buttons in the center of the editor that allows the user to delete a selection or the whole content, undo the previous action, and redo previously undone actions.

Modifying Behaviour

The appearance of the pop up widow can be modified by editing style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be change in the file config.json. The default file contains a reasonably comprehensive initial list of mathematical symbols and functions. Items may be deleted easily from the file with a text editor. Eventually there may be a selection of files to chose from for different learning environments and subjects (a version for chemical formulas is already in development).