|
| 1 | +# MathType for TinyMCE V7 |
| 2 | + |
| 3 | +Type and handwrite mathematical notation with MathType. |
| 4 | + |
| 5 | +Easily include quality math equations in your documents and digital content. |
| 6 | + |
| 7 | +## Table of Contents |
| 8 | + |
| 9 | +- [Install instructions](#install-instructions) |
| 10 | +- [Known issues](#known-issues) |
| 11 | +- [Services](#services) |
| 12 | +- [Documentation](#documentation) |
| 13 | +- [Displaying on Target Page](#displaying-on-target-page) |
| 14 | +- [Privacy policy](#privacy-policy) |
| 15 | + |
| 16 | +## Install instructions |
| 17 | + |
| 18 | +1. Install the npm module: |
| 19 | + |
| 20 | + ```bash |
| 21 | + npm install @wiris/mathtype-tinymce7 |
| 22 | + ``` |
| 23 | + |
| 24 | + > MathType is fully compatible with TinyMCE 7 from version 7.6.0. |
| 25 | +
|
| 26 | +2. Add the plugin as an external plugin: |
| 27 | + |
| 28 | + ```js |
| 29 | + tinymce.init({ |
| 30 | + external_plugins: { |
| 31 | + tiny_mce_wiris: `node_modules/@wiris/mathtype-tinymce7/plugin.min.js`, |
| 32 | + }, |
| 33 | + }); |
| 34 | + ``` |
| 35 | + |
| 36 | +3. Add MathType buttons to the TinyMCE7 toolbar and the recommended settings: |
| 37 | + |
| 38 | + ```js |
| 39 | + tinymce.init({ |
| 40 | + toolbar: "tiny_mce_wiris_formulaEditor tiny_mce_wiris_formulaEditorChemistry", |
| 41 | + // We recommend to set 'draggable_modal' to true to avoid overlapping issues |
| 42 | + // with the different UI modal dialog windows implementations between core and third-party plugins on TinyMCE. |
| 43 | + // @see: https://github.com/wiris/html-integrations/issues/134#issuecomment-905448642 |
| 44 | + draggable_modal: true, |
| 45 | + |
| 46 | + // This option allows you to introduce mathml formulas with wiris plugins. |
| 47 | + // Not enabling this, will provide formulas from being created and rendered. |
| 48 | + extended_valid_elements: "*[.*]", |
| 49 | + valid_elements: "*[*]", |
| 50 | + |
| 51 | + // You could set a different language for MathType editor: |
| 52 | + // language: 'fr_FR', |
| 53 | + // mathTypeParameters: { |
| 54 | + // editorParameters: { language: 'fr' }, |
| 55 | + // }, |
| 56 | + }); |
| 57 | + ``` |
| 58 | + |
| 59 | + Notice the example assumes this directory structure: |
| 60 | + |
| 61 | + ``` |
| 62 | + └───index.html |
| 63 | + └───node_modules |
| 64 | + └───@wiris/mathtype-tinymce7 |
| 65 | + ``` |
| 66 | + |
| 67 | +## Known issues |
| 68 | + |
| 69 | +- The editor's caret is lost when inserting a new formula on Safari with ChemType [#486](https://github.com/wiris/html-integrations/issues/486) |
| 70 | + |
| 71 | +## Services |
| 72 | + |
| 73 | +This npm module uses remotely hosted services to render MathML data. However, we recommend you install these services on your backend. This will allow you, among other things, to configure the service and to locally store the images generated by MathType. |
| 74 | + |
| 75 | +The services are available for Java, PHP, .NET and Ruby on Rails. If you use any of these technologies, please download the plugin for your backend technology from [here](https://store.wiris.com/en/products/downloads/mathtype/integrations#froala?utm_source=npmjs&utm_medium=referral). |
| 76 | + |
| 77 | +## Displaying on Target Page |
| 78 | + |
| 79 | +In order to display mathematical formulas on the target page, i.e. the page where content produced by the HTML editor will be visible, the target page needs to include the [MathType script](https://docs.wiris.com/en/mathtype/mathtype_web/integrations/mathml-mode#add_a_script_to_head). For example for the default setting this would be: |
| 80 | + |
| 81 | +```html |
| 82 | +<script src="https://www.wiris.net/demo/plugins/app/WIRISplugins.js?viewer=image"></script> |
| 83 | +``` |
| 84 | + |
| 85 | +## Documentation |
| 86 | + |
| 87 | +To find out more information about MathType, please go to the following documentation: |
| 88 | + |
| 89 | +- [Install instructions](https://docs.wiris.com/mathtype/en/mathtype-integrations/mathtype-for-html-editors/mathtype-for-tinymce.html?utm_source=npmjs&utm_medium=referral) |
| 90 | +- [MathType documentation](https://docs.wiris.com/en/mathtype/mathtype_web/start?utm_source=npmjs&utm_medium=referral) |
| 91 | +- [Introductory tutorials](https://docs.wiris.com/en/mathtype/mathtype_web/intro_tutorials?utm_source=npmjs&utm_medium=referral) |
| 92 | +- [Service customization](https://docs.wiris.com/en/mathtype/mathtype_web/integrations/config-table?utm_source=npmjs&utm_medium=referral) |
| 93 | +- [Testing](https://docs.wiris.com/en/mathtype/mathtype_web/integrations/html/plugins-test?utm_source=npmjs&utm_medium=referral) |
| 94 | + |
| 95 | +## Privacy policy |
| 96 | + |
| 97 | +The [MathType Privacy Policy](https://www.wiris.com/en/mathtype-privacy-policy/?utm_source=npmjs&utm_medium=referral) covers the data processing operations for the MathType users. It is an addendum of the company’s general Privacy Policy and the [general Privacy Policy](https://www.wiris.com/en/privacy-policy?utm_source=npmjs&utm_medium=referral) still applies to MathType users. |
0 commit comments