Update KaTeX

Author: qwtel

_includes/head/links.html

@@ -19,13 +19,15 @@
 {% comment %}<!--
   This is to avoid hard-coding URLs in JS (where they can't be discovered by automated tools).
 -->{% endcomment %}
-<link rel="dns-prefetch" href="{{ '/'                                                                       | relative_url }}" id="_baseURL">
-<link rel="dns-prefetch" href="{{ '/assets/js/hydejack-8.2.0.js'                                     | relative_url }}" id="_hrefJS">
-<link rel="dns-prefetch" href="{{ '/sw.js'                                                                  | relative_url }}" id="_hrefSW">
-<link rel="dns-prefetch" href="{{ '/assets/bower_components/fontfaceobserver/fontfaceobserver.standalone.js'| relative_url }}" id="_hrefFFO">
-<link rel="dns-prefetch" href="{{ '/assets/bower_components/katex/dist/katex.min.js'                        | relative_url }}" id="_hrefKatexJS">
-<link rel="dns-prefetch" href="{{ '/assets/bower_components/katex/dist/katex.min.css'                       | relative_url }}" id="_hrefKatexCSS">
-<link rel="dns-prefetch" href="{{ '/assets/img/swipe.svg'                                                   | relative_url }}" id="_hrefSwipeSVG">
+<link rel="dns-prefetch" href="{{ '/'                                                                        | relative_url }}" id="_baseURL">
+<link rel="dns-prefetch" href="{{ '/assets/js/hydejack-8.2.0.js'                                             | relative_url }}" id="_hrefJS">
+<link rel="dns-prefetch" href="{{ '/sw.js'                                                                   | relative_url }}" id="_hrefSW">
+<link rel="dns-prefetch" href="{{ '/assets/bower_components/fontfaceobserver/fontfaceobserver.standalone.js' | relative_url }}" id="_hrefFFO">
+<link rel="dns-prefetch" href="{{ '/assets/bower_components/katex/dist/katex.min.js'                         | relative_url }}" id="_hrefKatexJS">
+<link rel="dns-prefetch" href="{{ '/assets/bower_components/katex/dist/katex.min.css'                        | relative_url }}" id="_hrefKatexCSS">
+<link rel="dns-prefetch" href="{{ '/assets/bower_components/katex/dist/contrib/copy-tex.min.js'              | relative_url }}" id="_hrefKatexCopyJS">
+<link rel="dns-prefetch" href="{{ '/assets/bower_components/katex/dist/contrib/copy-tex.min.css'             | relative_url }}" id="_hrefKatexCopyCSS">
+<link rel="dns-prefetch" href="{{ '/assets/img/swipe.svg'                                                    | relative_url }}" id="_hrefSwipeSVG">
 
 {% assign disqus = site.disqus | default:site.disqus_shortname %}
 {% if disqus %}

_js/src/katex.js

@@ -21,8 +21,7 @@ import { hasFeatures, hide } from "./common";
 const REQUIREMENTS = ["classlist", "eventlistener", "queryselector"];
 
 const featuresOk = hasFeatures(REQUIREMENTS);
-let katexJSLoaded = false;
-let katexCSSLoaded = false;
+let loaded;
 
 function renderKatex(el) {
   try {
@@ -35,29 +34,30 @@ function renderKatex(el) {
       displayMode: el.type === "math/tex; mode=display",
     });
 
-    if (prev) hide.call(prev);
+    if (prev) prev.parentNode.removeChild(prev);
   } catch (e) {
     if (process.env.DEBUG) console.error(e);
   }
 }
 
+const promisify = (f, href) => new Promise(resolve => f(href).addEventListener("load", resolve));
+
 export const upgradeMathBlocks = !featuresOk
   ? () => {}
   : () => {
       const mathBlocks = document.querySelectorAll('script[type^="math/tex"]');
       if (mathBlocks.length) {
-        if (katexJSLoaded && katexCSSLoaded) {
-          Array.from(mathBlocks).forEach(renderKatex);
-        } else {
-          loadJS(document.getElementById("_hrefKatexJS").href).addEventListener("load", () => {
-            katexJSLoaded = true;
-            if (katexJSLoaded && katexCSSLoaded) upgradeMathBlocks();
-          });
-          loadCSS(document.getElementById("_hrefKatexCSS").href).addEventListener("load", () => {
-            katexCSSLoaded = true;
-            if (katexJSLoaded && katexCSSLoaded) upgradeMathBlocks();
-          });
+        if (!loaded) {
+          loaded = Promise.all([
+            promisify(loadJS, document.getElementById("_hrefKatexJS").href),
+            promisify(loadCSS, document.getElementById("_hrefKatexCSS").href),
+            promisify(loadJS, document.getElementById("_hrefKatexCopyJS").href),
+            promisify(loadCSS, document.getElementById("_hrefKatexCopyCSS").href),
+          ]);
         }
+        loaded.then(() => {
+          Array.from(mathBlocks).forEach(renderKatex);
+        });
       }
     };
 

_sass/hydejack/__link__/_katex.scss

@@ -27,19 +27,23 @@ article {
   .katex-display, div.MathJax_Preview {
     @extend .pre-base;
     padding: 2rem;
-    text-align: left;
+    & > .katex {
+      text-align: left;
+    }
   }
 
-  div.MathJax_Preview {
+  .MathJax_Preview {
     font-family: var(--code-font-family);
+  }
+
+  div.MathJax_Preview {
     font-size: .75em;
     line-height: 1.45;
     white-space: pre;
     margin-bottom: 2rem;
   }
 
   span.MathJax_Preview {
-    font-family: var(--code-font-family);
     padding: .25em .5em;
     font-size: .85em;
     background-color: var(--code-bg);

_sass/hydejack/_katex.pre.scss

@@ -18,19 +18,23 @@ article {
   .katex-display, div.MathJax_Preview {
     @extend .pre-base;
     padding: 2rem;
-    text-align: left;
+    & > .katex {
+      text-align: left;
+    }
   }
 
-  div.MathJax_Preview {
+  .MathJax_Preview {
     font-family: var(--code-font-family);
+  }
+
+  div.MathJax_Preview {
     font-size: .75em;
     line-height: 1.45;
     white-space: pre;
     margin-bottom: 2rem;
   }
 
   span.MathJax_Preview {
-    font-family: var(--code-font-family);
     padding: .25em .5em;
     font-size: .85em;
     background-color: var(--code-bg);

assets/bower_components/katex/.bower.json

@@ -4,7 +4,7 @@
     "dist/katex.js",
     "dist/katex.css"
   ],
-  "homepage": "http://khan.github.io/KaTeX/",
+  "homepage": "https://katex.org/",
   "description": "Fast math typesetting for the web.",
   "moduleType": [
     "amd",
@@ -18,29 +18,30 @@
   },
   "ignore": [
     "**/.*",
-    "/*.txt",
     "/*.js",
+    "/*.json",
     "/*.md",
+    "!/README.md",
     "/*.sh",
     "/package.json",
     "/Makefile",
-    "/build",
     "/test",
     "/src",
     "/contrib",
     "/dockers",
-    "/metrics",
-    "/static"
+    "/submodules",
+    "/static",
+    "/website"
   ],
-  "version": "0.9.0",
-  "_release": "0.9.0",
+  "version": "0.10.0",
+  "_release": "0.10.0",
   "_resolution": {
     "type": "version",
-    "tag": "v0.9.0",
-    "commit": "a4fad9138210d5a4dfe0a786cc116422409d216f"
+    "tag": "v0.10.0",
+    "commit": "e1361b5ea5e750aa09833eed7f0a92f042387675"
   },
   "_source": "https://github.com/Khan/KaTeX.git",
-  "_target": "^0.9.0",
+  "_target": "0.10.0",
   "_originalSource": "katex",
   "_direct": true
 }

assets/bower_components/katex/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-2018 Khan Academy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

assets/bower_components/katex/bower.json

@@ -4,7 +4,7 @@
     "dist/katex.js",
     "dist/katex.css"
   ],
-  "homepage": "http://khan.github.io/KaTeX/",
+  "homepage": "https://katex.org/",
   "description": "Fast math typesetting for the web.",
   "moduleType": [
     "amd",
@@ -18,18 +18,19 @@
   },
   "ignore": [
     "**/.*",
-    "/*.txt",
     "/*.js",
+    "/*.json",
     "/*.md",
+    "!/README.md",
     "/*.sh",
     "/package.json",
     "/Makefile",
-    "/build",
     "/test",
     "/src",
     "/contrib",
     "/dockers",
-    "/metrics",
-    "/static"
+    "/submodules",
+    "/static",
+    "/website"
   ]
 }

assets/bower_components/katex/dist/README.md

@@ -0,0 +1,90 @@
+# [<img src="https://cdn.rawgit.com/Khan/KaTeX/84189cd3adae24d92e766d14eb80d6e54f3c7dca/katex-logo.svg" width="130" alt="KaTeX">](https://katex.org/)
+[![npm](https://img.shields.io/npm/v/katex.svg)](https://www.npmjs.com/package/katex)
+[![CircleCI](https://circleci.com/gh/Khan/KaTeX.svg?style=shield)](https://circleci.com/gh/Khan/KaTeX)
+[![codecov](https://codecov.io/gh/Khan/KaTeX/branch/master/graph/badge.svg)](https://codecov.io/gh/Khan/KaTeX)
+[![Join the chat at https://gitter.im/Khan/KaTeX](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/Khan/KaTeX?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Greenkeeper badge](https://badges.greenkeeper.io/Khan/KaTeX.svg)](https://greenkeeper.io/)
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/katex/badge?style=rounded)](https://www.jsdelivr.com/package/npm/katex)
+![](https://img.badgesize.io/Khan/KaTeX/v0.10.0/dist/katex.min.js?compression=gzip)
+
+KaTeX is a fast, easy-to-use JavaScript library for TeX math rendering on the web.
+
+ * **Fast:** KaTeX renders its math synchronously and doesn't need to reflow the page. See how it compares to a competitor in [this speed test](http://www.intmath.com/cg5/katex-mathjax-comparison.php).
+ * **Print quality:** KaTeX’s layout is based on Donald Knuth’s TeX, the gold standard for math typesetting.
+ * **Self contained:** KaTeX has no dependencies and can easily be bundled with your website resources.
+ * **Server side rendering:** KaTeX produces the same output regardless of browser or environment, so you can pre-render expressions using Node.js and send them as plain HTML.
+
+KaTeX is compatible with all major browsers, including Chrome, Safari, Firefox, Opera, Edge, and IE 9–11.
+
+KaTeX supports much (but not all) of LaTeX and many LaTeX packages. See the [list of supported functions](https://katex.org/docs/supported.html).
+
+Try out KaTeX [on the demo page](https://katex.org/#demo)!
+
+## Getting started
+
+### Starter template
+
+```html
+<!DOCTYPE html>
+<!-- KaTeX requires the use of the HTML5 doctype. Without it, KaTeX may not render properly -->
+<html>
+  <head>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.css" integrity="sha384-9eLZqc9ds8eNjO3TmqPeYcDj8n+Qfa4nuSiGYa6DjLNcv9BtN69ZIulL9+8CqC9Y" crossorigin="anonymous">
+
+    <!-- The loading of KaTeX is deferred to speed up page rendering -->
+    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/katex.min.js" integrity="sha384-K3vbOmF2BtaVai+Qk37uypf7VrgBubhQreNQe9aGsz9lB63dIFiQVlJbr92dw2Lx" crossorigin="anonymous"></script>
+
+    <!-- To automatically render math in text elements, include the auto-render extension: -->
+    <script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.0/dist/contrib/auto-render.min.js" integrity="sha384-kmZOZB5ObwgQnS/DuDg6TScgOiWWBiVt0plIRkZCmE6rDZGrEOQeHM5PcHi+nyqe" crossorigin="anonymous"
+        onload="renderMathInElement(document.body);"></script>
+  </head>
+  ...
+</html>
+```
+
+You can also [download KaTeX](https://github.com/khan/katex/releases) and host it yourself.
+
+For details on how to configure auto-render extension, refer to [the documentation](https://katex.org/docs/autorender.html).
+
+### API
+
+Call `katex.render` to render a TeX expression directly into a DOM element.
+For example:
+
+```js
+katex.render("c = \\pm\\sqrt{a^2 + b^2}", element, {
+    throwOnError: false
+});
+```
+
+Call `katex.renderToString` to generate an HTML string of the rendered math,
+e.g., for server-side rendering.  For example:
+
+```js
+var html = katex.renderToString("c = \\pm\\sqrt{a^2 + b^2}", {
+    throwOnError: false
+});
+// '<span class="katex">...</span>'
+```
+
+Make sure to include the CSS and font files in both cases.
+If you are doing all rendering on the server, there is no need to include the
+JavaScript on the client.
+
+The examples above use the `throwOnError: false` option, which renders invalid
+inputs as the TeX source code in red (by default), with the error message as
+hover text.  For other available options, see the
+[API documentation](https://katex.org/docs/api.html),
+[options documentation](https://katex.org/docs/options.html), and
+[handling errors documentation](https://katex.org/docs/error.html).
+
+## Demo and Documentation
+
+Learn more about using KaTeX [on the website](https://katex.org)!
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md)
+
+## License
+
+KaTeX is licensed under the [MIT License](http://opensource.org/licenses/MIT).