JExtBOX Equation Documentation

This extension helps to display your math equations, diagrams and figures.

Author
Galaa
Home Page
Extension Home Page
JED Page
Page on The JED
Live Demo
demo.jextbox.com
Compatibility
Joomla 3.x
Extension
component, plugin
Version
2.12.0 on 9 Nov 2018

This extension adds a functionality for inserting and displaying math equations (TeX/LaTeX) and figures (PSPicture). Also it supports equation numbering.

  1. Editor button for inserting math equations and figures
  2. Live preview and LaTeX template (typical scripts)
  3. Powered by MathJax: This plugin is based on MathJax.
  4. Custom installation: You can use a local installation of MatJax on your server.
  5. MathJax custom config & default config
  6. MathJax source: Content Delivery Network (CDN) or Local installation.
  7. Fallback: Loads the local installation, if CDN fails.
  8. Resource & time saving: Stops when any equation not detected on text of an article or whole body of HTML page.
  9. Direct conversion
    1. Converts LaTeX equations in HTML including content which is loaded by AJAX, to MathJax formatted script on the fly.
    2. Skips HTML tags: "pre" & "code", i.e. does not convert equations and pspictures inside these tags.
    3. Doesn't convert $ selector of JavaScript library in tags "script".
    4. Clean-up spaces after line equations.
  10. Supports pspicture: LaTeX2HTML5 or Mathapedia

2.12.0. Nov 9, 2018. Descriptions and language files was updated. The configuration form was improved. A minor bug for back-end about page was solved.

2.11.1. Sep 4, 2017. A minor bug for front-end editor has been solved.

2.11.0. Jun 24, 2017. Dollar sign escape.

2.10.0. May 8, 2017. Maintenance for MathJax CDN changes.

2.9.1. February 23, 2017. Minor modification for live preview due to MathJax issue.

2.9.0. February 4, 2017. Templates for typical scripts.

2.8.3. February 4, 2017. A bug for live preview on the front-end editor has been solved.

2.8.2. January 19, 2017. Front-end editor has been supported.

2.8.1. October 27, 2016. Maintenance for latest version of Joomla.

2.8.0. April 24, 2016. Editor button and live preview have been added.

2.7.0. March 11, 2016. Code improvement.

2.6.0. August 26, 2015. Maintenance release for MathJax CDN.

2.5.0. January 25, 2015. MathJax custom config parameter has been added. Free version was released.

2.4.0. November 18, 2014. Conversion, on the fly, function has been improved. Also some minor development in content plugin.

2.3.0. June 03, 2014. MathJax version selection option & skip code tag functionality have been added.

2.2.0. March 22, 2014. Listener for DOM changes has been added to system plugin.

2.1.1. March 19, 2014. Some bug has been fixed.

2.1.0. March 9, 2014. System plugin.

2.0.0. December 18, 2013. Pspicture.

1.0.0. April 21, 2013. Initial version.

You have to write all your equations by using LaTeX script. We recommend to use an editor button "Insert Math" for writing and inserting math equations and figures. The button opens a popup modal window. Then you can write your math easily. Because the popup window supports live preview for LaTeX equations.

You can read more information about usage and local installation from http://www.mathjax.org/. Also please visit LaTeX2HTML5 or Mathapedia to know about pspicture on the web page.

Beware of equation label confliction in one page.

Bad Syntax

If LaTeX or PSPicture syntax includes any HTML tags such as <span>, the syntax is not rendered properly. Also new lines in PSPicture syntax must created with the HTML tag <br />, but not created with the (paragraph) tag <p>. These errors are very popular. So you need to check HTML source of your input before publishing. We recommend two methods for checking HTML source:

  1. Button "Toggle Editor" below the editor
  2. Menu item "Source Code" in the editor menu

One of useful methods to clean the tag <span> is the command "Clear Formatting" of the editor.

At last, an effective method to avoid bad syntax, is using the editor button i.e. the popup modal window which is provided by this extension. Please remember it has live preview.

Example

$$f_{\xi}(x)=\frac{1}{\sqrt{2\pi}}\int_{-\infty}^{x}e^{-t^2/2}dt$$
Inline equation $x^2+y^2=1$
Numbered equation \begin{equation}\Phi(0)=\frac{1}{2}\label{eq1}\end{equation}
Now calling (\ref{eq1})
PSPicture
\begin{pspicture}(-2,-2)(2,2)
\psline[linecolor=green]{->}(0,0)(1.2,1.2)
\psline[linecolor=red]{->}(0,0)(-1.2,-1.2)
\psline[linecolor=purple]{->}(0,0)(1.2,-1.2)
\psline[linecolor=lightblue]{->}(0,0)(-1.2,1.2)
\end{pspicture}

Configuration

  1. Open "Global Configuration"
  2. Click "JExtBOX Equation" from sidebar

Detailed information is displayed as tooltip for labels.

Also please don't disable any JExtBOX Equation plugins. We recommend to choose an option "whole site" from the parameter "Application". Another option is inapplicable due to jQuery issues and plugin type.

Dollar sign escape

To escape the dollar sign you need to replace $ by \$.

Update to 2.9.0

Uninstall an older version (2.8.3 or older) completely before install/update. Otherwise, delete old language files ("en-GB.com_jextboxequation.ini" and "en-GB.com_jextboxequation.sys.ini") from the directory "administrator/language".