DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:jsmath

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:jsmath [2011-04-03 14:07] – [Unresolved Issues] 87.152.144.71plugin:jsmath [2018-05-20 18:20] (current) Aleksandr
Line 1: Line 1:
-====== jsmath plugin ======+====== jsmath Plugin ======
  
 ---- plugin ---- ---- plugin ----
-description: Plugin for displaying LaTeX equations using jsMath or MathJax+description: Plugin for displaying LaTeX equations using MathJax. (Discontinued: MathJax plugin recommended instead.)
 author     : Holger author     : Holger
 email      : yllohy@gmail.com email      : yllohy@gmail.com
 type       : Syntax type       : Syntax
-lastupdate : 2010-10-13 +lastupdate : 2011-06-21 
-compatible : 2009-02-14 2010-11-07+compatible : 2011-05-25 2009-02-14 2009-12-25 2010-11-07, angua
 depends depends
 conflicts  conflicts 
 similar    : format, math, math2, latex similar    : format, math, math2, latex
-tags       : math, latex, formula+tags       : !discontinued, math, latex, formula
  
-downloadurl: http://plugins-for-dokuwiki.googlecode.com/files/plugin-jsmath.zip +downloadurl: https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/plugins-for-dokuwiki/plugin-jsmath.zip 
-bugtracker : http://code.google.com/p/plugins-for-dokuwiki/issues/list +bugtracker https://code.google.com/archive/p/plugins-for-dokuwiki/issues 
-sourcerepo http://code.google.com/p/plugins-for-dokuwiki/source/browse/#svn/trunk/jsmath+sourcerepo : 
 donationurl:  donationurl: 
 +
 +screenshot_img: 
 ---- ----
  
-===== User Reactions =====+===== End-of-life =====
  
-"//It's awesome! This plugin together [with] MathJax makes publishing math in dokuwiki a real pleasureAnd it is so easy to install both.//" (anonymous user)+> :!This plugin, even though it should still work, has been abandoned. It is recommended to use the excellent plugin **[[plugin:MathJax]]** instead. 
 + 
 +===== Installation ===== 
 + 
 +Install this plugin in the plugin manager and use LaTeX code right away! 
 + 
 +For your convenience, the plugin is available in two different archive formats. 
 +  * [[https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/plugins-for-dokuwiki/plugin-jsmath.tar|plugin-jsmath.tar]] 
 +  * [[https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/plugins-for-dokuwiki/plugin-jsmath.zip|plugin-jsmath.zip]]
  
 ===== Features ===== ===== Features =====
Line 30: Line 40:
  
 ===== Usage ===== ===== Usage =====
-Once this plugin is completely installed, you can embed LaTeX code into your wiki pages. 
  
-=== Inline Math ===+Once this plugin is installed, you can embed LaTeX code into your wiki pages. 
 + 
 +==== Inline Math ===
 Each of the following will cause jsmath to display the formula inline: Each of the following will cause jsmath to display the formula inline:
 <code>$e^{i \pi} = -1$</code> <code>$e^{i \pi} = -1$</code>
Line 38: Line 50:
 <code><jsm>e^{i \pi} = -1</jsm></code> <code><jsm>e^{i \pi} = -1</jsm></code>
  
-=== Displayed Math ===+==== Displayed Math ===
 Each of the following will display an equation in block format, on its own line: Each of the following will display an equation in block format, on its own line:
 <code>\[e^{i \pi} = -1\]</code> <code>\[e^{i \pi} = -1\]</code>
 <code><jsmath>e^{i \pi} = -1</jsmath></code> <code><jsmath>e^{i \pi} = -1</jsmath></code>
  
-===== Download =====+===== Configuration =====
  
-For your convenience, the plugin is available in two different archive formats. +On the DokuWiki Configuration Settings page (available in the admin menu) you can 
- Download | [[http://plugins-for-dokuwiki.googlecode.com/files/plugin-jsmath.tar|plugin-jsmath.tar]] | [[http://plugins-for-dokuwiki.googlecode.com/files/plugin-jsmath.zip|plugin-jsmath.zip]] |+  - Choose to not use dollar symbols for displaying math. 
 +  Set the full URL to the MathJax or jsMath installation you want to useThe default is the official MathJax distribution at [[http://cdn.mathjax.org/mathjax/latest]]
  
-===== Installation ===== +===== (Optional) Install a local copy of the Rendering Backend =====
-To setup your DokuWiki for displaying LaTeX, you need to upload some files to your webspace and install the jsmath plugin.+
  
-==== Step 1: The Rendering Backend ==== 
 The jsmath plugin for DokuWiki does not render the LaTeX-code itself. Instead it uses a JavaScript backend that renders the code in the client's browser. Two different JavaScript backends are currently supported: The jsmath plugin for DokuWiki does not render the LaTeX-code itself. Instead it uses a JavaScript backend that renders the code in the client's browser. Two different JavaScript backends are currently supported:
-  * [[http://www.math.union.edu/~dpvc/jsmath/ | jsMath]] is mature software and in recent versions quite fast. The drawback is that the client needs to manually install additional fonts for best quality. +  * [[http://www.math.union.edu/~dpvc/jsmath/| jsMath]] is mature software and in recent versions quite fast. The drawback is that the client needs to manually install additional fonts for best quality. 
-  * [[http://www.mathjax.org | MathJax]] is a modern replacement for jsMath. The high-quality fonts are automatically downloaded and used if the client uses a modern browser.+  * [[http://www.mathjax.org/| MathJax]] is a modern replacement for jsMath. The high-quality fonts are automatically downloaded and used if the client uses a modern browser
 + 
 +The default behaviour of the jsmath plugin is to use the MathJax CDN at [[http://cdn.mathjax.org/mathjax/latest]], but you can also download and use a local copy.
 You only need to install one of those libraries. If unsure, choose MathJax. You only need to install one of those libraries. If unsure, choose MathJax.
  
-Optionally, instead of downloading a local copy, you can use MathJax CDN by using this url [[http://cdn.mathjax.org/mathjax/latest]] on the configuration page. +==== a) MathJax ====
- +
-=== a) MathJax ===+
  
-To get the cutting edge version of MathJax, checkout the most recent version from the [[https://github.com/mathjax/MathJax | developer's page]]. In short:+To get the cutting edge version of MathJax, get the most recent version from the [[https://github.com/mathjax/MathJax | developer's page]]. In short:
   git clone git://github.com/mathjax/MathJax.git   git clone git://github.com/mathjax/MathJax.git
  
 Now move the mathjax directory to your webspace. You can test your installation by going to URL/mathjax/test/ Now move the mathjax directory to your webspace. You can test your installation by going to URL/mathjax/test/
  
-=== b) jsMath ===+==== b) jsMath ====
  
 Follow the [[http://www.math.union.edu/~dpvc/jsMath/authors/installation.html | installation instructions]]. In short: Follow the [[http://www.math.union.edu/~dpvc/jsMath/authors/installation.html | installation instructions]]. In short:
Line 72: Line 84:
   - Optionally download the [[http://sourceforge.net/projects/jsmath/files/ | jsMath Image Fonts]] and extract the zip-file to the same directory.   - Optionally download the [[http://sourceforge.net/projects/jsmath/files/ | jsMath Image Fonts]] and extract the zip-file to the same directory.
   - Optionally install the [[http://www.math.union.edu/~dpvc/jsmath/download/jsMath-fonts.html | TeX fonts for jsMath]] on your local machine.   - Optionally install the [[http://www.math.union.edu/~dpvc/jsmath/download/jsMath-fonts.html | TeX fonts for jsMath]] on your local machine.
-==== Step 2: The jsmath Plugin ==== 
-  - Install the jsmath plugin for DokuWiki using DokuWiki's plugin manager as usual. 
-  - Go to the DokuWiki Configuration Settings page (available in the admin menu) and set the full URL to your jsMath or MathJax installation. This is the directory to which you installed the JavaScript library in Step 1. 
-  - Choose whether you want to use jsMath or MathJax. 
-  - Optionally choose your syntax options (e.g. if you use dollars as currency symbols). 
- 
-**Note:** 
-When trying to display latex formulas for the first time, it may help to clear the browser cache. In Firefox, just press 'Ctrl-Shift-R'. Also try adding somewhere in your latex test page the following code to clear DokuWiki's cache: 
-<code>~~NOCACHE~~</code> 
  
 ===== Development ===== ===== Development =====
  
-If you want to contribute to this plugin, go to the [[http://plugins-for-dokuwiki.googlecode.com/|project page]] of this plugin or contact [[yllohy@gmail.com|Holger]].+If you want to contribute to this plugin, go to the [[https://code.google.com/archive/p/plugins-for-dokuwiki/|project page]] of this plugin or contact [[yllohy@gmail.com|Holger]].
  
 ===== Discussion ===== ===== Discussion =====
  
-Please report your issues to the [[http://code.google.com/p/plugins-for-dokuwiki/issues/list|issue tracker]]. +Please report your issues to the [[https://code.google.com/archive/p/plugins-for-dokuwiki/issues|issue tracker]].
-==== Backend discussion ====+
  
 +==== Backend discussion ====
  
 I've just switched from jsplugin backend to MathJax one: it's **awesome** ! This plugin together MathJax makes publishing math in dokuwiki a real pleasure. And it is so easy to install both. Thank you very much ! Now that MathJax is in version 1.0.1 I think you should recommend it over jsmath now. I've just switched from jsplugin backend to MathJax one: it's **awesome** ! This plugin together MathJax makes publishing math in dokuwiki a real pleasure. And it is so easy to install both. Thank you very much ! Now that MathJax is in version 1.0.1 I think you should recommend it over jsmath now.
Line 129: Line 132:
 It would be great if there was an option on the configuration page to list extensions that should automatically be loaded.  Did I miss it?  Thanks. It would be great if there was an option on the configuration page to list extensions that should automatically be loaded.  Did I miss it?  Thanks.
  
 +=== Formula labels and references ===
 +
 +Anyone got an idea or workaround for how to label formulas and refer to or even link to them from the text?
 +
 +> It's not pretty but I use a combination of [[plugin:bookmark]] and [[plugin:wrap]] to label equations.  It's tedious because they don't autonumber.  For example:
 +<code>
 +where \(\delta_{kl}\) is the Kronecker delta function.  Hence [[#Eq. 3.3]] reduces to
 +<div right><BOOKMARK:eq_34>(Eq. 3.4)</div>
 +\[
 +  \text{Covar}[a_j,a_k] = C_{jk}
 +\]
 +and we find that \([C]\) is the covariance matrix.  The variance of a single parameter \(a_j\) is simply defined as
 +<div right><BOOKMARK:eq_35>(Eq. 3.5)</div>
 +\[
 +  \text{Var}[a_j]=\text{Covar}[a_j,a_j]=C_{jj}.
 +\]
 +</code>
 +
 +> The Mathjax people work on adding support for \label and \ref capabilities. [[https://github.com/mathjax/MathJax/issues/71]]  -- Holger.
 ==== Webspace inode limit solved by MathJax CDN ==== ==== Webspace inode limit solved by MathJax CDN ====
  
 Some webspaces set an inode limit for the users (maximum number of files and folders) and, if you unzip the MathJax package directly on the server, it take about 36.000 inodes; this number is really high for a lot of free webspaces, then to resolve the issue you can use the cdn network kindly offered by MathJax, by putting the following url in the field "plugin»jsmath»backend_url": Some webspaces set an inode limit for the users (maximum number of files and folders) and, if you unzip the MathJax package directly on the server, it take about 36.000 inodes; this number is really high for a lot of free webspaces, then to resolve the issue you can use the cdn network kindly offered by MathJax, by putting the following url in the field "plugin»jsmath»backend_url":
 <code> http://cdn.mathjax.org/mathjax/latest/ </code> <code> http://cdn.mathjax.org/mathjax/latest/ </code>
- 
plugin/jsmath.1301832448.txt.gz · Last modified: 2011-04-03 14:07 by 87.152.144.71

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki