LaTeX-环形使者

LaTeX-环形使者
安装
实际效果
报错
公式渲染
误区
网页公式渲染
Butterfly-KaTeX
公式
tools
常用速查表
数学等号对齐-大换行-成对匹配-数学样式数字
借物表

好奇学术论文是怎么写的吗? 此文章尽做大努力把什么是 Tex 系统给你整闭环了 😁
一图胜千言: ^[3] ^[4]
TeX 生态的名词简直太 ☘ 了,翻阅了很多中英文文档/社区整理了这个图,差不多可以总结 TeX 生态常见/常用的引擎和发行软件.

安装

1.在 win 下推荐用 MikTaX 吧,主流而且比较小. scoop-main 仓库中的 latex 实际上就是最小安装版本的 MikTaX,试了一遍这个 latex 最好,其他的要么下载失败,要么安装报错 😡😡😡.
1
scoop install latex

2.然后在 VScode 中安装 LaTeX Workshop 这个插件,进入 VScode 配置里复制粘贴下面配置:

来源: 搭建 LaTeX 轻量级写作环境（MiKTeX+VSCode）

//! Latex workshop
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.tools": [
  {
    "name": "latexmk",
    "command": "latexmk",
    "args": [
      "-synctex=1",
      "-interaction=nonstopmode",
      "-file-line-error",
      "-pdf",
      "%DOC%"
    ]
  },
  {
    "name": "xelatex",
    "command": "xelatex",
    "args": [
      "-synctex=1",
      "-interaction=nonstopmode",
      "-file-line-error",
      "%DOC%"
    ]
  },
  {
    "name": "pdflatex",
    "command": "pdflatex",
    "args": [
      "-synctex=1",
      "-interaction=nonstopmode",
      "-file-line-error",
      "%DOC%"
    ]
  },
  {
    "name": "bibtex",
    "command": "bibtex",
    "args": ["%DOCFILE%"]
  }
],
"latex-workshop.latex.recipes": [
  {
    "name": "xelatex",
    "tools": ["xelatex"]
  },
  {
    "name": "latexmk",
    "tools": ["latexmk"]
  },

  {
    "name": "pdflatex -> bibtex -> pdflatex*2",
    "tools": ["pdflatex", "bibtex", "pdflatex", "pdflatex"]
  }
],
"latex-workshop.latex.clean.fileTypes": [
  "*.aux",
  "*.bbl",
  "*.blg",
  "*.idx",
  "*.ind",
  "*.lof",
  "*.lot",
  "*.out",
  "*.toc",
  "*.acn",
  "*.acr",
  "*.alg",
  "*.glg",
  "*.glo",
  "*.gls",
  "*.ist",
  "*.fls",
  "*.log",
  "*.fdb_latexmk"
]

3.新建一个后缀名为 .tex 的文件,注意路径和文件名不要有中文,测试内容如下:

\documentclass[UTF8]{ctexart}
    \title{文章标题}
    \author{Weidows}
    \date{\today}
    \begin{document}
    \maketitle
    $$ \alpha^{2} + \beta = \Theta  $$
\end{document}

4.VScode 右上角应该有编译标志 (或者按 Ctrl + alt + B),之后 MikTaX 应该会提醒你下载宏包 (因为软件本身很小,没包含进去),选择 China 的镜像源然后等它下载之后会自动编译.

实际效果

完成上面步骤后在.tex 会生成几个文件,比如:
1
2
3
4
5
1.aux
1.log
1.pdf
1.synctex.gz
1.tex
随着 tex 的写入保存,VScode 插件会自动编译更新预览内容.
展示:

报错

这个情况是因为没重启,尝试重启电脑+重启 VScode
Recipe terminated with fatal error: spawn xelatex ENOENT.
Hexo 导航栏点击不跳转
一般只有启用 KaTeX 的页面会出现这个错误
问题原因是一级标题
1
2
3
4
5
# 1
xxxx

# 2
xxx
找到作者在 issue 中回复过,行文要用二级标题而非一级,解决了跳转问题
1
2
3
4
5
## 1
xxxx

## 2
xxx

公式渲染

误区

渲染 LaTeX 文档 != 渲染公式

我们上面使用 MikTaX 渲染 LaTeX 文档是为了排版获取指定样式的 PDF 文档 -> 渲染LaTeX文档
而渲染公式是渲染 LaTeX 文档的一部分子功能.
为了让 markdown 中 LaTeX 格式的公式也能得到正确显示,我们抽离出渲染公式这部分引擎 -> KaTeX/MathJax -> 专门用来渲染公式

网页公式渲染

在写 markdown 文章时可能不会注意到这个问题,因为大多数编辑器支持公式渲染 (比如 VScode 预览、CSDN 在线编辑等等),如下图 VScode 内置的 markdown 预览:
但是同样的问题挪到博客上就 GG 了,上面的公式不加处理显示成这样
如何在网页中渲染 LaTeX 公式?
KaTeX 或 MathJax
性能测试网站 ^[5] 二者功能比较 ^[6]
个人倾向在网页端用 Katex,更轻便快速.
!!!需要注意!!! 应用 KaTeX 的页面不能被压缩,否则也会变成上面乱套的样子.

Butterfly-KaTeX

需要更换(不换的话有冲突)和新添渲染插件: ^[7]

1 2	npm uninstall hexo-renderer-marked hexo-renderer-kramed --save npm install hexo-renderer-markdown-it @neilsustc/markdown-it-katex --save

_config.yml中添加配置:

markdown:
  plugins:
    - plugin:
      name: "@neilsustc/markdown-it-katex"
      options:
        strict: false

展示效果:
$A = \begin{bmatrix} a_{11} & a_{12} & ... & a_{1n}\\ a_{21} & a_{22} & ... & a_{2n}\\ a_{31} & a_{22} & ... & a_{3n}\\ \vdots & \vdots & \ddots & \vdots\\ a_{n1} & a_{n2} & ... & a_{nn}\\ \end{bmatrix} , b = \begin{bmatrix} b_{1} \\ b_{2} \\ b_{3} \\ \vdots \\ b_{n} \\ \end{bmatrix}$
$\alpha^{2} + \beta = \Theta$

公式

tools

看看这两篇基本上可以按图索骥了: ^[1] ^[2]

强烈推荐 Mathpix, 可以把截图中的公式转为 LaTeX 公式

常用速查表

符号	LaTeX
$\partial$	`\partial`
$\frac{1}{2}$	`\frac{1}{2}`
$\sum_{i=1}^{N}$	`\sum_{i=1}^{N}`
$1\quad2$	`1\quad2`
$\sqrt{3}$ 根	`\sqrt{3}`
$\|\|x\|\|$	`\|\|x\|\|`
$\hat y$ 真实值	`\hat y`
$\infty$ 无穷	`\infty`
$\cap$ 并	`\cap`
$\theta$	`\theta`
$\mathcal{L}$	`\mathcal{L}`
$\alpha$	`\alpha`
$1\qquad2$	`1\qquad2`
$\|a\|$ 绝对值	`\|a\| 或 \vert`
$a \cdot b$	`a \cdot b`
$\overline y$ 均值	`\overline y`
$\vec{w}$ 向量	`\vec{w}`
$\cup$ 交	`\cup`
$\begin{bmatrix}1 & 2\end{bmatrix}$	$\begin{bmatrix}1 & 2\end{bmatrix}$
$\begin{Vmatrix}1 & 2\end{Vmatrix}$	`\begin{Vmatrix}1 & 2\end{Vmatrix}`
$\pi$	`\pi`
$\epsilon$	`\epsilon`
$\varepsilon$	`\varepsilon`
$\eta$	`\eta`
$\left( 123 \right)$	`\left( 123 \right)`

数学等号对齐-大换行-成对匹配-数学样式数字

$\begin{aligned} o^1(0) &= sgn(W^T(0)X^1) \\&= sgn(2.5) = 1 \\ \ \\ W(1) &= W(0) + \eta \left[d^1 - o^1(0)\right]X^1 \\&= (0.5,1,-1,0)^T + 0.1 (-1 - 1)(-1,1,-2,0)^T \\&= (0.7,0.8,-0.6,0)^T \\ \ \\ W(2) &=W(1) + \eta \left[d^{2}-o^{2}(1)\right] X^{2} \\&= (0.7,0.8,-0.6,0)^{T} + 0.1 [- 1-(- 1)](-1,0,1.5,-0.5)^{T} \\&= \left(\mathbf{0.7,0.8,-0.6,0)^{T}}\right. \end{aligned}$

\begin{aligned}
  o^1(0) &= sgn(W^T(0)X^1)
  \\&= sgn(2.5) = 1

  \\ \ \\

  W(1) &= W(0) + \eta \left[d^1 - o^1(0)\right]X^1
  \\&= (0.5,1,-1,0)^T + 0.1 (-1 - 1)(-1,1,-2,0)^T
  \\&= (0.7,0.8,-0.6,0)^T

  \\ \ \\

  W(2) &=W(1) + \eta \left[d^{2}-o^{2}(1)\right] X^{2}
  \\&= (0.7,0.8,-0.6,0)^{T} + 0.1 [- 1-(- 1)](-1,0,1.5,-0.5)^{T}
  \\&= \left(\mathbf{0.7,0.8,-0.6,0)^{T}}\right.
\end{aligned}