hosts = $wgMathLaTeXMLUrl; $this->setMode( 'latexml' ); } /** * Converts an array with LaTeXML settings to a URL encoded String. * If the argument is a string the input will be returned. * Thus the function has projector properties and can be applied a second time safely. * @param (string|array) $array * @return string */ public function serializeSettings( $array ) { if ( !is_array( $array ) ) { return $array; } else { // removes the [1] [2]... for the unnamed subarrays since LaTeXML // assigns multiple values to one key e.g. // preload=amsmath.sty&preload=amsthm.sty&preload=amstext.sty $cgi_string = wfArrayToCgi( $array ); $cgi_string = preg_replace( '|\%5B\d+\%5D|', '', $cgi_string ); $cgi_string = preg_replace( '|&\d+=|', '&', $cgi_string ); return $cgi_string; } } /** * Gets the settings for the LaTeXML daemon. * @global (array|string) $wgMathDefaultLaTeXMLSetting * @return string */ public function getLaTeXMLSettings() { global $wgMathDefaultLaTeXMLSetting; if ( $this->LaTeXMLSettings ) { return $this->LaTeXMLSettings; } else { return $wgMathDefaultLaTeXMLSetting; } } /** * Sets the settings for the LaTeXML daemon. * The settings affect only the current instance of the class. * For a list of possible settings see: * http://dlmf.nist.gov/LaTeXML/manual/commands/latexmlpost.xhtml * An empty value indicates to use the default settings. * @param string|array $settings */ public function setLaTeXMLSettings( $settings ) { $this->LaTeXMLSettings = $settings; } /** * Calculates the HTTP POST Data for the request. Depends on the settings * and the input string only. * @return string HTTP POST data */ public function getLaTeXMLPostData() { $tex = $this->getTex(); if ( $this->getMathStyle() == 'inlineDisplaystyle' ) { // In 'inlineDisplaystyle' the old // texvc behavior is reproduced: // The equation is rendered in displaystyle // (texvc used $$ $tex $$ to render) // but the equation is not centered. $tex = '{\displaystyle ' . $tex . '}'; } $texcmd = rawurlencode( $tex ); $settings = $this->serializeSettings( $this->getLaTeXMLSettings() ); $postData = $settings . '&tex=' . $texcmd; LoggerFactory::getInstance( 'Math' )->debug( 'Get post data: ' . $postData ); return $postData; } /** * Does the actual web request to convert TeX to MathML. * @return bool */ protected function doRender() { if ( trim( $this->getTex() ) === '' ) { LoggerFactory::getInstance( 'Math' )->warning( 'Rendering was requested, but no TeX string is specified.' ); $this->lastError = $this->getError( 'math_empty_tex' ); return false; } $res = ''; $host = $this->pickHost(); $post = $this->getLaTeXMLPostData(); // There is an API-inconsistency between different versions of the LaTeXML daemon // some versions require the literal prefix other don't allow it. if ( ! strpos( $host, '/convert' ) ) { $post = preg_replace( '/&tex=/', '&tex=literal:', $post, 1 ); } $this->lastError = ''; $requestResult = $this->makeRequest( $host, $post, $res, $this->lastError ); if ( $requestResult ) { $jsonResult = json_decode( $res ); if ( $jsonResult && json_last_error() === JSON_ERROR_NONE ) { if ( $this->isValidMathML( $jsonResult->result ) ) { $this->setMathml( $jsonResult->result ); // Avoid PHP 7.1 warning from passing $this by reference $renderer = $this; Hooks::run( 'MathRenderingResultRetrieved', [ &$renderer, &$jsonResult ] );// Enables debugging of server results return true; } else { // Do not print bad mathml. It's probably too verbose and might // mess up the browser output. $this->lastError = $this->getError( 'math_invalidxml', $this->getModeStr(), $host ); LoggerFactory::getInstance( 'Math' )->warning( 'LaTeXML InvalidMathML: ' . var_export( [ 'post' => $post, 'host' => $host, 'result' => $res ], true ) ); return false; } } else { $this->lastError = $this->getError( 'math_invalidjson', $this->getModeStr(), $host ); LoggerFactory::getInstance( 'Math' )->warning( 'LaTeXML InvalidJSON:' . var_export( [ 'post' => $post, 'host' => $host, 'res' => $res ], true ) ); return false; } } else { // Error message has already been set. return false; } } /** * Internal version of @link self::embedMathML * @return string html element with rendered math */ protected function getMathMLTag() { return self::embedMathML( $this->getMathml(), urldecode( $this->getTex() ) ); } /** * Embeds the MathML-XML element in a HTML span element with class tex * @param string $mml : the MathML string * @param string $tagId : optional tagID for references like (pagename#equation2) * @param bool $attribs * @return html element with rendered math */ public static function embedMathML( $mml, $tagId = '', $attribs = false ) { $mml = str_replace( "\n", " ", $mml ); if ( ! $attribs ) { $attribs = [ 'class' => 'tex', 'dir' => 'ltr' ]; if ( $tagId ) { $attribs['id'] = $tagId; } $attribs = Sanitizer::validateTagAttributes( $attribs, 'span' ); } return Xml::tags( 'span', $attribs, $mml ); } /** * Calculates the SVG image based on the MathML input * No cache is used. * @return bool */ public function calculateSvg() { $renderer = new MathMathML( $this->getTex() ); $renderer->setMathml( $this->getMathml() ); $renderer->setMode( 'latexml' ); $res = $renderer->render( true ); if ( $res == true ) { $this->setSvg( $renderer->getSvg() ); } else { $lastError = $renderer->getLastError(); LoggerFactory::getInstance( 'Math' )->error( 'Failed to convert LaTeXML-MathML to SVG:' . $lastError ); } return $res; } /** * Gets the SVG image * * @param string $render if set to 'render' (default) and no SVG image exists, the function * tries to generate it on the fly. * Otherwise, if set to 'cached', and there is no SVG in the database * cache, an empty string is returned. * * @return string XML-Document of the rendered SVG */ public function getSvg( $render = 'render' ) { if ( $render == 'render' && ( $this->isPurge() || $this->svg == '' ) ) { $this->calculateSvg(); } return parent::getSvg( $render ); } protected function getMathTableName() { return 'mathlatexml'; } }