asciidoctor-pdf-mathjax 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fc66d0f0c7026c39d6363d44464ad9c5f430aed3202b344de302604679d3166
-  data.tar.gz: 62009314bb1e5e72e759e2251ce7eaa7ffc14bb123a365a9c0f88dcc58d04bac
+  metadata.gz: 3ef66936477b46fb7aceae1c15a22cb42ebcea5d227ab19be302493e55efc9d2
+  data.tar.gz: df675d9c39be83650834c20b818c437c75bf842a117be0ba5fa4c4ce0e23eddb
 SHA512:
-  metadata.gz: 5234f95491bf7ec6320942e21c009f77575567a4312b1651e13736f19b1cb85d8eeee8cd9b3e443e483628c0b1e7d18847384cb98e9b4cab5efafb539973bcc8
-  data.tar.gz: 7e89244f2911bc889e4f2a3cdd2d34fc31fde201bacac64a0d995ddcbfbd14afe367e98c20922c828ce80bed93e0e05877cd2dbfb81fd655adda92e5c396a6e0
+  metadata.gz: 204c9d8cb2f5fc184ca1e968d4666bcb971fe1e44dba2306d6230a0a2800a22178bfd417fc032a64e9e989d43ac4f89a027de8c99ba3e244c49c683986ad725f
+  data.tar.gz: e908b87d74694eddce9063863755e4119bbe9ad6adc7959c8373da173b3ca75bcb6aaf1cecf8a3559448762af696928091df1a53f3e727fae3055888a7b55a8a

data/bin/render.js

@@ -1,7 +1,5 @@
 #!/usr/bin/env node
 
-const mj = require('mathjax-node');
-
 // Two modes:
 //   render.js <latex> <format> <pixels_per_ex> <font>
 //     renders one formula, prints the SVG and exits.
@@ -11,48 +9,131 @@ const mj = require('mathjax-node');
 //     per formula, {"svg": "..."} or {"error": "..."}.
 // Starting MathJax takes seconds; the server mode pays that once per font
 // instead of once per formula.
+//
+// Font names are MathJax 4 names (mathjax-tex, mathjax-stix2, ...).
+// The MathJax 2 names previously passed to mathjax-node are still accepted.
+
 const server = process.argv[2] === '--server';
-const font = server ? process.argv[3] : process.argv[5];
+const fontArg = server ? process.argv[3] : process.argv[5];
 
-mj.config({
-  MathJax: {
-    SVG: {
-      font: font
-    }
+const LEGACY_FONTS = {
+  'TeX': 'mathjax-tex',
+  'STIX-Web': 'mathjax-stix2',
+  'Asana-Math': 'mathjax-asana',
+  'Neo-Euler': 'mathjax-euler',
+  'Gyre-Pagella': 'mathjax-pagella',
+  'Gyre-Termes': 'mathjax-termes',
+  'Latin-Modern': 'mathjax-modern',
+};
+
+function resolveFont(name) {
+  const requested = (name && String(name).trim()) || 'TeX';
+  const font = LEGACY_FONTS[requested] || requested;
+  // Neo Euler ships as a font extension in MathJax 4, not a standalone font.
+  if (font === 'mathjax-euler') {
+    return { font: 'mathjax-tex', fontExtensions: ['mathjax-euler'] };
   }
-});
-mj.start();
-
-async function convertToSvg(latex, format, pixels_per_ex) {
-  const data = await mj.typeset({
-    ex: pixels_per_ex,
-    math: latex,
-    format: format,
-    svg: true,
-  });
-  return data.svg;
+  return { font: font, fontExtensions: [] };
 }
 
-if (server) {
-  let queue = Promise.resolve();
-  require('readline').createInterface({ input: process.stdin }).on('line', line => {
-    queue = queue.then(async () => {
-      let answer;
-      try {
-        const request = JSON.parse(line);
-        answer = { svg: await convertToSvg(request.math, request.format, request.ex) };
-      } catch (err) {
-        answer = { error: String(err) };
-      }
-      process.stdout.write(JSON.stringify(answer) + '\n');
-    });
+function assertInstalled(packageName) {
+  try {
+    // Font packages export no main entry, so resolve a file they do export.
+    require.resolve(packageName + '/package.json');
+  } catch (err) {
+    throw new Error(
+      `Cannot load ${packageName}. Install MathJax 4 with npm, for example: npm install ${packageName}@4`
+    );
+  }
+}
+
+const { font, fontExtensions } = resolveFont(fontArg);
+
+let MathJax;
+try {
+  assertInstalled('@mathjax/src');
+  assertInstalled(`@mathjax/${font}-font`);
+  fontExtensions.forEach((extension) => assertInstalled(`@mathjax/${extension}-font-extension`));
+  MathJax = require('@mathjax/src');
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}
+
+function convertToSvg(latex, format, pixelsPerEx) {
+  const display = format !== 'inline-TeX';
+  const ex = Number(pixelsPerEx) || 6;
+  return MathJax.tex2svgPromise(latex, {
+    display: display,
+    em: ex * 2,
+    ex: ex,
+    // Formulas are embedded at their natural width. A wide container keeps
+    // MathJax from inserting line breaks when a width is still consulted.
+    containerWidth: 100000,
+  }).then((node) => {
+    const adaptor = MathJax.startup.adaptor;
+    const svg = adaptor.tags(node, 'svg')[0];
+    if (!svg) {
+      throw new Error('MathJax produced no SVG');
+    }
+    const xml = adaptor.serializeXML(svg);
+    const mathError = xml.match(/data-mjx-error="([^"]*)"/);
+    if (mathError) {
+      throw new Error(mathError[1]);
+    }
+    return xml;
   });
-} else {
-  const latex = process.argv[2];
-  const format = process.argv[3];
-  const pixels_per_ex = parseInt(process.argv[4]);
-
-  convertToSvg(latex, format, pixels_per_ex).then(svg => {
-    console.log(svg);
-  }).catch(err => console.error(err));
 }
+
+MathJax.init({
+  loader: {
+    load: ['input/tex', 'output/svg'],
+    // Font packages can report an older component version than MathJax itself.
+    versionWarnings: false,
+  },
+  output: {
+    font: font,
+    fontExtensions: fontExtensions,
+    displayOverflow: 'overflow',
+    linebreaks: { inline: false },
+  },
+  svg: {
+    fontCache: 'local',
+  },
+  startup: {
+    typeset: false,
+  },
+}).then(() => {
+  if (server) {
+    let queue = Promise.resolve();
+    const input = require('readline').createInterface({ input: process.stdin });
+    input.on('line', (line) => {
+      queue = queue.then(async () => {
+        let answer;
+        try {
+          const request = JSON.parse(line);
+          answer = { svg: await convertToSvg(request.math, request.format, request.ex) };
+        } catch (err) {
+          answer = { error: String(err && err.message ? err.message : err) };
+        }
+        process.stdout.write(JSON.stringify(answer) + '\n');
+      });
+    });
+    input.on('close', () => {
+      queue.then(() => {
+        if (MathJax.done) MathJax.done();
+      });
+    });
+  } else {
+    const latex = process.argv[2];
+    const format = process.argv[3];
+    const pixelsPerEx = parseInt(process.argv[4], 10);
+    return convertToSvg(latex, format, pixelsPerEx).then((svg) => {
+      process.stdout.write(svg + '\n');
+      if (MathJax.done) MathJax.done();
+    });
+  }
+}).catch((err) => {
+  console.error(err && err.message ? err.message : err);
+  process.exit(1);
+});

data/lib/asciidoctor-pdf-mathjax.rb

@@ -199,32 +199,33 @@ class AsciidoctorPDFExtensions < (Asciidoctor::Converter.for 'pdf')
     svg_width = svg_width * scaling_factor
     svg_height = svg_height * scaling_factor
 
-    svg_height_difference = font.font_full_height - svg_height
-    svg_relative_height_difference = font.font_full_height / svg_height
-    embedding_text_relative_baseline_height = font.font_baseline / font.font_full_height
+    # Points per viewBox unit. Held constant so the glyphs keep the size MathJax produced.
+    pt_per_unit = svg_height / svg_inner_height
+    orig_top = svg_inner_offset
+    orig_bottom = svg_inner_offset + svg_inner_height
+
+    # Line-sized window with the math baseline (y = 0) on the text baseline.
+    # Asciidoctor centers an inline image in the line when it is at most 1.5 line
+    # heights tall, and bottom-aligns it otherwise. A window exactly the line height
+    # crops any ink past the font ascender or descender (subscripts, denominators).
+    line_units = font.font_full_height / pt_per_unit
+    line_bottom = font.font_baseline / pt_per_unit
+    line_top = line_bottom - line_units
+    overflow_above = [line_top - orig_top, 0].max
+    overflow_below = [orig_bottom - line_bottom, 0].max
+    # Pad both sides equally so centering still leaves the baseline on the text baseline.
+    extra = [overflow_above, overflow_below].max
 
     logger.debug "Original SVG height: #{svg_height.round(2)}, width: #{svg_width.round(2)}, inner height: #{svg_inner_height.round(2)}, inner offset: #{svg_inner_offset.round(2)}"
-    if svg_height_difference < 0
-      svg_relative_portion_extending_embedding_text_below = (1 - svg_relative_height_difference) / 2
-      svg_relative_baseline_height = embedding_text_relative_baseline_height * svg_relative_height_difference
-      svg_inner_relative_offset = svg_relative_baseline_height + svg_relative_portion_extending_embedding_text_below - 1
-
-      svg_inner_offset_new = svg_inner_relative_offset * svg_inner_height
-      svg_inner_height_padding = (svg_inner_offset - svg_inner_offset_new) * 0.25 # 25% padding to handle fractions
-      svg_inner_height_difference = 2 * svg_inner_height_padding
-      svg_inner_height_new = svg_inner_height + svg_inner_height_difference
-      svg_inner_height_relative_difference = svg_inner_height_new / svg_inner_height
-
-      logger.debug("svg_inner_offset = #{svg_inner_offset}, svg_inner_height = #{svg_inner_height}, svg_inner_offset_new = #{svg_inner_offset_new}, svg_inner_height_new = #{svg_inner_height_new}")
-      logger.debug("svg_inner_offset_diff = #{svg_inner_offset - svg_inner_offset_new}, svg_inner_offset_diff_relative = #{(svg_inner_offset - svg_inner_offset_new) / svg_inner_height}")
-
-      svg_height = svg_height * svg_inner_height_relative_difference
-      svg_inner_height = svg_inner_height_new
-      svg_inner_offset = svg_inner_offset_new - svg_inner_height_padding
+    fitted_height = (line_units + 2 * extra) * pt_per_unit
+    if fitted_height <= font.font_full_height * 1.5
+      svg_inner_offset = line_top - extra
+      svg_inner_height = line_units + 2 * extra
+      svg_height = fitted_height
     else
-      svg_height = font.font_full_height
-      svg_inner_height = svg_relative_height_difference * svg_inner_height
-      svg_inner_offset = (embedding_text_relative_baseline_height - 1) * svg_inner_height
+      svg_inner_offset = orig_top
+      svg_inner_height = orig_bottom - orig_top
+      svg_height = svg_inner_height * pt_per_unit
     end
 
     view_box[1] = svg_inner_offset

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-pdf-mathjax
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Crown0815
@@ -153,8 +153,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
-description: Converts STEM blocks and inline macros to SVG images using MathJax-node
-  for AsciiDoctor PDF.
+description: Converts STEM blocks and inline macros to SVG images using MathJax for
+  AsciiDoctor PDF.
 executables:
 - render.js
 extensions: []
@@ -168,10 +168,10 @@ licenses:
 metadata: {}
 post_install_message: |
   Thank you for installing asciidoctor-pdf-mathjax!
-  Note: This gem requires MathJax-Node for full functionality (e.g., LaTeX rendering).
+  Note: This gem requires MathJax 4 for full functionality (e.g., LaTeX rendering).
   If you haven't installed it, run:
-    npm install -g mathjax-node
-  See the README for details.
+    npm install -g @mathjax/src@4 @mathjax/mathjax-tex-font@4
+  See the README for details and for the other math fonts.
 rdoc_options: []
 require_paths:
 - lib