MoodleDocs - User contributions [en]

Cloze editor for Atto

2017-08-03T22:04:05Z

Dthies: Removing reference to a bug that was fixed some time ago

{{Infobox plugin
|type = Other, Activity module, Atto editor
|entry = https://moodle.org/plugins/atto_cloze
|tracker = https://github.com/dthies/moodle-atto_cloze/issues
|discussion = https://moodle.org/mod/forum/discuss.php?d=337286&parent=1359526
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
This is a Moodle (2.7 to 3.1) [[:Category:Contributed_code|contributed (third party)]] additional plugin, written by [https://moodle.org/user/profile.php?id=1470073 Daniel Thies], for easily making [[Embedded Answers (Cloze) question type]] inside the standard Moodle [[Atto]] text editor.

==Highlights==
* This is a very user-friendly contributed plugin for the [[Atto]] editor for Moodle branches 2.7 to 3.1.
* You can now have the power of the [[Embedded Answers (Cloze) question type]] without having to memorize the cloze syntax.
* A popup window will let you choose any one of the available question types to be embedded. A description of the question type is shown in your own [[Languages|language]], for you to easily choose the best question type to use.
* A 'Duplicate' button lets you easily and quickly write variants of a question, while keeping the distractors and feedback you had previously written, thus saving your valuable time !

== Background==
* The [[Embedded Answers (Cloze) question type]] is an extremely powerful question type, but its complicated syntax has discouraged many teachers from using it.
* A [https://moodle.org/plugins/pluginversions.php?plugin=tinymce_clozeeditor user-friendly cloze editor] was made for the TinyMCE editor (for Moodle 1.9 and 2.x) in 2013 by [https://moodle.org/user/profile.php?id=396043 Andreas Glombitza] who was a research fellow in Applied Linguistics and admin for multiple Moodles within EU research & development projects (currently PELLIC and Backbone), based at Universität Tübingen, Germany.
* The [https://github.com/andiglombitza/CLOZE_editor_Moodle2.2 GitHub source code for this plugin] was last updated by the author in March 2014.
* This plugin has been [https://moodle.org/plugins/stats.php?plugin=tinymce_clozeeditor increasingly installed] in many Moodle sites worldwide:
[[File:Sites using cloze editor plugin for TinyMCE.png|400px]]

* As of april 2014, Moodle 2.7 and newer branches have [[Atto]] as the default editor, but TinyMCE can still be raised as the user editor in the user preferences as explained in [https://docs.moodle.org/26/en/Cloze_editor_module#Installation_for_Moodle_2.7_and_higher_versions a Moodle Docs page].
* As of july 2016,''' two thirds of all registered Moodle sites''' are using versions 2.7 and higher!
[[File:All Moodle registrations by version in july 2016.png|200px]]
* We do not know for how long will [[TinyMCE]] still be included in the standard Moodle package.
* In late July 2016, the cloze editor plugin for TinyMCE was the [https://moodle.org/plugins/stats.php?plugin_category=45 third most downloaded plugin for TinyMCE] in Moodle.
* Even though Atto is the standard text editor for most registered Moodle sites, only [https://moodle.org/plugins/stats.php?plugin_category=53 two (other) plugins for Atto] have had as many or more downloads, in the previous three months !

* There was a very energetic exchange of opinions in one [https://moodle.org/mod/forum/discuss.php?d=335474#p1358594 Moodle forum thread] about improvements on the cloze question type
* Daniel Thies kindly volunteered to write a cloze editor for Atto, wrote the first version and improved on it for one month.
* It has been extensively tested in Moodle 3.1, 3.0, 2.9, 2.8 and 2.7 in several [[Language|languages]].
* Several user-friendly features have been incorporated into the current version.
* This Moodle Docs page was started to help new users of this plugin.

==Current status==
This plugin is available for installing or downloading from the [https://moodle.org/plugins/atto_cloze Moodle plugins database].

==Moodle branches supported==
* Moodle 3.1.1 testing has gone beautifully and all issues found have been happily solved.
* Moodle 3.0.5+ (Build: 20160721) testing for plugin version 2016073100 has gone beautifully and no issues were found.
* Moodle 2.9.7 (Build: 20160711) testing for plugin version 2016073100 has gone beautifully and no issues were found.
* Moodle 2.8.12 (Build: 20160509) testing for plugin version 2016073100 has gone beautifully and no issues were found.
* Moodle 2.7.15 (Build: 20160711) testing for plugin version 2016073100 has gone beautifully and no issues were found.
* Future Moodle branches will most likely be supported by [https://docs.moodle.org/dev/Releases#General_release_calendar the time they are released (May and November).]
** Moodle 3.2dev (Build: 20160728) testing for plugin version 2016073100 has gone beautifully and no issues were found.

==Moodle branches not supported==
* Moodle 2.6 and 2.5 branches: Even if you first install the [https://moodle.org/plugins/editor_atto Atto editor additional plugin], there is no way to configure the Atto toolbar to show the cloze button. This version of Atto is a very early version of Atto and is not the same as the one that was shipped with 2.7. That is why there is no config for it.

==Languages supported==
All Moodle 2.x and 3.x [[Language|languages]] supported by [https://lang.moodle.org/ AMOS] are supported by this plugin. If you do not see the translations of the different question types descriptions, please ask your [https://lang.moodle.org/local/amos/credits.php language pack maintainer].

==Installation==
===Automatic installation from the Moodle plugins database===
This plugin is available for installing or downloading from the [https://moodle.org/plugins/atto_cloze Moodle plugins database].

[[File:Atto cloze editor available in Moodle plugins database.png|600px]]

===Manually installing from GitHub===
* Go to https://github.com/dthies/moodle-atto_cloze and download the ZIP file
* Add the contents of this downloaded zip file in '... -> server-> moodle -> lib -> editor -> atto -> plugins ' directory and visit notifications to update database."
* You must re-name the 'moodle-atto-cloze-master' folder into 'cloze'
* After visiting notifications and updating the Moodle database, you must add the cloze button [[File:cloze icon.gif|16px]] to the Atto toolbar as described in https://docs.moodle.org/35/en/Text_editor#Adding_extra_buttons adding the line cloze = cloze .

[[File:Cloze_editor_for_Atto_toolbar_config_add_cloze_=_cloze.png|400px]]

*You may not notice any change because by default, the Atto toolbar has very few buttons showing:

[[File:Atto toolbar with few tools.png|400px]]

* Then, click on the very first button inside the Atto toolbar to expand the Atto toolbar:

* Now, when you expand the (normally small) Atto toolbar, you will see the [[File:cloze icon.gif|16px]] familiar cloze button.

[[File:Atto toolbar with many tools.png|400px]]

* You can now click on the [[File:cloze icon.gif|16px]] button to open the cloze editor popup window.
...
==Usage==
* Go to your [[Question bank]]
* To create a cloze [[Question types|question type]], choose 'cloze' in the question type chooser

[[File:Add a Cloze question type.png|400px]]

* You will have the [[Atto]] editor for writing your new question:

[[File:Make a question using Atto.png|400px]]

* Notice the following image where you must click on the (red square) first Atto button in order to expand the Atto toolbar, so that it shows the [[File:cloze icon.gif|16px]] cloze plugin button (green square):

[[File:Make a question using Atto expand toolbar.png|400px]]

* When you click on the cloze button inside the Atto toolbar, a popup window will let you choose any of the available question types. When you choose any question type, you will see a plain language description of what that question type does:
[[File:Cloze_editor_screen_with_add_and_cancel_buttons.png|400px]]

{{Note|The English language strings with the descriptions of the available question types are available for translation in [https://lang.moodle.org/ AMOS]. So, if you are using Moodle in a [[Language|language]] other than English, you may see these descriptions in your home language}}

[[File:ES_Cloze_editor_screen_with_add_and_cancel_buttons.png|400px]]

* Select the question type you want to use and click on the 'Add' button:

* If you had previoulsy blocked some text just before clicking on the cloze tool button, this text will be automatically inserted as the first correct answer.

[[File:ES_Cloze_editor_selected text inserted automatically as first answer.png|400px]]

* Notice that in the image above, the previously blocked word 'elephant' (green rectangle) was automatically inserted as the first correct answer (blue rectangle).

==Duplicate a question using the same distractors and feedback==
* There is a 'Duplicate' button on the chooser that loads the previous answers.
* The form will then populate with the same data as the previous question you just recently made.
* The advantage of having this is for producing several multichoice questions with the same distractors and feedback.
* This is specially useful if you want to create a matching type question.
[[File:Cloze editor screen with button to duplicate answers.png|400px]]
* You can create several variants from one original question very quickly:
[[File:cloze question plus two variants.png|200px]]

==A very simple English literature question example tutorial==
# Find an interesting text. Let's use a nice little poem, 'To make a praire', by Emily Dickinson.
To make a prairie it takes a clover and one bee,
One clover, and a bee.
And revery.
The revery alone will do,
If bees are few.
# Copy the text from [https://www.poets.org/poetsorg/poem/make-prairie-1755 an available public domain quote].
# Make a new question using the cloze question type.
# Paste the poem inside the box for the question text.
# Select one interesting word, 'prairie'.

[[File:cloze english literature 01.png|400px]]

# Then click on the Atto cloze tool and select a MULTICHOICE question.
# Write a couple of good distractors; eg, hill, lake.

[[File:cloze english literature 02.png|400px]]

# Now in the final sentence, select the word 'bees' in 'if bees are few'.
# Now make a SHORTANSWER question.

[[File:cloze english literature 03.png|400px]]

[[File:cloze english literature 04.png|400px]]

# Save the question.
# Preview the question and check that t works as expected.

[[File:cloze english literature 05.png|400px]]

==A very simple medical clinical case question tutorial==
# Read the excellent publication [http://www.nbme.org/publications/item-writing-manual-download.html 'Constructing Written Test Questions For the Basic and Clinical Sciences' by the (US) National Board of Medical Examiners]. Please see specially Section II: Writing One-Best-Answer Questions for the Basic and Clinical Sciences (pages 32 to 43 ).
# We will use the following very short sentence as an example:
Acute intermittent porphyria is the result of a defect in the biosynthetic pathway for heme.
# With this sentence, we will create several variant questions using the cloze editor.
# We must first create a category named ´porphyria' in our Question bank. Here we will store our new questions.
# Then we will create the questions, one at a time.
# For the first question, we will highlight 'porphyria' and make a cloze SHORTANSWER question.
# In order to make the second variant question, we will highlight 'a defect' and select MULTICHOICE, using the distractor wrong options of 'an increase', 'an atrophy' and ' a toxic blockage'.
# For the third variant, we will highlight 'heme' and make another SHORTANSWER question.
# We have stored these three different (variant) questions inside the previously made category named ´porphyria'.
# In a quiz we will use only one random question from this category, so that our medical students will randomly get one variant question for this problem.
# The most common simple cheating is discouraged (a little), because if the students tell each other that 'the answer for the porphyria question is heme', it will not make sense to the students that were asked to choose '''a defect''' in the biosynthetic pathway.
# We proceed similarly for 50 more clinical problems and create 3 variants for each problem. All variant questions for each subject are stored inside the corrresponding subject category.
# We should, of course, use real clinical cases from our own archives and maybe add a few gross, micoscopic and radiographic images if appropiate.

... to be continued...

==Available question types==

MULTICHOICE
[[File:Cloze_multichoice.png]]

MULTICHOICE_H
[[File:Type multichoice h.png]]

MULTICHOICE_V
[[File:Type multichoice v.png]]

NUMERICAL
[[File:Cloze numerical.png]]

SHORTANSWER
[[File:Cloze shortanswer.png]]

The following question types with an S in their names denote that the question behavior shuffle option (randomize the order for displaying the answers) is on:

MULTICHOICE_S
[[File:Type multichoice S.png]]

MULTICHOICE_HS
[[File:Type multichoice hs.png]]

MULTICHOICE_VS
[[File:Type multichoice vs.png]]

==See also==
* Discussion: [https://moodle.org/mod/forum/discuss.php?d=337286 in this forum thread]
* The [[Embedded Answers (Cloze) question type]] complete documentation page
* The [[Cloze editor for TinyMCE]] for the old TinyMCE editor.

[[Category:Questions]]
[[Category:Quiz]]
[[Category:Editing text]]
[[Category:Contributed code]]

[[es:Editor Cloze para Atto]]

Embedded Answers (Cloze) question type

2017-08-03T21:57:20Z

Dthies: /* See also */

{{Questions}}
'''Embedded answers (Cloze)''' questions consist of a passage of text (in Moodle format) that has various answers embedded within it, including multiple choice, short answers and numerical answers.

Until mid2013, there was no graphical interface to create these questions within your Moodle site - you needed to specify the question format using the text box or by importing them from external files.

You can link to an external web site that does create these questions from a graphical interface, see the ''[http://projects.ael.uni-tuebingen.de/quiz/htmlarea/index.php Online Cloze Question quiz generator]'' below.

There is an Excel-based [http://hbwubecc.wixsite.com/jordan/tools Cloze and GIFT Generator] that was presented at the 2017 Moodle Moot Japan.

There is a [[Cloze editor for TinyMCE]] that will let you create these questions from a graphical interface within your Moodle site, but it will overwrite your current HTML editor and only works with the [[TinyMCE editor]] but not with [[Atto]]. In 2016 a [[Cloze editor for Atto]] additional plugin was created.

Lots of people suggested that [[Hot Potatoes]] software is the easiest way to create Embedded answer (Cloze) questions. Once you have created your questions on your PC, you can then import them into Moodle's quiz module.

However, the flexibility of the Cloze question type is hard to equal and despite the minor coding that you need to create the questions, it has great worth in the Moodle Quiz.

==Question set-up==

#Select the question category
#Give the question a descriptive name - this allows you to identify it in the question bank.
#Enter the passage of text (in Moodle format - see [[Embedded_Answers_%28Cloze%29_question_type#Format|Format]] below) into the 'question text' field.
#Select an image to display if you want to add a picture to the question. For the student, it appears immediately above the question text.
#Set the 'default question grade' (i.e. the maximum number of marks for this question).
#Set the 'Penalty factor' (see [[Embedded_Answers_%28Cloze%29_question_type#Penalty_factor|Penalty factor]] below).
#If you wish, add general feedback. This is text that appears to the student after he/she has answered the question.
#The editor has been modified and allows you to test if your syntax is good. The different questions elements decoded will be displayed and syntax errors pinpoint. However, it cannot check if the question decoded is two questions in one because of an error syntax.
#Click Save changes to add the question to the category.

=== Penalty factor ===

The 'penalty factor' only applies when the question is used in a quiz using adaptive mode - i.e. where the student is allowed multiple attempts at a question even within the same attempt at the quiz. If the penalty factor is more than 0, then the student will lose that proportion of the '''maximum''' grade upon each successive attempt. For example, if the default question grade is 10, and the penalty factor is 0.2, then each successive attempt after the first one will incur a penalty of 0.2 x 10 = 2 points. The grading for the cloze question applies the penalty to each subpart of the question as a whole. For example, if you have three fill in the blanks each worth 1 point each, then the penalty will only be incurred on the incorrect parts, not the questions as a whole.

==Question rendering==

The question answer entry space or INPUT HTML ELEMENT (for Short Answer and Numerical question types) and the dropdown list or SELECT HTML ELEMENT (for multichoice) are normally displayed in-line with the text.

The size of the entry space or INPUT HTML ELEMENT ( Short and Numerical) will be adjustable to the length of the longest answer (good or bad) + a random number (0 to 15% total length).([[User:Pierre Pichet|Pierre Pichet]] 15:37, 26 January 2008 (CST))

The size will adjust to the length of the student response when displayed in the grading and feedback process.

The size of the dropdown list or SELECT HTML ELEMENT (multichoice) adjusts itself automatically to the longest answer.

==Format==

Questions consist of a passage of text (in Moodle format) that has various sub-questions embedded within it, including

* short answers (SHORTANSWER or SA or MW), case is unimportant,
* short answers (SHORTANSWER_C or SAC or MWC), case must match,
* numerical answers (NUMERICAL or NM),
* multiple choice (MULTICHOICE or MC), represented as a dropdown menu in-line in the text,
* multiple choice (MULTICHOICE_V or MCV), represented as a vertical column of radio buttons, or
* multiple choice (MULTICHOICE_H or MCH), represented as a horizontal row of radio-buttons,
* when the quiz question behavior shuffle option IS SET YES, the following multiple choice sub-questions elements will be shuffled,
* multiple choice (MULTICHOICE_S or MCS), represented as a dropdown menu in-line in the text,
* multiple choice (MULTICHOICE_VS or MCVS), represented as a vertical column of radio buttons, or
* multiple choice (MULTICHOICE_HS or MCHS), represented as a horizontal row of radio-buttons.

{{Note|MCS, MCVS, MCHS are new (Moodle 3.0) Cloze subquestion types with shuffling of answers. See MDL-38214.}}

The structure of each cloze sub-question is identical:
:'''{''' start the cloze sub-question with a bracket (AltGr+7)
:'''1''' define a grade for each cloze by a number (optional). This used for calculation of question grading.
:''':SHORTANSWER:''' define the type of cloze sub-question. Definition is bounded by ':'.
:'''~''' is a seperator between answer options
:'''=''' marks a correct answer
:'''#''' marks the beginning of an (optional) feedback message
:'''}''' close the cloze sub-question at the end with a bracket (AltGr+0)

Now a very simple example:
<pre>
{1:SHORTANSWER:=Berlin} is the capital of Germany.
</pre>

For full details of the format for embedded-answers questions, see the [[Embedded_Answers_%28Cloze%29_question_type#Detailed_syntax_explanations|detailed syntax explanation]] below.

NB: Be careful when copying a cloze type question into the WYSIWYG HTML editor, as line breaks tend to get added, which destroys the question.

If the correct answer contains } # ~ / " or \ you will have to escape them by putting a \ in front of each such character. But [[https://moodle.org/mod/forum/discuss.php?d=275299 this is tricky]]. The { shouldn't be escaped, this can be vital in getting TeX expressions to work. In the feedback ~ and } must be escaped otherwise it will be interpreted as ''the next answer'' or ''end of the short answer section'' respectively. Quotation signs: " can lead to trouble anyhow in both places. Use the HTML entity: & quot; (without the space between ''&'' and ''quot;''). If you want to have Mathematical symbols there can be problems with the \ used in TeX expressions. One alternative can be to use [[unicode]] characters.

See the notes further down about numerical embedded question!

===Examples===

====Example 1====
The following text creates a simple embedded-answers question:

Match the following cities with the correct state:
* San Francisco: {1:MULTICHOICE:=California#OK~Arizona#Wrong}
* Tucson: {1:MULTICHOICE:California#Wrong~%100%Arizona#OK}
* Los Angeles: {1:MULTICHOICE:=California#OK~Arizona#Wrong}
* Phoenix: {1:MULTICHOICE:%0%California#Wrong~=Arizona#OK}
The capital of France is {1:SHORTANSWER:%100%Paris#Congratulations!
~%50%Marseille#No, that is the second largest city in France (after
Paris).~*#Wrong answer. The capital of France is Paris, of course.}.

And the result will be:

[[Image:Cloze.gif|Cloze question type]]

====Example 2====
<div style="padding: 1em;border: 1px dashed #FFB53A;color: black;background-color: #f9f9f9;font-family: monospace;font-size:1.2em;">
This question consists of some text with an answer embedded right here {1:MULTICHOICE:Wrong answer#Feedback for this wrong answer~Another wrong answer#Feedback for the other wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer}

and right after that you will have to deal with this short answer {1:SHORTANSWER:Wrong answer#Feedback for this wrong answer~=Correct answer#Feedback for correct answer~%50%Answer that gives half the credit#Feedback for half credit answer}

and finally we have a floating point number {2:NUMERICAL:=23.8:0.1#Feedback for correct answer 23.8~%50%23.8:2#Feedback for half credit answer in the nearby region of the correct answer}.

The multichoice question can also be shown in the vertical display of the standard moodle multiple choice.
{2:MCV:1. Wrong answer#Feedback for this wrong answer~2. Another wrong answer#Feedback for the other wrong answer~=3. Correct answer#Feedback for correct answer~%50%4. Answer that gives half the credit#Feedback for half credit answer}

Or in an horizontal display that is included here in a table
{2:MCH:a. Wrong answer#Feedback for this wrong answer~b. Another wrong answer#Feedback for the other wrong answer~=c. Correct answer#Feedback for correct answer~%50%d. Answer that gives half the credit#Feedback for half credit answer}

A shortanswer question where case must match. Write moodle in upper case letters {1:SHORTANSWER_C:moodle#Feedback for moodle in lower case ~=MOODLE#Feedback for MOODLE in upper case ~%50%Moodle#Feedback for only first letter in upper case}

Note that addresses like www.moodle.org and smileys :-) all work as normal:

a) How good is this? {:MULTICHOICE:=Yes#Correct~No#We have a different opinion}

b) What grade would you give it? {3:NUMERICAL:=3:2}
</div>
[[Image:Cloze example.png]]

Some things to note:
* The individual embedded answers are represented by the code in braces {}.
* The number at the start is the 'weight', so in this case each answer contributes an equal share of the overall grade.
* The correct option in each case is preceded either by an = sign or by %100%.
* The text appearing after the # that follows each option is the feedback that the student will see if they choose that option.
* If the student enters 'Marseille' in the final example, they score 50% of the total grade.
* The asterisk * preceding the "Wrong answer" feedback in the final example means that the student will see this feedback if they enter anything other than "Paris" or "Marseille".
* For multiple choice vertical or horizontal rendering there is no automatic numbering, though can added at each answer.

==Detailed syntax explanations==
# all question items within a cloze-type question are coded inside curled braces { }
# the number which appears between the opening brace and the colon {1: is the weighting of that item; if it is set at 1 for all the items, it needs not be specified, so you can have {:
# after the colon we have the item question type: MULTICHOICE, SHORTANSWER, NUMERICAL
# '''NOTE'''.- If you have installed the [http://moodle.org/mod/data/view.php?d=13&rid=338 REGEXP question type plugin] you can also use the REGEXP question type
# the syntax for MULTICHOICE and SHORTANSWER is the same; the only difference is in the displaying of the item to the student
# the order of the various answers is indifferent (except if you want a catch-all for wrong answers, see #13 below)
# a correct answer is preceded with the equal sign = or a percentage (usually %100%) - '''Note''': [[Talk:Embedded_Answers_(Cloze)_question_type| The equal sign (=) doesn't seem to work with SHORTANSWER.]]
# a wrong answer is preceded with nothing or a percentage (usually %0%)but you can even use negative points by preceding with ~%-25% [not before Moodle 2.0])
# you can allocate some points between 0 and 100 to some answers, if you put the appropriate percentage
# all answers except the first one are separated from one another by the tilde ~ sign
# answers can be followed by an optional feedback message, preceded with the # sign; if there is no feedback message, the # sign can be present or absent, it does not matter
# note that the feedback message and the correct answer are displayed in a small popup window (if and when the correct and or feedback have been declared accessible to the students in the Quiz settings) upon mouse hovering. The popup window has a title "feedback" and you can use HTML tags to format your feedback. In some browsers (For example IE5.5) the form fields can cover part of the feedback windows. It can help to not have the formfields for the answers too close to each other.
# in the SHORTANSWER type you may want to put a catch-all (wrong) answer in order to send a "wrong, try again" feedback; you can do this by inserting an asterisk '''*''' as '''the very last expected answer''' in your formula

==Numerical Cloze questions==

From the student perspective, a numerical Cloze question looks just like a short-answer question or ''fill in the blanks''.

The difference is that numerical answers are allowed to have an accepted error. This allows a continuous range of answers to be set. You can also express your answer in some different numerical formats. 23.4 23,4 (some countries use , as a decimal separator) and 2.34E+1 (meaning 2.34*10^1) would be interpreted as the same.

=== False positives ===

'''Note:''' the following examples of false positives do '''not''' apply to Moodle 1.8+, where you cannot use percentages or fractions as the answers in a numerical Cloze test; Moodle will generate an error if you try to save such a question. However the following may be relevant for earlier versions of Moodle.

More examples:
0.5 accepts .5 0.5 ,5 0,5 0.500 5e-1 5E-1 but not 1/2 50%
50% accepts 50% 50.0% 5E1% 50/100 even '''50/1000 50''' but not 500/1000 0.5
1/2 accepts 1/2 '''1/3 1twenty''' but not 2/4 0.5 0,5 3/6 50% ½
½ accepts ½
HALF doesn't even accept HALF (maybe '''0'''?)

If you want to accept several variants you can have them in the same {} but '''be careful, notice the "false positives" in bold'''!

===Syntax for numerical Cloze questions===

The format of a NUMERICAL Cloze question is similar to that of the other Cloze types and they can be mixed in the same question. As with other Cloze tests, you write your question or incomplete text, and add the Cloze code at the point where the student is supposed to enter their numerical answer.

An example of the syntax used is shown below:

'''Note: ''' It is preferable to write the code in 'source code' mode. The WSIWYG editor can insert linebreaks that make the question not function. The linebreak in the example box below is for readability only! A problem with these questions is the readability of the code! :(

{2:NUMERICAL:=23.8:0.1#Feedback for correct answer 23.8
~%50%23.8:2#Feedback for ½credit near correct answer}.

In this example:
* 2: is the question point weight, which means that this question has twice the weight in the final point(s) for this question as other partial answers with weight 1 (or no declared weight - you can start with {: for the default weight 1) in the same question.
* NUMERICAL: says what kind of question it is. It must be in CAPS.
* =23.8:0.1 = or %100% means correct if the answer is 23.8 with an accepted error of 0.1, then any number between 23.7 and 23.9 will be accepted as correct. (In the GIFT numerical question one can express an interval like this 13..15 or 14:1 but in Cloze only 14:1 works.)
* #Feedback for correct answer 23.8 is preceded by #
* ~%50%23.8:2 ~ is the separator for answer alternatives %50% means this answer would get 50% of the score that the more precise answer had gotten. Because the tolerance here is 2, 21.8 to 25.8 would get this point and feedback.

The feedback (which is seen within a popup window when the user hovers over the answer space) is formattable with HTML tags. For example, if you want an exponent, surround it with superscript tags: <sup> </sup>. You can even include pictures in the feedback popup, but you must clean out all " characters and save while still in source code mode (not WYSIWYG). So, this works in feedback popup:
#See this picture:<br><img src=Something.gif />}
but not this:
#See this picture:<br><img src="Something.gif" />}

(ALGEBRA and TEX filters don't work in the feedback popups, but they can be very useful in the question writing for math/science expressions). But you can use [[Unicode]] characters.

If you want to give feedback for any answer that didn't fit the intervals you already have specified feedback for, add some BIG general intervals, like for positive answers (if they aren't bigger than 20000 you could add:
~%0%10000.0001:10000#Feedback for unspecified not_right answers}
This would give feedback for anything from 0.0001 to 20000.0001 (that hadn't already gotten feedback). I didn't want to include 0 since that special case as well as negative ought to have specific reactions.
~%0%0#Hey! It can't be zero
~%0%-10000.0001:10000#We just want the size here,
so a negative value is not what we want}

Numerical questions could, before version 1.7, also have case-insensitive non-numerical answers. This is useful whenever the answer for a numerical question is something like +inf, -inf, NaN etc.
==Importing CLOZE questions==
If you try importing directly as CLOZE this text:
<pre>
Single line per question! Match the following cities with the correct state:
* San Francisco: {1:MULTICHOICE:=California#OK~Arizona#Wrong}
* Tucson: {1:MULTICHOICE:California#Wrong~%100%Arizona#OK}
* Los Angeles: {1:MULTICHOICE:=California#OK~Arizona#Wrong}
* Phoenix: {1:MULTICHOICE:%0%California#Wrong~=Arizona#OK}

The capital of France is {1:SHORTANSWER:%100%Paris#Congratulations!~%50%Marseille#No, that is the second largest city in France (after Paris).~*#Wrong answer. The capital of France is Paris, of course.}.

23+ 0.8 = {2:NUMERICAL:=23.8:0.1#Feedback for correct answer 23.8 ~%50%23.8:2#Feedback for ½credit near correct answer}. </pre>

You would get all three questions as different parts of '''ONE question'''. (NOTE see that there are no linebreaks between the { } !)

Multiple CLOZE questions can be imported using the XML format:
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<quiz>


<question type="cloze">
<name><text>Book Test #1</text>
</name>
<questiontext>
<text><![CDATA[..............]]></text>
</questiontext>
<generalfeedback>
<text></text>
</generalfeedback>
<shuffleanswers>0</shuffleanswers>
</question>


<question type="cloze">
<name><text>Book Test #2</text>
</name>
<questiontext>
<text><![CDATA[............]]></text>
</questiontext>
<generalfeedback>
<text></text>
</generalfeedback>
<shuffleanswers>0</shuffleanswers>
</question>

</quiz>
</pre>
You would put the question text including CLOZE code in the ....... spaces.

==Online Cloze Question generator==
* There is a website to generate CLOZE quizzes for Moodle (1.9 and 2.x and 3.x versions) and/or to try out the CLOZE editor integration for Moodle.
* This editor was built at the Chair of Applied English Linguistics at Universitaet Tuebingen, Germany, by Andreas Glombitza (andiglombitza(at)googlemail.com) and Achim Skuta (achim.skuta(at)googlemail.com).
* The authors are currently maintaining this software and webservice as a private project.

Website: [http://projects.ael.uni-tuebingen.de/quiz/htmlarea/index.php http://projects.ael.uni-tuebingen.de/quiz/htmlarea/index.php]

==Cloze editor plugin for TinyMCE==
* You can download a [https://moodle.org/plugins/view.php?plugin=other_cloze Moodle plugin from the Moodle plugins database] that will let you create these questions from a graphical interface within your Moodle site. There are versions available for Moodle 1.9, 2.x and 3.x.

==Cloze editor plugin for Atto==
This [[Cloze editor for Atto|new plugin for Moodle 3.1]] was developed by Daniel Thies and is available for download and install from the Moodle plugins database..

== Questions with student notes and feedback for teacher==
You can easily make one/many/all question(s) with an optional field for student notes and/or feedback for the teacher, as requested in [https://moodle.org/mod/forum/discuss.php?d=353587 this forum thread]. Note that only the first MULTICHOICE question is marked, and the two optional fields do not score positive nor negative points:

[[File:CLOZE question with student comment and teacher feedback.png]]

The full question for the above example is:

Which of the following options is the right answer ?
{1:MULTICHOICE_VS:~A wrong answer~Another wrong answer~Yet another wrong answer~%100%This is the only right answer}
Optionally:Write a personal note: {0:SHORTANSWER:~%0%I want to have a longer input box for the note.~%100%*}
Optionally:Send feedback to teacher:{0:SHORTANSWER:~%0%I want to have a longer input box for the feedback.~%100%*}

==See also==
* See the [http://projects.ael.uni-tuebingen.de/quiz/htmlarea/index.php online Cloze question generator].
* Download the newest version of the [[Cloze editor for TinyMCE]] for Moodle 1.9 and for Moodle 2.0 to 2.9 and 3.0) from [https://moodle.org/plugins/view.php?plugin=tinymce_clozeeditor the Moodle plugins database]
* Easily edit embedded answer questions with the additional plugin [[Cloze editor for Atto]] for Moodle 2.7+

This information was drawn from:
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=36521 Is there a guide to using the cloze format?] forum discussion
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=36430&parent=170308 Cloze-type question syntax] forum post

[[de:Lückentext-Frage]]
[[es:Tipo de Pregunta con respuestas incrustadas (Cloze)]]
[[fr:Question Cloze à réponses intégrées]]
[[ja: 穴埋め問題 ( Cloze ) タイプ]]
[[zh:填空題(克漏字)]]

Import glossary entries

2017-07-02T17:51:40Z

Dthies: /* See also */

{{Glossary}}Glossary entries can be exported and then imported into another glossary via an XML file.

==Importing glossary entries==

*As an editing teacher, access your glossary
*Go to ''Administration > Glossary administration > Import entries''

[[File:glossaryimport29.png]]

*Click the "Choose a file" button and browse for the exported entries XML file on your computer
*Select the destination for the new entries: either the current glossary or a new one
*If you want to import category information, click the checkbox.
*Click the "Submit" button.

[[File:xmlimportscreen.png]]

You'll then see a report of the entries and categories added to the glossary. If you enabled duplicate entries when you created the glossary, the import process will add all of the new definitions. Otherwise, it will not allow you to import any duplicate entries.

You will be listed as author of all the entries.

If your exported glossary included embedded images and/or attached files, these will also be imported into the new glossary.

== Troubleshooting ==

Possible causes of problems importing entries:
* If there are mistakes in the XML file such as the <entries> tag being missing or the <info> tag being in the wrong place. May happen if you have constructed the XML file manually or with some sort of tool like mailmerge in Word and your template is wrong.
* If there are top bit set characters in the text of the entities like concepts, definitions or keywords. Replace things like & with &amp;
* If there are tabs or spaces between entries. Not sure if spaces cause problems but best to remove any between the end of one tag and start of the next. e.g. Search and replace > < with >< via a text editor.
* In most cases the import is halted if any of these errors occur.
* Duplicates in the entries which clash with entries already when merging a glossary is usually not a problem.
* Warnings like <code>Warning: exec() has been disabled for security reasons in /moodle/lib/uploadlib.php on line 603</code> may not be the problem when importing but may distract one from dealing with problems with the format of the XML file.
* HTML and XHTML tags written within CONCEPT or DEFINITION elements will fail on import, showing "Array" instead of the desired content. To remedy this, try writing the (X)HTML tags within <![CDATA[ ]]> markup.
* If the glossary entries contain images, image paths will need amending by doing a search and replace in the XML file in order for the images to be displayed when the file is imported.

==Restoring a glossary activity backup==

An alternative method of importing glossary entries is to restore a glossary [[Activity backup|activity backup]] containing enrolled users. This method includes categories, images and attachments within glossary entries. When the glossary is restored, the authors of the entries will be the same as in the original glossary.

== See also ==

* Glossary - Excel to XML converter [http://www.focusedonlearning.com/share/glossaryimport.html]
* [http://moodle.org/mod/glossary/view.php?id=851 Glossary of common terms] with entries download link for importing to other Moodle sites
* [[Import and export FAQ]]
* [[XML FAQ]]
* [[Moodle glossary entries format]] can use the question bank to convert a variety of formats into an xml glossary file for import
Using Moodle forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=79120 Excel to Glossaries]
*[http://moodle.org/mod/forum/discuss.php?d=142346 Backup a glossary]
*[http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] contains an explanation of how to manually create an XML file from an Excel spreadsheet

[[de:Glossar erstellen#Glossareinträge_importieren]]
[[es:Importar entradas del glosario]]
[[fr:Importer/exporter un glossaire]]

Moodle glossary entries format

2016-07-08T02:04:08Z

Dthies:

{{Infobox plugin
|type = Question format plugin
|entry = https://moodle.org/plugins/view.php?plugin=qformat_glossary
|tracker = https://github.com/dthies/moodle-qformat_glossary/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=330708 Glossary export question format]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
The Moodle glossary entries format allows teachers and administrators to easily convert between glossary entries and quiz questions. Short answer, multiple choice and matching questions may be exported and downloaded as an XML file in the format used by Moodle glossary export. The file may then be imported into a glossary as a new set of entries. The correct answers are shown as terms or key words and the question text is used as the definition. Glossary export files can also be directly imported into the question bank as short answer questions. These can be then be used normally in a quiz. The definition will be presented and the term or key words will be marked as the correct answers.

Glossary entries will use the defaults for options set for new entries by the administrator for options not determined by question setting (i.e. autolinking). The question category name will be saved as the glossary category and vice versa; however, parent category names are not saved.

[[File:importglossaryentriesasquestions.png]]

File:importglossaryentriesasquestions.png

2016-07-08T01:58:38Z

Dthies: Select Moodle glossary entries as question import file format

Select Moodle glossary entries as question import file format

Moodle glossary entries format

2016-07-08T01:56:37Z

Dthies:

{{Infobox plugin
|type = Question format plugin
|entry = https://moodle.org/plugins/view.php?plugin=qformat_glossary
|tracker = https://github.com/dthies/moodle-qformat_glossary/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=330708 Glossary export question format]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:importglossaryentriesasquestions.png]]
The Moodle glossary entries format allows teachers and administrators to easily convert between glossary entries and quiz questions. Short answer, multiple choice and matching questions may be exported and downloaded as an XML file in the format used by Moodle glossary export. The file may then be imported into a glossary as a new set of entries. The correct answers are shown as terms or key words and the question text is used as the definition. Glossary export files can also be directly imported into the question bank as short answer questions. These can be then be used normally in a quiz. The definition will be presented and the term or key words will be marked as the correct answers.

Glossary entries will use the defaults for options set for new entries by the administrator for options not determined by question setting (i.e. autolinking). The question category name will be saved as the glossary category and vice versa; however, parent category names are not saved.

qformat/glossary

2016-07-06T20:44:28Z

Dthies: Redirected page to Moodle glossary entries format

#REDIRECT [[Moodle_glossary_entries_format]]

Moodle glossary entries format

2016-07-06T20:33:43Z

Dthies: Initial post

The Moodle glossary entries formats allows teachers and administrators to easily convert between glossaries entries and quiz questions. Short answer, multiple choice and matching questions may be exported and downloaded as an XML file in the format used by Moodle glossary export. The file may then be imported into a glossary as a new set of entries. The correct answers are shown as terms or key words and the question text is used as the definition. Glossary export files can also be directly imported into the question bank as short answer questions. These can be then be used normally in a quiz. The definition will be presented and the term or key words will be marked as the correct answers.

Mathslate for Atto

2015-03-17T00:08:52Z

Dthies: /* Installation */

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate
|tracker = https://github.com/dthies/moodle-atto_mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate for Atto.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[Atto]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which was included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate for Atto plugin is available from the plugin database. In addition the [[TinyMCE Mathslate]] plugin needs to be installed and [http://mathjax.org MathJax] 2.0 or later needs to be available. Mathslate for Atto is compatible with the MathJaxloader filter include in Moodle core. If this filter is enabled, it will provide MathJax access for Mathslate. The Mathslate button wil not appear in the toolbar on pages where MathJax is disabled even if the TeX filter is active.

===Installation===
The [[TinyMCE Mathslate]] plugin first needs to be installed to the lib/editor/tinymce/plugins directory of the Moodle root. The Mathslate for Atto plugin is installed in the lib/editor/atto/plugins directory. The administrator must log in and complete the installation process. The Mathslate for Atto plugin is enabled by the administrator by visiting the Atto toolbar settings page and adding 'mathslate' in the list of plugins to be displayed on the toolbar. MathJax also needs to be enabled on the system. This can be done with either the MathJax filter provided with Moodle 2.7+ or with MathJax included in the HTML header. The Mathslate button will only appear in the editor toolbar if MathJax is available on the page by one of these methods.

==Usage==
===Selecting mathematics===

Mathslate does not allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[es:Mathslate para Atto]]

Mathslate for Atto

2015-03-17T00:06:21Z

Dthies: /* Installation */

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate
|tracker = https://github.com/dthies/moodle-atto_mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate for Atto.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[Atto]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which was included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate for Atto plugin is available from the plugin database. In addition the [[TinyMCE Mathslate]] plugin needs to be installed and [http://mathjax.org MathJax] 2.0 or later needs to be available. Mathslate for Atto is compatible with the MathJaxloader filter include in Moodle core. If this filter is enabled, it will provide MathJax access for Mathslate. The Mathslate button wil not appear in the toolbar on pages where MathJax is disabled even if the TeX filter is active.

===Installation===
The TinyMCE Mathslate plugin first needs to be installed to the lib/editor/tinymce/plugins directory of the Moodle root. The Mathslate for Atto plugin is installed in the lib/editor/atto/plugins directory. The administrator must log in and complete the installation process. The Mathslate for Atto plugin is enabled by the administrator by visiting the Atto toolbar settings page and adding 'mathslate' in the list of plugins to be displayed on the toolbar. MathJax also needs to be enabled on the system. This can be done with either the MathJax filter provided with Moodle 2.7+ or with MathJax included in the HTML header. The Mathslate button will only appear in the editor toolbar if MathJax is available on the page by one of these methods.

==Usage==
===Selecting mathematics===

Mathslate does not allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[es:Mathslate para Atto]]

Mathslate for Atto

2015-03-15T18:42:02Z

Dthies: /* Requirements */

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate
|tracker = https://github.com/dthies/moodle-atto_mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate for Atto.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[Atto]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which was included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate for Atto plugin is available from the plugin database. In addition the [[TinyMCE Mathslate]] plugin needs to be installed and [http://mathjax.org MathJax] 2.0 or later needs to be available. Mathslate for Atto is compatible with the MathJaxloader filter include in Moodle core. If this filter is enabled, it will provide MathJax access for Mathslate. The Mathslate button wil not appear in the toolbar on pages where MathJax is disabled even if the TeX filter is active.

===Installation===
The TinyMCE Mathslate plugin first needs to be installed to the lib/editor/tinymce/plugins directory of the Moodle root. The Mathslate for Atto plugin is installed in the lib/editor/tinymce/plugins directory. The administrator must log in and complete the installation process. The Mathslate for Atto plugin is enabled by the administrator Atto toolbar settings page and adding 'mathslate' in the list of plugins displayed on the toolbar.

==Usage==
===Selecting mathematics===

Mathslate does not allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[es:Mathslate para Atto]]

Mathslate for Atto

2015-03-07T00:30:54Z

Dthies: /* Modifying Behaviour */

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate
|tracker = https://github.com/dthies/moodle-atto_mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate for Atto.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[Atto]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which was included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate for Atto plugin is available from the plugin database. In addition the [[TinyMCE Mathslate]] plugin needs to be installed and [http://mathjax.org MathJax] 2.0 or later needs to be available. Mathslate for Atto is compatible with the MathJaxloader filter include in Moodle core. If this filter is enabled, it will provide MathJax access for Mathslate.
===Installation===
The TinyMCE Mathslate plugin first needs to be installed to the lib/editor/tinymce/plugins directory of the Moodle root. The Mathslate for Atto plugin is installed in the lib/editor/tinymce/plugins directory. The administrator must log in and complete the installation process. The Mathslate for Atto plugin is enabled by the administrator Atto toolbar settings page and adding 'mathslate' in the list of plugins displayed on the toolbar.

==Usage==
===Selecting mathematics===

Mathslate does not allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[es:TinyMCE Mathslate]]

TinyMCE Mathslate

2015-03-07T00:21:49Z

Dthies:

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate Screenshot.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[TinyMCE]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which is included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate plugin is available from the plugin database. In addition [http://mathjax.org MathJax] 2.0 or later 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. The administrator must log in and complete the installation process.

===Configuration Options===
TinyMCE Mathslate has a setting page in the Administration panel under 'Plugins > Text Editors > TinyMCE > TinyMCE Mathslate '. There is a box to hide the plugin button when the [[TeX notation 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 it is needed if the [[TeX notation filter]] is normally the way [[Mathematics|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 allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[es:TinyMCE Mathslate]]

Mathslate for Atto

2015-03-07T00:21:21Z

Dthies: /* Selecting mathematics */

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate
|tracker = https://github.com/dthies/moodle-atto_mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate for Atto.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[Atto]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which was included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate for Atto plugin is available from the plugin database. In addition the [[TinyMCE Mathslate]] plugin needs to be installed and [http://mathjax.org MathJax] 2.0 or later needs to be available. Mathslate for Atto is compatible with the MathJaxloader filter include in Moodle core. If this filter is enabled, it will provide MathJax access for Mathslate.
===Installation===
The TinyMCE Mathslate plugin first needs to be installed to the lib/editor/tinymce/plugins directory of the Moodle root. The Mathslate for Atto plugin is installed in the lib/editor/tinymce/plugins directory. The administrator must log in and complete the installation process. The Mathslate for Atto plugin is enabled by the administrator Atto toolbar settings page and adding 'mathslate' in the list of plugins displayed on the toolbar.

==Usage==
===Selecting mathematics===

Mathslate does not allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[TinyMCE Mathslate]]
[[es:TinyMCE Mathslate]]

Mathslate for Atto

2015-03-07T00:19:27Z

Dthies: Created page with "{{Infobox plugin |type = Atto plugin |entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate |tracker = https://github.com/dthies/moodle-atto_mathslate/issues |disc..."

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_mathslate
|tracker = https://github.com/dthies/moodle-atto_mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate for Atto.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[Atto]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which was included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate for Atto plugin is available from the plugin database. In addition the [[TinyMCE Mathslate]] plugin needs to be installed and [http://mathjax.org MathJax] 2.0 or later needs to be available. Mathslate for Atto is compatible with the MathJaxloader filter include in Moodle core. If this filter is enabled, it will provide MathJax access for Mathslate.
===Installation===
The TinyMCE Mathslate plugin first needs to be installed to the lib/editor/tinymce/plugins directory of the Moodle root. The Mathslate for Atto plugin is installed in the lib/editor/tinymce/plugins directory. The administrator must log in and complete the installation process. The Mathslate for Atto plugin is enabled by the administrator Atto toolbar settings page and adding 'mathslate' in the list of plugins displayed on the toolbar.

==Usage==
===Selecting mathematics===

Mathslate does not the allow the selection of individual characters as with a word processor, but instead treats [[Mathematics|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[TinyMCE Mathslate]]
[[es:TinyMCE Mathslate]]

File:Mathslate for Atto.png

2015-03-07T00:13:49Z

Dthies: The Mathslate for Atto mathematics editor.

The Mathslate for Atto mathematics editor.

Toggle preview

2015-03-02T22:00:09Z

Dthies:

{{Infobox plugin
|type = Atto plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_preview
|tracker = https://github.com/dthies/moodle-atto_preview/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=280386 Mathematical Tools: Desmos embed quiz question]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
The Toggle preview plugin makes a preview button available to the Atto editor. This feature is handy especially in developmental and debugging situations. It enables the results of filters to be seen and the text to be corrected without first closing and reopening the editing page. When the button is pressed, the content of the editor is passed through the filters enabled on the editing page, and the result is displayed in an iframe over the content window over the editor content window.

[[File:show preview.png| Show preview]]

Pressing the button again closes the preview.

[[File:edit text.png| Toggle to edit]]

The site administrator can change the page layout of the preview to fit with the theme or desired usage of the site.

[[File:with print headers.png | With add header]]

Toggle preview

2015-03-02T20:59:52Z

Dthies:

The Toggle preview plugin makes a preview button available to the Atto editor. This feature is handy especially in developmental and debugging situations. It enables the results of filters to be seen and text corrected without first closing and reopening the editing page. When the button is pressed the content of the editor is passed through the filters enabled on the editing page and the result is displayed in an iframe over the content window over the editor content window. [[File:show preview.png| Show preview]]

Pressing the button again closes the preview. [[File:edit text.png| Toggle to edit]]

The site administrator can change the page layout of the preview to fit with the theme or desired usage of the site. [[File:with print headers.png | With add header]]

Toggle preview

2015-03-02T02:47:05Z

Dthies:

The Toggle preview plugin makes a preview button available to the Atto editor. When the button is pressed the content of the editor is passed through the filters enabled on the editing page and the result is displayed in an iframe over the content window over the editor content window.[[File:show preview.png| Show preview]]

Pressing the button again closes the preview. [[File:edit text.png| Toggle to edit]]

The site administrator can change the page layout of the preview to fit with the theme or desired usage of the site. [[File:with print headers.png | With add header]]

Toggle preview

2015-03-02T02:46:11Z

Dthies:

The Toggle preview plugin makes a preview button available to the Atto editor. When the button is pressed the content of the editor is passed through the filters enabled on the editing page and the result is displayed in an iframe over the content window over the editor content window.[[File:show preview.png| Show preview]] Pressing the button again closes the preview. [[File:edit text.png| Toggle to edit]]
The site administrator can change the page layout of the preview to fit with the theme or desired usage of the site. [[File:with print headers.png | With add header]]

File:with print headers.png

2015-03-02T02:43:19Z

Dthies: With page layout set to print. This include some headers on the preview.

With page layout set to print. This include some headers on the preview.

File:edit text.png

2015-03-02T02:40:51Z

Dthies: Show text with preview toggled off.

Show text with preview toggled off.

Toggle preview

2015-03-02T02:40:05Z

Dthies:

The Toggle preview plugin makes a preview button available to the Atto editor. When the button is pressed the content of the editor is passed through the filters enabled on the editing page and the result is displayed in an iframe over the content window over the editor content window.[[File:show preview.png| Show preview]] Pressing the button again closes the preview. [[File:edit text.png | Toggle to edit]]
The site administrator can change the page layout of the preview to fit with the theme or desired usage of the site. [[File:with print headers.png | With add header]]

File:show preview.png

2015-03-02T02:32:59Z

Dthies: Preview displayed with embedded layout.

Preview displayed with embedded layout.

Toggle preview

2015-03-02T02:31:30Z

Dthies:

The Toggle preview plugin makes a preview button available to the Atto editor. When the button is pressed the content of the editor is passed through the filters enabled on the editing page and the result is displayed in an iframe over the content window over the editor content window.[[File:show preview.png]] Pressing the button again closes the preview. [[File:edit text.png]]
The site administrator can change the page layout of the preview to fit with the theme or desired usage of the site. [[File:with print headers.png]]

Toggle preview

2015-03-01T20:59:40Z

Dthies: An Atto editor plugin that show a preview of the filtered editor content.

DragMath equation editor

2014-12-08T02:25:49Z

Dthies: Warning that it is not included in 2.8

<p class="note">'''WARNING:''' To use DragMath, you need to activate the TeX filter in Moodle. End users will also need to have a recent Java Runtime Environment installed. DragMath is no longer available in the new Atto editor introduced in Moodle 2.7. Dragmath was available in the TinyMCE editor in Moodle 2.7, it is not distributed in Moodle 2.8 and later. It is available elsewhere as a third-party plugin which may be downloaded an installed by an administrator.</p>
==Introduction==
To quote the W3C [http://www.w3.org/Math/Software/mathml_software_cat_editors.html]:
This is an open-source drag and drop equation editor written in Java.
Once an expression is created the user can convert it into a variety
of different linear syntax for mathematics, including MathML, LaTeX,
Maple, Maxima or any user defined style.
Created by Christoper Sangwin and Alexander Billingsley at the University of Birmingham as part of the [http://www.stack.bham.ac.uk STACK project], DragMath allows students to build mathematical expressions using a graphical drag-and-drop interface similar in appearance to that available in a number of office productivity suites.

John Isner initially created and maintained several files that allowed for integration of DragMath with HTMLArea, Moodle's editor in 2007. DragMath was then maintained by Marc Grober until it was integrated into core Moodle with the release of Moodle 2.0. An outgrowth of the development to integrate DragMath into tinyMCE has been the development of SEE by Mauno Korpelainen (a link to those plugins can be found below.)

To use DragMath, users must have the Java Runtime Environment (JRE) version 1.5 or higher installed on their desktop computers. Most systems come with the JRE as standard equipment, so you may not have to do anything. If you need to install the JRE manually, you can download it from [http://java.com/en/download/index.jsp here]. Note that the JRE is variously known as Java software for your computer, Java Runtime Environment, the Java Runtime, Runtime Environment, Runtime, Java Virtual Machine, Virtual Machine, Java VM, JVM, VM, or Java download.

You can see a demo of the DragMath editor [http://www.dragmath.bham.ac.uk/ here]. The DragMath interface is highly intuitive and anyone can be using it productively after a few minutes of trial-and-error. If you have questions about the editor, there is a short manual [http://www.dragmath.bham.ac.uk/doc/index.html here] which also discusses the various configuration options, some of which are mentioned briefly below.

==Using DragMath==
DragMath is based on the simple idea that the User who does not know a lot of TeX (pronounced Tech) can still create mathematical formula for publishing. In this case, Moodle is the dispaly agent so the TeX formulae are then rendered to a Moodle screen. This essentially means that with little experience, any Junior High Maths teacher can generate all the formulae they need for most aspects of Maths in Moodle.

===Creating simple expressions===

To begin, click on the DragMath insertion button. This opens The DragMath interface.

[[Image:dragmath02.png|thumb|200px|center|Opening Dragmath]]

The toolbar is different than you may expect, we are used to nice neat rows of buttons, but Dragmath has to use tabs. Each tab is tab is a collection of "templates", that is each symbol is a "template" and can be dragged and dropped onto the work space.

[[Image:dragmath01.png|thumb|200px|center|The DragMath Interface]]

To end editing and insert the script into the Moodle page, click the Insert button. This simple, but not simplistic, interface is a strength of DragMath. It make it easy for even novices to create complex formulae.

{| class="nicetable" align="center"
|-
| colspan="4"|'''A sequence for DragMath - click an image to enlarge'''
|-
|[[Image:dragmath04f.png|thumb|150px|Select the Tab with the symbols required]]
|[[Image:dragmath03.png|thumb|150px|Click, hold then drag'n'drop a symbol]]
|[[Image:dragmath04.png|thumb|150px|Enter the values, select an operation symbol]]
|[[Image:dragmath04a.png|thumb|150px|Select another symbol and drag'n'drop]]
|-
|[[Image:dragmath04b.png|thumb|150px|Add an equal (or other) sign]]
|[[Image:dragmath04c.png|thumb|150px|Add in a variable, (chi in this case) ]]
|[[Image:dragmath04d.png|thumb|150px|Click Insert]]
|[[Image:dragmath04e.png|thumb|150px|See the encoded result in the editing dialog.]]
|}

This same sequence of operations apply equally for all formulae, all insertions, no matter how complex they become.

You can insert a template from the toolbar by drag and drop or by a click on the template in the tab, then clicking in the workspace.

===Creating more complex expressions===

More complex expressions are pretty much more of the same as above. Creating a simple multiplication table matrix, for example, seems complex,but in DragNath, it is actually simple:

{| class="nicetable" align="center"
|-
| colspan="4"|'''A sequence for a simple Multiplication Matrice in DragMath - click an image to enlarge'''
|-
|[[Image:dragmath05.png|thumb|150px|Select the Tab and add in the multiplier]]
|[[Image:dragmath05a.png|thumb|150px|Click, hold then drag'n'drop the Matrix symbol]]
|[[Image:dragmath05b.png|thumb|150px|Enter the values, select a equal symbol]]
|[[Image:dragmath05c.png|thumb|150px|Add in the rows required]]
|-
|[[Image:dragmath05d.png|thumb|150px|Add in the columns required]]
|[[Image:dragmath05e.png|thumb|150px|Edit the Matrice ]]
|[[Image:dragmath05f.png|thumb|150px|Add the equal symbol]]
|[[Image:dragmath05g.png|thumb|150px|Add and edit in the second Matrice.]]
|}

===Locally saving and restoring a DragMath expression===
When you press the Insert button, DragMath inserts the export string into your text and the DragMath window closes. ''The exported string can no longer be manipulated using DragMath.'' If you decide to change the string, you have two options:
*delete the string (including the dollar signs or other token) and completely recreate it using DragMath
*edit the expression by hand
You can not tell DragMath to re-read the expression and show it again in two dimensions. This is a theoretical limitation, not a limitation of DragMath.

But suppose the expression is very complicated. It would be impractical to start over just to make a simple change. Before you Insert the expression, you can save a copy of the expression (a .drgm file) to your local disk using the Save button (see screenshot). Later, if you need to make a change, you open the saved .drgm file.

[[Image:Dragmath_save_and_restore.png|DragMath instructions]]

A .drgm file contains three-dimensional representation of your mathematical expression. It is a binary file that can only be opened by DragMath.
===Additional Editing===

There are times when '''DragMath''' is not going to have a symbol or something you might want. Or perhaps you left something out of the DragMath constuctor, so you want to include it manually. Most likely, for something like the matrix created earlier, I want to go to 15, which means I have to change the structure of the matrix, and edit in some numbers. This is easily done with a little forethought. Copy and paste and delete or edit what you want and do not want.

{| class="nicetable" align="center"
|-
| colspan="4"|'''Manually editing a DragMath construction - click an image to enlarge'''
|-
|[[Image:dragmath06a.png|thumb|150px|Select, copy and paste the original matrix]]
|[[Image:dragmath06b.png|thumb|150px|Edit to what is actually required]]
|[[Image:dragmath06c.png|thumb|150px|Delete the original matrix]]
|}

Sometimes however, you just want to include something you forgot, or rather, add something that was not there in the first place.

{| class="nicetable" align="center"
|-
| colspan="4"|'''Accurately editing a DragMath construction manually - click an image to enlarge'''
|-
|[[Image:dragmath06d.png|thumb|150px|Construct the original equation]]
|[[Image:dragmath06e.png|thumb|150px|Copy, then edit to what is actually required]]
|[[Image:dragmath06f.png|thumb|150px|Return to the edited page]]
|}

==What DragMath Does and How It Does It==
===Configuration files===
DragMath allows you to create your own configuration files. That means it can be used to parse and display what you tell it to parse and display. By way of example, DragMath comes with a number of configuration files, one of which has been specifically designed to place doubledollar tokens before and after inserted text. We have seen a number of people change the TeX tokens in Modle using MathJax, and then become nonplussed that DragMath stops working. No DragMath still works, but it is likely inserting tokens that MathJax is not parsing. This can get confusing if you have more than one display technology in place. DragMath allows you to alter the tokens it inserts, so you can quite easily, for example, have DragMath insert startmath or endmath if that is what you want to use for tokens.
===Language Files===
DragMath can also use quite a few languages.
==So! You want to use DragMath but don't want to use the TeX filter?==
===What?===
Yes. Moodle devs decided that you should not use DragMath unless you used the Moodle TeX filter (yes, over objections from lots of folk.) Does that mean that the TeX filter is the best way to go? Hardly. The TeX filter is rather long in the tooth, desperately in need of revision, and essentially only provides a fallback to a mimetex binary if you have not installed a TeX distribution. There are lots of other options for Math display in Moodle, may of them much easier to configure and use!
===Procedure===
====Decoupling DragMath from the Tex Filter====
Since default configuration of tinymce (the default editor) requires that TeX filter is enabled before Dragmath plugin can be used we need to edit file lib/editor/tinymce/lib.php

First, make a copy of that file to make sure that you can revert back to the original.

Second, open the file for editing (with an appropriate editor that will not do unseen things to the contents of your file)

Third, locate lines 107-111:

if (array_key_exists('filter/tex', $filters)) {
$xdragmath = 'dragmath,';
} else {
$xdragmath = '';
}

Fourth, replace all those lines with this one line:

$xdragmath = 'dragmath,';

removing the if statement that makes DragMath visible only if the TeX filter is turned on.

Fifth, save the file.

Sixth, replace the original file lib/editor/tinymce/lib.php with this modified version.

====Setting up another display mechanism====
Now DragMath will show up in your editor, but you have no way of displaying the TeX or other code that you might insert with DragMath. You can explore the docs and the Math forum and you will find quite a few other ways to display Math in Moodle. One very popular way is to use MathJax. Under Moodle 2.x the AdditionalHtml field can be used to add the reference to MathJax and even do some configuration.
To accomplish this, as an administrator of your site go to: Site administration -> Appearance -> Additional HTML -> Within HEAD
Now, add

<link rel="stylesheet" type="text/css" href="http://jsxgraph.uni-bayreuth.de/distrib/jsxgraph.css" media="screen" />
<script type="text/javascript" src="http://jsxgraph.uni-bayreuth.de/distrib/jsxgraphcore.js"></script>
<script type="text/javascript" src="http://jsxgraph.uni-bayreuth.de/distrib/GeonextReader.js"></script>
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
MathJax.Hub.Config({
tex2jax: {
inlineMath: [ ['$$','$$'], ["\$","\$"], ['@i','@i'] ],
displayMath:[ ["\\[","\\["], ['@d','@d'] ],
processEscapes: true
}
});
</script>

Save changes.

Make sure that Tex filter and Algebra filter are disabled in Site administration > Plugins > Filters > Manage filters

Your moodle 2 is now using MathJax from a cloud server in cdn.mathjax.org with given delimiters (in this example double dollars and @i for inlineMath and @d for displayMath). You can choose to use other delimiters in configuration if you want or swap hat are there, BUT you may not use delimiters Moodle employs for other purposes and you need to be very careful of the syntax. You do not need to have the same token for beginning and end (for example, one could use startmath and endmath as tokens. See http://mathjax.org for additional information on these and other parameters.

"Wait!", you say. "What about the first three lines I added to AdditionalHtml?" We thought you would never ask. These lines add access to jsxgraph and GeoNextReader which you can find discussed in these forums and at the jsxgraph site, http://jsxgraph.uni-bayreuth.de/wp/ Consider this temporary, as you shoulod update the jsxgraph reference to use its cloud source. See a discussion here: http://jsxgraph.uni-bayreuth.de/wp/download/

==See Also==
* [[Advanced Maths Tools]] For an explanation of the SEE tools
* [[Using TeX Notation]] Some ideas and syntax
* [[TeX notation filter]] Turning TeX on
* [http://www.youtube.com/watch?v=mfc7umQ2xLA| A simple YouTube video] Constructing a simple equation.

*[http://www.youtube.com/watch?feature=endscreen&NR=1&v=8wfjwJTa784| Dragmath tutorial 1]
*[http://www.youtube.com/watch?v=XIuMNrvsVN8| Dragmath tutorial 2]
*[http://www.youtube.com/watch?v=g98o0fpmosQ&feature=relmfu| Dragmath tutorial 3]
*[http://www.youtube.com/watch?v=88KN2Y-pJw0&feature=relmfu| Dragmath tutorial 4]

Discussion of the transition of DragMath to Moodle core: http://moodle.org/mod/forum/discuss.php?d=125977&parent=551794

[[ca:DragMath_editor_d%27equacions]]
[[es:Editor de ecuación DragMath]]

TinyMCE Mathslate

2014-11-24T00:51:16Z

Dthies: Add configuration tool link

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate Screenshot.png]]

==Description==

Mathslate is a [[Mathematics|mathematics]] editor that this plugin adds to the [[TinyMCE]] toolbar. It is similar in functionality to the [[DragMath_equation_editor | DragMath]] which is included in the Moodle core for [[TinyMCE]]. Mathslate however has no Java dependency, and consequently it should be usable in a larger variety of browsers, including those on mobile devices.
==Administration==
===Requirements===
The Mathslate plugin is available from the plugin database. In addition [http://mathjax.org MathJax] 2.0 or later 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. The administrator must log in and complete the installation process.

===Configuration Options===
TinyMCE Mathslate has a setting page in the Administration panel under 'Plugins > Text Editors > TinyMCE > TinyMCE Mathslate '. There is a box to hide the plugin button when the [[TeX notation 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 it is needed if the [[TeX notation filter]] is normally the way [[Mathematics|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|mathematics]] as blocks of code associated with well defined mathematical expressions. A selected expression appears highlighted in the workspace, 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 the workspace and then click the expression to move it 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, to undo the previous action, and to redo previously undone actions.
==Modifying Behaviour==
The appearance of the pop up window can be modified by editing the style sheet style.css in the plugin directory. The set of templates that appear in the tabs may be changed 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, or you can use the [http://dthies.github.io/moodle-editor_tinymce-mathslate/configuration.html online configuration tool]. Eventually, there may be a selection of files to choose from for different learning environments and subjects.

[[Category:Mathematics]]

[[es:TinyMCE Mathslate]]

TeX notation filter

2014-11-08T20:17:53Z

Dthies: /* Path of dvisvgm binary */

{{Filters}}
The TeX Filter is a core Moodle filter intended to allow one to convert tex expressions into GIF, PNG or SVG images. The filter relies on some additional binaries to accomplish this for expressions contained between appropriate tokens. Where these binaries are not available, Moodle provides for a fallback through the use of Mimetex. Versions of MimeTex for Linux (glib2.3 32bit), Windows, Mac OS X and FreeBSD are included in the Moodle distribution. There are other technologies available for displaying Tex (see the section on [[Mathematics]] tools for a discussion.)

'''Note''': being based on binaries it requires the availability of three PHP program execution functions: <code><nowiki>exec</nowiki></code>, <code><nowiki>shell_exec</nowiki></code> and <code><nowiki>system</nowiki></code>.

== Methods and Usage ==

To avoid confusion you should note that the TeX filter has two separate methods for converting the TeX notation to images. The preferred method is a collection of three binaries that you are responsible for installing (if they are not already present, though many webhosts make these available) and configuring on your server. The filter settings page relates entirely to this method. If this fails for any reason the filter will fall back to a single binary - MimeTeX. A number of different builds are included in the Moodle distribution for popular operating systems, though Mimetex and its bigger brother, MathTex are easy enough to compile and install if you have systems administration experience.

Before doing anything else, you need to go to ''Settings > Site administration > Plugins > Filters'' and activate the TeX Notation Filter. If you want to use the Algebra filter (another core filter) since the Algebra Filter is really only a "front end" to the Tex filter, you should also turn on the Algebra filter. For more information on the Algebra Filter see the [[Algebra filter]].

Once the filter is turned on and properly configured you can make use of it by
including a TeX expression delimited by double-dollar signs. Example:

$$ \sqrt{x + y} $$

If this does not display properly, see the information on debugging.

== MimeTeX ==

Moodle may use a pre-built MimeTeX binary (located in the filters/tex directory) as a fallback if it can't properly access dvips, convert and latex binaries. There are a number of different versions for different operating systems. The TeX filter picks the appropriate binary for the detected host operating system (you will need to hack the script if your operating system is not included). Note that your web server needs to be set up with appropriate permissions for running binaries in that location.

The [http://www.forkosh.com/mimetexmanual.html MimeTeX manual] is available but is arguably intended for persons with systems administration experience and does not specifically address the Moodle environment.

You should only use MimeTeX if installing the full LaTeX system fails or the binaries are not available on your system. The results are not nearly as good.

== Compatability with MathJax ==
{{New features}}

In Moodle 2.8, the TeX Notation and MathJaxloader filter may be used in combination. If both filters are enabled on the page, images will be displayed first by the TeX notation filter, and the MathJax version of the TeX expression will replace a little while later when MathJax has finished loading and processing. If both filters are available, a teacher may decide which to use in an activity by enabling one and disabling the other.

== Site administration settings ==

Location: TeX Notation settings link in ''Settings > Site administration > Plugins > Filters > Manage filters''

The TeX filter settings page are primarily intended to adjust the operation of the LaTeX renderer. The defaults for the three path settings are selected according to the detection of the operating system on which Moodle is running. These are simply suggested common values - Moodle does not check that the binaries actually exist at these locations. More recent versions of Moodle show a green tick or a red cross next to the path setting - this shows that the binary exists at that location (only). The settings have no effect on the operation of the MimeTex binary (used if any of these binaries are not found).

==== Installing the binaries ====

This depends on your platform, but for a typical install you are going to need a LaTeX implementation. On modern Linux implementations you should look for the 'texlive' package (e.g. ''apt-get install texlive'') although a Windows version is available (see [http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Tex Live]). It is highly unlikely that you will have all these binaries as part of a standard install. If you cannot find texlive you may have to install LaTeX, Ghostscript and ImageMagick separately. While not endorsed by Moodle.org, a simple installation binary for Windows is [http://miktex.org/| MikTeX].

The filter settings page will try to guess the most likely location for the binary files depending on the detected platform. If correct, green ticks will appear against each setting. If red crosses appear you will need to check and modify the settings as required. A simple check is made to establish if the binaries exist at the given paths. A tick or a cross is displayed alongside each as a result. Note that this does not check that the application actually works, just that it is there.

Some systems supply the fonts as separate packages. If you are having problems make sure you have all the fonts you need installed. You may need to track down an 'extra' fonts package to get the required maths fonts.

==== LaTeX preamble ====

Enables the LaTeX preamble to be specified. The default should work for most users, but you may need to change it to support non-latin character sets etc. Please see the LaTeX documentation for further details.

==== Transparent colour ====

This should be set to your normal text background colour. The default setting is #FFFFFF (i.e., white).

==== Density ====

This setting effects the size of the resulting image. The default setting is 120 pixels, and it produces an image of reasonable quality, but for some complicated equations, this still may not be enough. It may be that anything less is not going to produce an image of sufficient quality but the image size can be controlled by the TeX encoding when the page is rendered.

==== Path of ''latex'' binary ====

Path to standard latex binary.

On Unix based systems it is normally "/usr/bin/latex". On a MacOS X, the path is "/usr/texbin/".

In Windows, using MiKTeX, it is usually something like C:\texmf\miktex\bin\latex.exe

==== Path of ''dvips'' binary ====

Path to standard dvips binary - generally distributed as part of a LaTeX system.

On Unix based systems it is normally "/usr/bin/dvips". On a MacOS X, the path is "/usr/texbin/".

On Windows using MikTeX is is usually something like C:\texmf\miktex\bin\dvips.exe

==== Path of ''convert'' binary ====

Path to standard convert binary. It is necessary to produce GIF or PNG images from using the latex and dvips binaries. This is distributed as part of the Ghostscript system, or ImageMagick in Linux.

On Unix based systems it is normally "/usr/bin/convert". On a MacOS X, the path is "/usr/local/bin/".

On a Windows based PC the path is something like C:\Program Files\ImageMagick\convert.exe (for ImageMagick, but something else for GhostScript.)

==== Path of ''dvisvgm'' binary ====
{{New features}}

Path to dvisvgm binary. This binary is used instead of convert to produce SVG images. This is distributed as part of TeXlive on Linux although it may be require the full or extra packages to be installed.

On Unix based systems it is normally "/usr/bin/dvisvgm".

On a Windows based PC a compiled binary is available from [http://dvisvgm.sourceforge.net/Downloads sourceforge] and can placed in the same directory with the latex binary.

==== Path of ''mimetex'' binary ====

If this is blank and the binaries above are missing or fail, the TeX filter will attempt to use a mimetex binary distributed with Moodle. If you have installed mimetex on the server and would rather use it include the path here.

== Debugging TeX filter ==

The TeX filter has a debugging script (which will be much more helpful if you turn moodle debugging on) included that should help if you are having problems. The URL will be as follows...

<nowiki>http://your.moodle.path/filter/tex/texdebug.php</nowiki>

You can either enter this path explicitly or with appropriate role permissions the TeX images (or more likely incorrectly rendered text, if you need debugging) will link to this. On more recent versions of Moodle you are ''required'' to be logged in as an Administrator to access this facility.

== See also ==

* [http://moodle.org/mod/glossary/view.php?id=2739&mode=letter&hook=M&sortkey=CREATION&sortorder=asc TeX Filter Glossary] - a [[Glossary|glossary]] you can add to your course which details usage of the supported [[TeX notation]].
* [http://www.latex-project.org/ LaTeX] - the LaTeX document preparation system.
* [http://www.ghostscript.com/ ghostscript] - required to render the image
* [http://www.forkosh.com/mimetexmanual.html MimeTeX Manual] - Default TeX notation manual
* [http://www.miktex.org/ MikTeX] - LaTeX for Windows systems
* [http://www.imagemagick.org/script/index.php ImageMagick] - required to render images for Windows
* [[Using TeX Notation]]
* [[Advanced Maths Tools]] for Moodle 2.x - SEE - The Next Generation of TeX Tools
* [https://moodle.org/mod/forum/view.php?id=752 Mathematics tools forum] on moodle.org

[[Category:Site administration]]
[[Category:Mathematics]]

[[de:TeX-Notation]]
[[es:Filtro de notación TeX]]

TeX notation filter

2014-11-08T20:16:56Z

Dthies: /* Path of dvisvgm binary */

{{Filters}}
The TeX Filter is a core Moodle filter intended to allow one to convert tex expressions into GIF, PNG or SVG images. The filter relies on some additional binaries to accomplish this for expressions contained between appropriate tokens. Where these binaries are not available, Moodle provides for a fallback through the use of Mimetex. Versions of MimeTex for Linux (glib2.3 32bit), Windows, Mac OS X and FreeBSD are included in the Moodle distribution. There are other technologies available for displaying Tex (see the section on [[Mathematics]] tools for a discussion.)

'''Note''': being based on binaries it requires the availability of three PHP program execution functions: <code><nowiki>exec</nowiki></code>, <code><nowiki>shell_exec</nowiki></code> and <code><nowiki>system</nowiki></code>.

== Methods and Usage ==

To avoid confusion you should note that the TeX filter has two separate methods for converting the TeX notation to images. The preferred method is a collection of three binaries that you are responsible for installing (if they are not already present, though many webhosts make these available) and configuring on your server. The filter settings page relates entirely to this method. If this fails for any reason the filter will fall back to a single binary - MimeTeX. A number of different builds are included in the Moodle distribution for popular operating systems, though Mimetex and its bigger brother, MathTex are easy enough to compile and install if you have systems administration experience.

Before doing anything else, you need to go to ''Settings > Site administration > Plugins > Filters'' and activate the TeX Notation Filter. If you want to use the Algebra filter (another core filter) since the Algebra Filter is really only a "front end" to the Tex filter, you should also turn on the Algebra filter. For more information on the Algebra Filter see the [[Algebra filter]].

Once the filter is turned on and properly configured you can make use of it by
including a TeX expression delimited by double-dollar signs. Example:

$$ \sqrt{x + y} $$

If this does not display properly, see the information on debugging.

== MimeTeX ==

Moodle may use a pre-built MimeTeX binary (located in the filters/tex directory) as a fallback if it can't properly access dvips, convert and latex binaries. There are a number of different versions for different operating systems. The TeX filter picks the appropriate binary for the detected host operating system (you will need to hack the script if your operating system is not included). Note that your web server needs to be set up with appropriate permissions for running binaries in that location.

The [http://www.forkosh.com/mimetexmanual.html MimeTeX manual] is available but is arguably intended for persons with systems administration experience and does not specifically address the Moodle environment.

You should only use MimeTeX if installing the full LaTeX system fails or the binaries are not available on your system. The results are not nearly as good.

== Compatability with MathJax ==
{{New features}}

In Moodle 2.8, the TeX Notation and MathJaxloader filter may be used in combination. If both filters are enabled on the page, images will be displayed first by the TeX notation filter, and the MathJax version of the TeX expression will replace a little while later when MathJax has finished loading and processing. If both filters are available, a teacher may decide which to use in an activity by enabling one and disabling the other.

== Site administration settings ==

Location: TeX Notation settings link in ''Settings > Site administration > Plugins > Filters > Manage filters''

The TeX filter settings page are primarily intended to adjust the operation of the LaTeX renderer. The defaults for the three path settings are selected according to the detection of the operating system on which Moodle is running. These are simply suggested common values - Moodle does not check that the binaries actually exist at these locations. More recent versions of Moodle show a green tick or a red cross next to the path setting - this shows that the binary exists at that location (only). The settings have no effect on the operation of the MimeTex binary (used if any of these binaries are not found).

==== Installing the binaries ====

This depends on your platform, but for a typical install you are going to need a LaTeX implementation. On modern Linux implementations you should look for the 'texlive' package (e.g. ''apt-get install texlive'') although a Windows version is available (see [http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Tex Live]). It is highly unlikely that you will have all these binaries as part of a standard install. If you cannot find texlive you may have to install LaTeX, Ghostscript and ImageMagick separately. While not endorsed by Moodle.org, a simple installation binary for Windows is [http://miktex.org/| MikTeX].

The filter settings page will try to guess the most likely location for the binary files depending on the detected platform. If correct, green ticks will appear against each setting. If red crosses appear you will need to check and modify the settings as required. A simple check is made to establish if the binaries exist at the given paths. A tick or a cross is displayed alongside each as a result. Note that this does not check that the application actually works, just that it is there.

Some systems supply the fonts as separate packages. If you are having problems make sure you have all the fonts you need installed. You may need to track down an 'extra' fonts package to get the required maths fonts.

==== LaTeX preamble ====

Enables the LaTeX preamble to be specified. The default should work for most users, but you may need to change it to support non-latin character sets etc. Please see the LaTeX documentation for further details.

==== Transparent colour ====

This should be set to your normal text background colour. The default setting is #FFFFFF (i.e., white).

==== Density ====

This setting effects the size of the resulting image. The default setting is 120 pixels, and it produces an image of reasonable quality, but for some complicated equations, this still may not be enough. It may be that anything less is not going to produce an image of sufficient quality but the image size can be controlled by the TeX encoding when the page is rendered.

==== Path of ''latex'' binary ====

Path to standard latex binary.

On Unix based systems it is normally "/usr/bin/latex". On a MacOS X, the path is "/usr/texbin/".

In Windows, using MiKTeX, it is usually something like C:\texmf\miktex\bin\latex.exe

==== Path of ''dvips'' binary ====

Path to standard dvips binary - generally distributed as part of a LaTeX system.

On Unix based systems it is normally "/usr/bin/dvips". On a MacOS X, the path is "/usr/texbin/".

On Windows using MikTeX is is usually something like C:\texmf\miktex\bin\dvips.exe

==== Path of ''convert'' binary ====

Path to standard convert binary. It is necessary to produce GIF or PNG images from using the latex and dvips binaries. This is distributed as part of the Ghostscript system, or ImageMagick in Linux.

On Unix based systems it is normally "/usr/bin/convert". On a MacOS X, the path is "/usr/local/bin/".

On a Windows based PC the path is something like C:\Program Files\ImageMagick\convert.exe (for ImageMagick, but something else for GhostScript.)

==== Path of ''dvisvgm'' binary ====
{{new features}}

Path to dvisvgm binary. This binary is used instead of convert to produce SVG images. This is distributed as part of TeXlive on Linux although it may be require the full or extra packages to be installed.

On Unix based systems it is normally "/usr/bin/dvisvgm".

On a Windows based PC a compiled binary is available from [http://dvisvgm.sourceforge.net/Downloads sourceforge] and can placed in the same directory with the latex binary.

==== Path of ''mimetex'' binary ====

If this is blank and the binaries above are missing or fail, the TeX filter will attempt to use a mimetex binary distributed with Moodle. If you have installed mimetex on the server and would rather use it include the path here.

== Debugging TeX filter ==

The TeX filter has a debugging script (which will be much more helpful if you turn moodle debugging on) included that should help if you are having problems. The URL will be as follows...

<nowiki>http://your.moodle.path/filter/tex/texdebug.php</nowiki>

You can either enter this path explicitly or with appropriate role permissions the TeX images (or more likely incorrectly rendered text, if you need debugging) will link to this. On more recent versions of Moodle you are ''required'' to be logged in as an Administrator to access this facility.

== See also ==

* [http://moodle.org/mod/glossary/view.php?id=2739&mode=letter&hook=M&sortkey=CREATION&sortorder=asc TeX Filter Glossary] - a [[Glossary|glossary]] you can add to your course which details usage of the supported [[TeX notation]].
* [http://www.latex-project.org/ LaTeX] - the LaTeX document preparation system.
* [http://www.ghostscript.com/ ghostscript] - required to render the image
* [http://www.forkosh.com/mimetexmanual.html MimeTeX Manual] - Default TeX notation manual
* [http://www.miktex.org/ MikTeX] - LaTeX for Windows systems
* [http://www.imagemagick.org/script/index.php ImageMagick] - required to render images for Windows
* [[Using TeX Notation]]
* [[Advanced Maths Tools]] for Moodle 2.x - SEE - The Next Generation of TeX Tools
* [https://moodle.org/mod/forum/view.php?id=752 Mathematics tools forum] on moodle.org

[[Category:Site administration]]
[[Category:Mathematics]]

[[de:TeX-Notation]]
[[es:Filtro de notación TeX]]

TeX notation filter

2014-11-08T20:15:51Z

Dthies: /* Compatability with MathJax */

{{Filters}}
The TeX Filter is a core Moodle filter intended to allow one to convert tex expressions into GIF, PNG or SVG images. The filter relies on some additional binaries to accomplish this for expressions contained between appropriate tokens. Where these binaries are not available, Moodle provides for a fallback through the use of Mimetex. Versions of MimeTex for Linux (glib2.3 32bit), Windows, Mac OS X and FreeBSD are included in the Moodle distribution. There are other technologies available for displaying Tex (see the section on [[Mathematics]] tools for a discussion.)

'''Note''': being based on binaries it requires the availability of three PHP program execution functions: <code><nowiki>exec</nowiki></code>, <code><nowiki>shell_exec</nowiki></code> and <code><nowiki>system</nowiki></code>.

== Methods and Usage ==

To avoid confusion you should note that the TeX filter has two separate methods for converting the TeX notation to images. The preferred method is a collection of three binaries that you are responsible for installing (if they are not already present, though many webhosts make these available) and configuring on your server. The filter settings page relates entirely to this method. If this fails for any reason the filter will fall back to a single binary - MimeTeX. A number of different builds are included in the Moodle distribution for popular operating systems, though Mimetex and its bigger brother, MathTex are easy enough to compile and install if you have systems administration experience.

Before doing anything else, you need to go to ''Settings > Site administration > Plugins > Filters'' and activate the TeX Notation Filter. If you want to use the Algebra filter (another core filter) since the Algebra Filter is really only a "front end" to the Tex filter, you should also turn on the Algebra filter. For more information on the Algebra Filter see the [[Algebra filter]].

Once the filter is turned on and properly configured you can make use of it by
including a TeX expression delimited by double-dollar signs. Example:

$$ \sqrt{x + y} $$

If this does not display properly, see the information on debugging.

== MimeTeX ==

Moodle may use a pre-built MimeTeX binary (located in the filters/tex directory) as a fallback if it can't properly access dvips, convert and latex binaries. There are a number of different versions for different operating systems. The TeX filter picks the appropriate binary for the detected host operating system (you will need to hack the script if your operating system is not included). Note that your web server needs to be set up with appropriate permissions for running binaries in that location.

The [http://www.forkosh.com/mimetexmanual.html MimeTeX manual] is available but is arguably intended for persons with systems administration experience and does not specifically address the Moodle environment.

You should only use MimeTeX if installing the full LaTeX system fails or the binaries are not available on your system. The results are not nearly as good.

== Compatability with MathJax ==
{{New features}}

In Moodle 2.8, the TeX Notation and MathJaxloader filter may be used in combination. If both filters are enabled on the page, images will be displayed first by the TeX notation filter, and the MathJax version of the TeX expression will replace a little while later when MathJax has finished loading and processing. If both filters are available, a teacher may decide which to use in an activity by enabling one and disabling the other.

== Site administration settings ==

Location: TeX Notation settings link in ''Settings > Site administration > Plugins > Filters > Manage filters''

The TeX filter settings page are primarily intended to adjust the operation of the LaTeX renderer. The defaults for the three path settings are selected according to the detection of the operating system on which Moodle is running. These are simply suggested common values - Moodle does not check that the binaries actually exist at these locations. More recent versions of Moodle show a green tick or a red cross next to the path setting - this shows that the binary exists at that location (only). The settings have no effect on the operation of the MimeTex binary (used if any of these binaries are not found).

==== Installing the binaries ====

This depends on your platform, but for a typical install you are going to need a LaTeX implementation. On modern Linux implementations you should look for the 'texlive' package (e.g. ''apt-get install texlive'') although a Windows version is available (see [http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Tex Live]). It is highly unlikely that you will have all these binaries as part of a standard install. If you cannot find texlive you may have to install LaTeX, Ghostscript and ImageMagick separately. While not endorsed by Moodle.org, a simple installation binary for Windows is [http://miktex.org/| MikTeX].

The filter settings page will try to guess the most likely location for the binary files depending on the detected platform. If correct, green ticks will appear against each setting. If red crosses appear you will need to check and modify the settings as required. A simple check is made to establish if the binaries exist at the given paths. A tick or a cross is displayed alongside each as a result. Note that this does not check that the application actually works, just that it is there.

Some systems supply the fonts as separate packages. If you are having problems make sure you have all the fonts you need installed. You may need to track down an 'extra' fonts package to get the required maths fonts.

==== LaTeX preamble ====

Enables the LaTeX preamble to be specified. The default should work for most users, but you may need to change it to support non-latin character sets etc. Please see the LaTeX documentation for further details.

==== Transparent colour ====

This should be set to your normal text background colour. The default setting is #FFFFFF (i.e., white).

==== Density ====

This setting effects the size of the resulting image. The default setting is 120 pixels, and it produces an image of reasonable quality, but for some complicated equations, this still may not be enough. It may be that anything less is not going to produce an image of sufficient quality but the image size can be controlled by the TeX encoding when the page is rendered.

==== Path of ''latex'' binary ====

Path to standard latex binary.

On Unix based systems it is normally "/usr/bin/latex". On a MacOS X, the path is "/usr/texbin/".

In Windows, using MiKTeX, it is usually something like C:\texmf\miktex\bin\latex.exe

==== Path of ''dvips'' binary ====

Path to standard dvips binary - generally distributed as part of a LaTeX system.

On Unix based systems it is normally "/usr/bin/dvips". On a MacOS X, the path is "/usr/texbin/".

On Windows using MikTeX is is usually something like C:\texmf\miktex\bin\dvips.exe

==== Path of ''convert'' binary ====

Path to standard convert binary. It is necessary to produce GIF or PNG images from using the latex and dvips binaries. This is distributed as part of the Ghostscript system, or ImageMagick in Linux.

On Unix based systems it is normally "/usr/bin/convert". On a MacOS X, the path is "/usr/local/bin/".

On a Windows based PC the path is something like C:\Program Files\ImageMagick\convert.exe (for ImageMagick, but something else for GhostScript.)

==== Path of ''dvisvgm'' binary ====

Path to dvisvgm binary. This binary is used instead of convert to produce SVG images. This is distributed as part of TeXlive on Linux although it may be require the full or extra packages to be installed.

On Unix based systems it is normally "/usr/bin/dvisvgm".

On a Windows based PC a compiled binary is available from [http://dvisvgm.sourceforge.net/Downloads sourceforge] and can placed in the same directory with the latex binary.

==== Path of ''mimetex'' binary ====

If this is blank and the binaries above are missing or fail, the TeX filter will attempt to use a mimetex binary distributed with Moodle. If you have installed mimetex on the server and would rather use it include the path here.

== Debugging TeX filter ==

The TeX filter has a debugging script (which will be much more helpful if you turn moodle debugging on) included that should help if you are having problems. The URL will be as follows...

<nowiki>http://your.moodle.path/filter/tex/texdebug.php</nowiki>

You can either enter this path explicitly or with appropriate role permissions the TeX images (or more likely incorrectly rendered text, if you need debugging) will link to this. On more recent versions of Moodle you are ''required'' to be logged in as an Administrator to access this facility.

== See also ==

* [http://moodle.org/mod/glossary/view.php?id=2739&mode=letter&hook=M&sortkey=CREATION&sortorder=asc TeX Filter Glossary] - a [[Glossary|glossary]] you can add to your course which details usage of the supported [[TeX notation]].
* [http://www.latex-project.org/ LaTeX] - the LaTeX document preparation system.
* [http://www.ghostscript.com/ ghostscript] - required to render the image
* [http://www.forkosh.com/mimetexmanual.html MimeTeX Manual] - Default TeX notation manual
* [http://www.miktex.org/ MikTeX] - LaTeX for Windows systems
* [http://www.imagemagick.org/script/index.php ImageMagick] - required to render images for Windows
* [[Using TeX Notation]]
* [[Advanced Maths Tools]] for Moodle 2.x - SEE - The Next Generation of TeX Tools
* [https://moodle.org/mod/forum/view.php?id=752 Mathematics tools forum] on moodle.org

[[Category:Site administration]]
[[Category:Mathematics]]

[[de:TeX-Notation]]
[[es:Filtro de notación TeX]]

Filters

2014-11-08T20:01:53Z

Dthies:

{{Managing content}}
Filters can be used to add links, insert multimedia players, convert Mathematical expressions or emoticons into images and more.

A filter may be enabled at the site level and then removed as needed at the course or activity level. Thus a teacher can disable glossary auto-linking in a quiz for example.

==Standard filters==

Filters in Moodle include:

*[[Activity names auto-linking filter|Activity names auto-linking]] - This scans text for activity titles that exist in the same course and creates a link
*[[Algebra filter|Algebra notation]] - This filter will convert algebra code into GIF images
*[[Convert URLs into links filter|Convert URLs into links]] - This filter converts URLs in selected formats, such as Moodle auto-format, to click-able links
*[[Database auto-linking filter|Database auto-linking]] - As the name suggests, this filter enables automatic linking of [[Database module]] entries
*[[Display emoticons as images filter|Display emoticons as images]] - This converts emoticon (smiley) characters into images
*[[Email protection filter|Email protection]] - This obfuscates email address links to make them more difficult for spammers to harvest
*[[Glossary auto-linking filter|Glossary auto-linking]] - This scans text for glossary entries that exist in the same course and creates a link
*[[MathJax filter|MathJax]] - For adding mathematical equations and expressions using an equation editor (new in 2.7 onwards)
*[[Multimedia plugins filter|Multimedia plugins]] - This finds a link in text that points to a multimedia resource and replaces the link with an appropriate multimedia player code which can play the resource
*[[Multi-language content filter|Multi-language content]] - This filter enables resources to be created in multiple languages
*[[TeX notation filter|TeX notation]] For displaying mathematics using images (new features in 2.8).
*[[Word censorship]] - This filter "blacks out" words found on a list

==Contributed filters==

Filters have also been made by developers in the community. Some docs online for these include:
*[[FontAwesome_filter|FontAwesome]] - This scans text for icons that can be embedded using the FontAwesome icon set.
*[[IPA_filter|IPA]] - Renders simple X-SAMPA markup in the International Phonetic Alphabet
*[[PoodLL_filter|PoodLL]] - is the core PoodLL plugin for Moodle. It contains all the recorders, widgets and the code that makes it possible to use them around Moodle. It is a required component for all the other PoodLL plugins.

==See also==

*[[Managing filters]]
*[[Filter settings|Common filter settings]] for the site
*[[Filters FAQ]]

[[Category:Filter]]

[[fr:Filtres 2.0]]
[[de:Filter]]
[[es:Filtros]]

Managing filters

2014-11-08T19:58:28Z

Dthies: /* Managing filters at site level */

{{Filters}}
==Managing filters at course or activity level==

To enable/disable filters in a course or activity:

#Go to ''Administration > Course administration > Filters'' or if you are in an activity ''Administration > Activity administration > Filters''
#Set each filter on or off as required
#Click the 'Save changes' button

==Managing filters at site level==

A site administrator can enable filters for the site in ''Administration > Site administration > Plugins > Filters > Manage filters''.

* Select 'On' (always available for all courses), 'Off but available' (teachers can choose whether to enable the filter for the course or activity) or 'Disabled' (always off for all courses) as required for each filter.

[[File:Multimediaplugins.png]]

* Use the up/down arrow icons to arrange the filters in the order in which they should be applied.
* If enabled, the [[MathJax filter]] should be at the top (applied first).
* The MathJax and TeX notation filters may be enabled at the same time beginning with 2.8. TeX notation will normally appear first and be replaced by later MathJax. Using both together may improve the user experience when all mathematics is in display mode.
* Leave all filters applying to content only unless you particularly need a filter, such as the [[Multi-language content filter]] to apply to headings too.

Certain filters have additional settings, which can be accessed via the links in the settings column.

Tip: The 'Off but available' setting is useful for example if you only want emoticons for use in social forums.

{|
| [[Image:Filter settings in forum.png|thumb|Filter settings in a forum|left]]
| [[File:manage filters.png|thumb|Manage filters at site level]]
|}

==Filters capabilities==

There is just one filters capability, [[Capabilities/moodle/filter:manage|Manage local filter settings]], which is allowed for the default roles of manager and teacher.

[[de:Filter verwalten]]
[[es:Gestionando filtros]]

TeX notation filter

2014-11-08T19:48:26Z

Dthies: Include dvisvgm information for 2.8

{{Filters}}
The TeX Filter is a core Moodle filter intended to allow one to convert tex expressions into GIF, PNG or SVG images. The filter relies on some additional binaries to accomplish this for expressions contained between appropriate tokens. Where these binaries are not available, Moodle provides for a fallback through the use of Mimetex. Versions of MimeTex for Linux (glib2.3 32bit), Windows, Mac OS X and FreeBSD are included in the Moodle distribution. There are other technologies available for displaying Tex (see the section on [[Mathematics]] tools for a discussion.)

'''Note''': being based on binaries it requires the availability of three PHP program execution functions: <code><nowiki>exec</nowiki></code>, <code><nowiki>shell_exec</nowiki></code> and <code><nowiki>system</nowiki></code>.

== Methods and Usage ==

To avoid confusion you should note that the TeX filter has two separate methods for converting the TeX notation to images. The preferred method is a collection of three binaries that you are responsible for installing (if they are not already present, though many webhosts make these available) and configuring on your server. The filter settings page relates entirely to this method. If this fails for any reason the filter will fall back to a single binary - MimeTeX. A number of different builds are included in the Moodle distribution for popular operating systems, though Mimetex and its bigger brother, MathTex are easy enough to compile and install if you have systems administration experience.

Before doing anything else, you need to go to ''Settings > Site administration > Plugins > Filters'' and activate the TeX Notation Filter. If you want to use the Algebra filter (another core filter) since the Algebra Filter is really only a "front end" to the Tex filter, you should also turn on the Algebra filter. For more information on the Algebra Filter see the [[Algebra filter]].

Once the filter is turned on and properly configured you can make use of it by
including a TeX expression delimited by double-dollar signs. Example:

$$ \sqrt{x + y} $$

If this does not display properly, see the information on debugging.

== MimeTeX ==

Moodle may use a pre-built MimeTeX binary (located in the filters/tex directory) as a fallback if it can't properly access dvips, convert and latex binaries. There are a number of different versions for different operating systems. The TeX filter picks the appropriate binary for the detected host operating system (you will need to hack the script if your operating system is not included). Note that your web server needs to be set up with appropriate permissions for running binaries in that location.

The [http://www.forkosh.com/mimetexmanual.html MimeTeX manual] is available but is arguably intended for persons with systems administration experience and does not specifically address the Moodle environment.

You should only use MimeTeX if installing the full LaTeX system fails or the binaries are not available on your system. The results are not nearly as good.

== Compatability with MathJax ==

In Moodle 2.8, the TeX Notation and MathJaxloader filter may be used in combination. If both filters are enabled on the page, images will be displayed first by the TeX notation filter, and the MathJax version of the TeX expression will replace a little while later when MathJax has finished loading and processing. If both filters are available, a teacher may decide which to use in an activity by enabling one and disabling the other.

== Site administration settings ==

Location: TeX Notation settings link in ''Settings > Site administration > Plugins > Filters > Manage filters''

The TeX filter settings page are primarily intended to adjust the operation of the LaTeX renderer. The defaults for the three path settings are selected according to the detection of the operating system on which Moodle is running. These are simply suggested common values - Moodle does not check that the binaries actually exist at these locations. More recent versions of Moodle show a green tick or a red cross next to the path setting - this shows that the binary exists at that location (only). The settings have no effect on the operation of the MimeTex binary (used if any of these binaries are not found).

==== Installing the binaries ====

This depends on your platform, but for a typical install you are going to need a LaTeX implementation. On modern Linux implementations you should look for the 'texlive' package (e.g. ''apt-get install texlive'') although a Windows version is available (see [http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Tex Live]). It is highly unlikely that you will have all these binaries as part of a standard install. If you cannot find texlive you may have to install LaTeX, Ghostscript and ImageMagick separately. While not endorsed by Moodle.org, a simple installation binary for Windows is [http://miktex.org/| MikTeX].

The filter settings page will try to guess the most likely location for the binary files depending on the detected platform. If correct, green ticks will appear against each setting. If red crosses appear you will need to check and modify the settings as required. A simple check is made to establish if the binaries exist at the given paths. A tick or a cross is displayed alongside each as a result. Note that this does not check that the application actually works, just that it is there.

Some systems supply the fonts as separate packages. If you are having problems make sure you have all the fonts you need installed. You may need to track down an 'extra' fonts package to get the required maths fonts.

==== LaTeX preamble ====

Enables the LaTeX preamble to be specified. The default should work for most users, but you may need to change it to support non-latin character sets etc. Please see the LaTeX documentation for further details.

==== Transparent colour ====

This should be set to your normal text background colour. The default setting is #FFFFFF (i.e., white).

==== Density ====

This setting effects the size of the resulting image. The default setting is 120 pixels, and it produces an image of reasonable quality, but for some complicated equations, this still may not be enough. It may be that anything less is not going to produce an image of sufficient quality but the image size can be controlled by the TeX encoding when the page is rendered.

==== Path of ''latex'' binary ====

Path to standard latex binary.

On Unix based systems it is normally "/usr/bin/latex". On a MacOS X, the path is "/usr/texbin/".

In Windows, using MiKTeX, it is usually something like C:\texmf\miktex\bin\latex.exe

==== Path of ''dvips'' binary ====

Path to standard dvips binary - generally distributed as part of a LaTeX system.

On Unix based systems it is normally "/usr/bin/dvips". On a MacOS X, the path is "/usr/texbin/".

On Windows using MikTeX is is usually something like C:\texmf\miktex\bin\dvips.exe

==== Path of ''convert'' binary ====

Path to standard convert binary. It is necessary to produce GIF or PNG images from using the latex and dvips binaries. This is distributed as part of the Ghostscript system, or ImageMagick in Linux.

On Unix based systems it is normally "/usr/bin/convert". On a MacOS X, the path is "/usr/local/bin/".

On a Windows based PC the path is something like C:\Program Files\ImageMagick\convert.exe (for ImageMagick, but something else for GhostScript.)

==== Path of ''dvisvgm'' binary ====

Path to dvisvgm binary. This binary is used instead of convert to produce SVG images. This is distributed as part of TeXlive on Linux although it may be require the full or extra packages to be installed.

On Unix based systems it is normally "/usr/bin/dvisvgm".

On a Windows based PC a compiled binary is available from [http://dvisvgm.sourceforge.net/Downloads sourceforge] and can placed in the same directory with the latex binary.

==== Path of ''mimetex'' binary ====

If this is blank and the binaries above are missing or fail, the TeX filter will attempt to use a mimetex binary distributed with Moodle. If you have installed mimetex on the server and would rather use it include the path here.

== Debugging TeX filter ==

The TeX filter has a debugging script (which will be much more helpful if you turn moodle debugging on) included that should help if you are having problems. The URL will be as follows...

<nowiki>http://your.moodle.path/filter/tex/texdebug.php</nowiki>

You can either enter this path explicitly or with appropriate role permissions the TeX images (or more likely incorrectly rendered text, if you need debugging) will link to this. On more recent versions of Moodle you are ''required'' to be logged in as an Administrator to access this facility.

== See also ==

* [http://moodle.org/mod/glossary/view.php?id=2739&mode=letter&hook=M&sortkey=CREATION&sortorder=asc TeX Filter Glossary] - a [[Glossary|glossary]] you can add to your course which details usage of the supported [[TeX notation]].
* [http://www.latex-project.org/ LaTeX] - the LaTeX document preparation system.
* [http://www.ghostscript.com/ ghostscript] - required to render the image
* [http://www.forkosh.com/mimetexmanual.html MimeTeX Manual] - Default TeX notation manual
* [http://www.miktex.org/ MikTeX] - LaTeX for Windows systems
* [http://www.imagemagick.org/script/index.php ImageMagick] - required to render images for Windows
* [[Using TeX Notation]]
* [[Advanced Maths Tools]] for Moodle 2.x - SEE - The Next Generation of TeX Tools
* [https://moodle.org/mod/forum/view.php?id=752 Mathematics tools forum] on moodle.org

[[Category:Site administration]]
[[Category:Mathematics]]

[[de:TeX-Notation]]
[[es:Filtro de notación TeX]]

TinyMCE Mathslate

2014-07-08T02:27:29Z

Dthies:

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File:Mathslate Screenshot.png]]

==Description==

Mathslate is a mathematics editor that this plugin adds to TinyMCE toolbar. It is similar in functionality to the [[DragMath_equation_editor | 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===
The Mathslate plugin is available from the plugin database. In addition [http://mathjax.org MathJax] 2.0 or later 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. The 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).

TinyMCE Mathslate

2014-06-07T00:50:36Z

Dthies:

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://github.com/dthies/moodle-editor_tinymce-mathslate/archive/MOODLE_26_STABLE.zip
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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).

TinyMCE Mathslate

2014-06-07T00:25:19Z

Dthies:

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://github.com/dthies/moodle-editor_tinymce-mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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).

TinyMCE Mathslate

2014-03-03T22:11:47Z

Dthies: /* Selecting mathematics */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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).

TinyMCE Mathslate

2014-03-03T22:09:08Z

Dthies: /* Selecting mathematics */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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.

[[Media:CompleteQuad.ogv]]

===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).

TinyMCE Mathslate

2014-03-03T22:06:23Z

Dthies: /* Selecting mathematics */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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.

[[File:CompleteQuad.ogv]]

===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).

TinyMCE Mathslate

2014-03-02T05:27:47Z

Dthies: /* Selecting mathematics */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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.

[[File:QuadraticFormual.ogv]]

===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).

TinyMCE Mathslate

2014-03-01T06:33:13Z

Dthies: /* Modifying Behaviour */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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).

TinyMCE Mathslate

2014-03-01T05:03:07Z

Dthies: /* Modifying Behaviour */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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 leaning environments and subjects (a version for chemical formulas is already in development).

TinyMCE Mathslate

2014-03-01T05:01:21Z

Dthies: /* Installation */

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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 popup 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 leaning environments and and subjects (a version for chemical formulas is already in development.

TinyMCE Mathslate

2014-03-01T04:59:40Z

Dthies:

{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}
[[File: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 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 popup 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 leaning environments and and subjects (a version for chemical formulas is already in development.

File:Mathslate Screenshot.png

2014-03-01T03:54:40Z

Dthies:

TinyMCE Mathslate

2014-03-01T03:53:39Z

Dthies:

[[File:Mathslate Screenshot.png]]
{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}

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.

TinyMCE Mathslate

2014-03-01T03:52:51Z

Dthies:

[[File:Mathslate Screenshot.png]
{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}

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.

TinyMCE Mathslate

2014-03-01T03:51:26Z

Dthies:

[[File:Mathslate Screenshot.jpg]]
{{Infobox plugin
|type = TinyMCE plugin
|entry = https://moodle.org/plugins/view.php?plugin=tinymce_mathslate
|tracker = https://github.com/dthies/moodle-editor_tinymce-mathslate/issues
|discussion = [https://moodle.org/mod/forum/discuss.php?d=255377 Mathslate TinyMCE plugin]
|maintainer = [[User:Daniel Thies|Daniel Thies]]
|float = right
}}

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.

TinyMCE Mathslate

2014-03-01T03:38:22Z

Dthies: