Update

Author: RainPPR

images/mkdocs/scripts/utils.py

@@ -33,6 +33,8 @@ def get_site_template(copy_extra, template_name):
     nav = { 'nav': get_nav() }
     if copy_extra == True:
         info['extra'] = load_json('config/extra.json')
+        if os.getenv('disable_giscus') == 'true':
+            info['extra'].pop('giscus', None)
     template_defaults = get_template('/app/templates/' + template_name)
     return info | template_defaults | nav
 

images/mkdocs/templates/templates.fragment.yml

@@ -40,6 +40,65 @@ markdown_extensions:
         toc_depth: 3
 -   pymdownx.arithmatex:
         generic: true
+
+-   katex-ssr: # 自己做的插件
+        # disable: true # 禁用 ssr，仅植入 js 代码
+        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
+        client_scripts:
+            - copy-tex
+        katex_options:
+            trust: true
+            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"
+                "\\rank": "\\operatorname{rank}" # 矩阵的秩
+                # 下面是一些简写的定义
+                "\\op": "\\operatorname"
+                "\\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" # 默认使用上标箭头表示有向线段
+                # 下面是一些文化课用的定义
+                "\\poly": "\\ce{-\\!\\!\\![ #1 ]_n\\!\\!\\!\\!\\!-}" # 有机化学 聚合物
+                "\\el": "#1\\mathrm{#2}^{#3}" # 结构化学 能级
+                "\\pH": "p\\ce{H}"
+                "\\pOH": "p\\ce{OH}"
+                "\\con": "\\left[\\ce{#1}\\right]" # 化学计量 一般表示摩尔浓度
+                # 下面都是一些不标准的 Unicode 转移
+                "’": "'"
+                "，": ","
+                "。": "."
+                "；": ";"
+                "：": ":"
+                "！": "!"
+                "？": "?"
+                "【": "["
+                "】": "]"
+                "（": "("
+                "）": ")"
+                "、": ","
+                "—": "-"
+                "…": "\\dots"
+                "·": "\\cdot"
+                "->": "\\to"
+                "<-": "\\gets"
 - pymdownx.caret
 - pymdownx.keys
 - pymdownx.mark