Configurable MathJax Support

podsvirov · podsvirov · commit 123c2b69c52f · 2022-11-03T02:02:32.000+03:00
diff --git a/guide/book.toml b/guide/book.toml
@@ -8,11 +8,13 @@ language = "en"
 edition = "2018"
 
 [output.html]
-mathjax-support = true
 site-url = "/mdBook/"
 git-repository-url = "https://github.com/rust-lang/mdBook/tree/master/guide"
 edit-url-template = "https://github.com/rust-lang/mdBook/edit/master/guide/{path}"
 
+[output.html.mathjax]
+enable = true
+
 [output.html.playground]
 editable = true
 line-numbers = true
diff --git a/src/config.rs b/src/config.rs
@@ -487,6 +487,8 @@ pub struct HtmlConfig {
     pub curly_quotes: bool,
     /// Should mathjax be enabled?
     pub mathjax_support: bool,
+    /// MathJax settings.
+    pub mathjax: MathJax,
     /// Whether to fonts.css and respective font files to the output directory.
     pub copy_fonts: bool,
     /// An optional google analytics code.
@@ -548,6 +550,7 @@ impl Default for HtmlConfig {
             preferred_dark_theme: None,
             curly_quotes: false,
             mathjax_support: false,
+            mathjax: MathJax::default(),
             copy_fonts: true,
             google_analytics: None,
             additional_css: Vec::new(),
@@ -580,6 +583,28 @@ impl HtmlConfig {
     }
 }
 
+/// Configuration for how to use MathJax.
+#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
+#[serde(default, rename_all = "kebab-case")]
+pub struct MathJax {
+    /// Whether MathJax support is enabled.
+    pub enable: bool,
+    /// Source. Default: "https://cdn.jsdelivr.net/npm/mathjax@3/es5".
+    pub source: Option<String>,
+    /// Configuration. Default: "tex-mml-chtml".
+    pub config: Option<String>,
+}
+
+impl Default for MathJax {
+    fn default() -> Self {
+        Self {
+            enable: false,
+            source: Some(String::from("https://cdn.jsdelivr.net/npm/mathjax@3/es5")),
+            config: Some(String::from("tex-mml-chtml")),
+        }
+    }
+}
+
 /// Configuration for how to render the print icon, print.html, and print.css.
 #[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
 #[serde(default, rename_all = "kebab-case")]
diff --git a/src/renderer/html_handlebars/hbs_renderer.rs b/src/renderer/html_handlebars/hbs_renderer.rs
@@ -652,6 +652,16 @@ fn make_data(
 
     if html_config.mathjax_support {
         data.insert("mathjax_support".to_owned(), json!(true));
+    } else if html_config.mathjax.enable {
+        data.insert("mathjax_enable".to_owned(), json!(true));
+        data.insert(
+            "mathjax_source".to_owned(),
+            json!(html_config.mathjax.source),
+        );
+        data.insert(
+            "mathjax_config".to_owned(),
+            json!(html_config.mathjax.config),
+        );
     }
 
     if html_config.copy_fonts {
diff --git a/src/theme/index.hbs b/src/theme/index.hbs
@@ -52,6 +52,24 @@
         {{#if mathjax_support}}
         <!-- MathJax -->
         <script async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
+        {{else}}
+        {{#if mathjax_enable}}
+        <!-- MathJax -->
+        {{#if is_print}}
+        <script>
+        MathJax = {
+            startup: {
+                pageReady: () => {
+                    return MathJax.startup.defaultPageReady().then(() => {
+                        window.setTimeout(window.print, 100);
+                    });
+                }
+            }
+        };
+        </script>
+        {{/if}}
+        <script id="MathJax-script" async src="{{ mathjax_source }}/{{ mathjax_config }}.js"></script>
+        {{/if}}
         {{/if}}
     </head>
     <body>
@@ -302,13 +320,16 @@
         });
         </script>
         {{else}}
+        {{#if mathjax_enable}}
+        {{else}}
         <script>
         window.addEventListener('load', function() {
             window.setTimeout(window.print, 100);
         });
         </script>
         {{/if}}
         {{/if}}
+        {{/if}}
 
     </body>
 </html>
