MathJax does not work together with MermaidJS

Open
#1,007 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
30/100
Issue type
Bug
Clarity
Needs clarification
Activity status
Stale
Domain
documentation

Research direction

Use the supplied boot.toml as the starting reproduction, focusing on the interaction between the commented MermaidJS preprocessor settings and mathjax-support. Determine a concrete reproduction with both enabled; done means MathJax and MermaidJS render correctly together, with the behavior verified against this configuration.

Written by the indexing model from the issue text.

Description

A-MathJax

Here is an example boot.toml:

[book]
authors = ["Roman Kuznetsov"]
language = "en"
multilingual = false
src = "src"
title = "Coursera: Data Structures and Algorithms"

[build]
create-missing = false
use-default-preprocessors = true  # enables the "links" preprocessor

# NOTE: as of now MathJax does not seem to work nicely with MermaidJS (so, choosing MathJax for now)

# [preprocessor.mermaid]
# command = "mdbook-mermaid"
# renderer = ["html"]

[output.html]
# additional-css = ["assets/mermaid.css", "assets/override.css", "assets/lightfair.css"]
additional-css = ["assets/override.css", "assets/lightfair.css"]
# additional-js = ["assets/mermaid.min.js", "assets/mermaid-init.js"]
mathjax-support = true
theme = "assets"

[output.html.playpen]
editable = true

[output.html.search]
limit-results = 20
use-boolean-and = true
boost-title = 2
boost-hierarchy = 2
boost-paragraph = 1
expand = true
heading-split-level = 2
Dominant language
Rust
Stars
22.2k
Forks
1.9k
Avg merge
2d 21h
Merged PRs (30d)
12

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from rust-lang/mdBook

All issues in rust-lang/mdBook

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.