Update KaTeX SSR

Author: RainPPR

Dockerfile

@@ -31,7 +31,7 @@ RUN apk add --no-cache \
     font-noto-cjk-extra \
     && fc-cache -fv
 
-RUN npm install -g markdownlint-cli2 && \
+RUN npm install -g markdownlint-cli2 katex && \
     npm cache clean --force
 
 WORKDIR /app

bin/mkdocs-build

@@ -12,6 +12,7 @@ python /app/scripts/generate.py "$@"
 echo ">>> Generation script finished."
 echo "========================================"
 echo ">>> [3/4] Running MkDocs build..."
+npm install katex
 mkdocs build --clean
 echo ">>> MkDocs build finished."
 echo "========================================"

scripts/template.yml

@@ -60,6 +60,76 @@ plugins:
 - table-reader
         # https://github.com/timvink/mkdocs-table-reader-plugin
         # 在 Markdown 里面用这个引入 csv（是否是一个好习惯？
+-   katex-ssr: # 自己做的插件
+        katex_dist: "https://cdn.jsdelivr.net/npm/katex@0.16.27/dist/"
+        add_katex_css: true
+        katex_css_filename: "katex-swap.min.css"
+        ssr_contribs:
+            - mhchem
+        macros:
+            "\\RR": "\\mathbb{R}"
+            "\\i": "\\mathrm{i}"
+            "\\d": "\\mathrm{d}"
+            "\\C": "\\mathbb{C}"
+            "\\R": "\\mathbb{R}"
+            "\\Q": "\\mathbb{Q}"
+            "\\Z": "\\mathbb{Z}"
+            "\\N": "\\mathbb{N}"
+            "\\P": "\\mathbb{P}"
+            "\\degree": "^\\circ"
+            "\\op": "\\operatorname"
+            "\\la": "\\left\\langle"
+            "\\ra": "\\right\\rangle"
+            "\\lc": "\\left\\lceil"
+            "\\rc": "\\right\\rceil"
+            "\\lf": "\\left\\lfloor"
+            "\\rf": "\\right\\rfloor"
+            "\\lv": "\\left\\lvert"
+            "\\rv": "\\right\\rvert"
+            "\\paren": "\\left({#1}\\right)"
+            "\\bracket": "\\left[{#1}\\right]"
+            "\\brace": "\\left\\{{#1}\\right\\}"
+            "\\ceil": "\\left\\lceil{#1}\\right\\rceil"
+            "\\floor": "\\left\\lfloor{#1}\\right\\rfloor"
+            "\\vert": "\\left\\lvert{#1}\\right\\rvert"
+            "\\vec": "\\bm"
+            "\\vecc": "\\overrightarrow"
+            "\\mol": "\\operatorname{mol}"
+            "\\thermo": "\\ce{#1};\\quad\\Delta H=\\pu{#2}"
+            "\\cat": "\\ce{催化剂}"
+            "\\heat": "\\triangle"
+            "\\poly": "\\ce{-\\!\\!\\![ #1 ]_n\\!\\!\\!\\!\\!-}"
+            "\\el": "#1\\mathrm{#2}^{#3}"
+            "’": "'"
+            "，": ","
+            "。": "."
+            "；": ";"
+            "：": ":"
+            "！": "!"
+            "？": "?"
+            "【": "["
+            "】": "]"
+            "（": "("
+            "）": ")"
+            "、": ","
+            "—": "-"
+            "…": "\\dots"
+            "·": "\\cdot"
+            "->": "\\to"
+            "<-": "\\gets"
+            "\\pH": "p\\ce{H}"
+            "\\pOH": "p\\ce{OH}"
+            "\\con": "\\left[\\ce{#1}\\right]"
+            "\\rank": "\\operatorname{rank}"
+            "\\trans": "^{\\mathrm{T}}"
+            "\\sgn": "\\operatorname{sgn}"
+            "\\environment": "\\begin{#1} #2 \\end{#1}"
+            "\\matrix": "\\begin{matrix} #1 \\end{matrix}"
+            "\\pmatrix": "\\begin{pmatrix} #1 \\end{pmatrix}"
+            "\\bmatrix": "\\begin{bmatrix} #1 \\end{bmatrix}"
+            "\\Bmatrix": "\\begin{Bmatrix} #1 \\end{Bmatrix}"
+            "\\vmatrix": "\\begin{vmatrix} #1 \\end{vmatrix}"
+            "\\Vmatrix": "\\begin{Vmatrix} #1 \\end{Vmatrix}"
 -   document-dates:
         # https://jaywhj.netlify.app/document-dates-zh
         position: bottom
@@ -124,7 +194,7 @@ plugins:
         remove_processing_instructions: false
 -   optimize:
         optimize_png_speed: 1
-        optimize_jpg_quality: 60
+        optimize_jpg_quality: 75
 -   blog:
         blog_toc: true
         post_date_format: long
@@ -175,5 +245,3 @@ exclude_docs: |
     /test/
     /cultural/
     /includes/
-extra_javascript:
-- assets/katex.render.js # 准备写 katex ssr？！