Setup:Installation Guide/Webservices/Mathoid: Difference between revisions

(Created page with "Mathoid is a nodjs service which takes various forms of math input and converts it to MathML + SVG or PNG output. BlueSpice has everything already preconfigured in https://g...")
Tag: 2017 source edit
 
No edit summary
Tag: 2017 source edit
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Mathoid is a nodjs service which takes various forms of math input and converts it to MathML + SVG or PNG output.
Mathoid is a nodjs service which takes various forms of math input and converts it to MathML + SVG or PNG output.


BlueSpice has everything already preconfigured in https://gitlab.hallowelt.com/BlueSpice/mediawiki/-/blob/4.1.2/settings.d/050-Math.php
{{Messagebox|boxtype=important|icon=|Note text=Beginning with BlueSpice 4.x,  Mathoid is no longer distributed and has to installed separately.
<br />
Download:
 
  https://buildservice.bluespice.com/webservices/REL1_39-4.3.x/mathoid.tar.gz or https://buildservice.bluespice.com/webservices/REL1_39-4.3.x/mathoid.zip|bgcolor=}}


If mathematical formulas are not rendered in your wiki, please check that  <code>extensions/Math/webservices/mathoid.tar.gz</code> is deployed in the correct folder:
If mathematical formulas are not rendered in your wiki, please check that  <code>extensions/Math/webservices/mathoid.tar.gz</code> is deployed in the correct folder:
*Linux:  <code>/opt/mathoid</code>
*Linux:  <code>/opt/mathoid</code>
*Windows:  <code>C:\BlueSpice\bin\mathoid</code>
*Windows:  <code>C:\BlueSpice\bin\mathoid</code>
{{Textbox
|boxtype=neutral
|header=PDF-Export integration
|text=The PDF-Export does not support SVGs at the moment. Therefore the SVG needs to be converted into a PNG when embedded into a PDF. This is done automatically, but requires <code>$wgSVGConverter</code> to be set up properly. It is recommended to use <code>rsvg</code> as a converter. On Debian based linux environments it can be installed with
apt install librsvg2-bin
In the <code>LocalSettings.php</code> file it must be configured with
$GLOBALS['wgSVGConverter'] = 'rsvg';
|icon=yes
}}
== Next step ==
<span style="color: rgb(37, 37, 37)">If you have completed all steps successfully and want to install BlueSpice pro, proceed to the next step</span> [[Setup:Installation Guide/System Preparation/Linux/PhantomJS|PhantomJS]]

Latest revision as of 16:28, 10 January 2024

Mathoid is a nodjs service which takes various forms of math input and converts it to MathML + SVG or PNG output.

Important!Beginning with BlueSpice 4.x, Mathoid is no longer distributed and has to installed separately.


Download:

https://buildservice.bluespice.com/webservices/REL1_39-4.3.x/mathoid.tar.gz or https://buildservice.bluespice.com/webservices/REL1_39-4.3.x/mathoid.zip


If mathematical formulas are not rendered in your wiki, please check that extensions/Math/webservices/mathoid.tar.gz is deployed in the correct folder:

  • Linux: /opt/mathoid
  • Windows: C:\BlueSpice\bin\mathoid


PDF-Export integrationThe PDF-Export does not support SVGs at the moment. Therefore the SVG needs to be converted into a PNG when embedded into a PDF. This is done automatically, but requires $wgSVGConverter to be set up properly. It is recommended to use rsvg as a converter. On Debian based linux environments it can be installed with
apt install librsvg2-bin

In the LocalSettings.php file it must be configured with

$GLOBALS['wgSVGConverter'] = 'rsvg';


Next step

If you have completed all steps successfully and want to install BlueSpice pro, proceed to the next step PhantomJS



To submit feedback about this documentation, visit our community forum.