##tex 和 latex

###1. TeX：底层排版引擎

• 作者：Donald Knuth（高德纳）开发，1978 年发布。
• 定位：
  • 是一个底层的排版编程语言，提供精确的排版控制（如盒模型、断行算法、数学公式布局等）。
  • 语法类似编程（需手动处理格式细节），适合专业人士或极客。
• 特点：
  • 直接操作命令（如 \hbox, \vskip）。
  • 默认生成 .dvi 文件（需转换为 PDF/PS）。
  • 无预定义的高层结构（如章节、目录需手动实现）。

示例（纯 TeX 代码）：

\font\myfont=cmr12 at 14pt
\myfont Hello, \TeX!
\byecopy

###2. LaTeX：基于 TeX 的高级封装

• 作者：Leslie Lamport（莱斯利·兰波特）开发，1984 年发布。
• 定位：
  • 是 TeX 的宏包集合（一组预定义的命令和模板），提供文档逻辑结构（如章节、参考文献、交叉引用）。
  • 隐藏了 TeX 的底层复杂性，用户只需关注内容。
• 特点：
  • 提供标准文档类（如 article, book）。
  • 内置自动化功能（目录、编号、参考文献管理）。
  • 依赖宏包扩展功能（如 graphicx 插入图片、amsmath 增强数学公式）。

示例（LaTeX 代码）：

\documentclass{article}
\begin{document}
\section{Introduction}
Hello, \LaTeX!
\end{document}copy

###核心区别

###类比解释

• TeX 类似汇编语言：
  • 直接控制硬件（排版细节），但编写复杂。
• LaTeX 类似高级语言（如 Python）：
  • 通过抽象（如 \section）隐藏细节，提升效率。

###技术关系

• LaTeX 本质是一组 TeX 宏（.sty 文件），最终仍由 TeX 引擎（如 pdftex, xetex, luatex）执行。
• 编译流程示例：
  sh

  latex document.tex   # 调用 pdftex 引擎处理 LaTeX 宏
  xelatex document.tex # 调用 xetex 引擎处理 LaTeX 宏copy

###总结

• TeX 是引擎，LaTeX 是模板。
• LaTeX 让用户摆脱 TeX 的底层复杂性，专注于内容逻辑。
• 现代用户通常直接使用 pdflatex/xelatex/lualatex，无需接触原始 TeX 命令。

如果需要进一步解释某个具体细节（如宏包机制或引擎差异），可以继续讨论！

##引擎和使用

###1. 排版引擎（Engines）

引擎是实际执行排版工作的底层程序，负责解析代码、计算布局并生成输出文件（如 PDF/DVI）。
属于引擎的有：

• tex：Knuth 原始 TeX 引擎（生成 .dvi）。
• pdftex：扩展的 TeX 引擎，直接生成 PDF（pdflatex 的基础）。
• xetex（XeTeX）：支持 Unicode 和系统字体的引擎（xelatex 的基础）。
• luatex（LuaTeX）：内嵌 Lua 脚本的引擎（lualatex 的基础）。

###2. 模板/格式（Formats）

格式是基于引擎的预定义命令集合（宏包），提供高层抽象，简化用户操作。
属于格式的有：

• latex：LaTeX 格式（运行在 pdftex/xetex/luatex 等引擎上）。
  • 不是独立引擎，而是通过 latex 命令调用引擎（如 pdftex + LaTeX 宏 → pdflatex）。
• plain tex：Knuth 提供的极简格式（比原始 TeX 稍友好，但远不如 LaTeX）。
• contex：另一种高级格式（基于 LuaTeX，适合复杂排版）。

###3. 前端命令（Frontends）

用户直接调用的命令，本质是 “引擎 + 格式” 的组合：

###关键区分

• 引擎：tex, pdftex, xetex, luatex（核心执行者）。
• 格式：latex, plain tex, contex（定义高级命令的规则）。
• 前端命令：latex, pdflatex, xelatex, lualatex（组合引擎和格式的快捷方式）。

###常见误解澄清

1. latex 不是引擎：
   • 它是 LaTeX 格式通过 pdftex 引擎运行的接口（命令）。
2. pdflatex vs pdftex：
   • pdftex 是引擎，pdflatex = pdftex + LaTeX 格式。

##引擎（Engines）

###基础引擎

###引擎特性对比

##格式（Formats）

###主要格式

##前端命令（Frontend Commands）

###常用命令组合

##文件格式

###输入文件类型

###输出文件类型

##工具链组件

###核心工具

###编译工具链

graph TD
    A[.tex源文件] --> B{选择引擎}
    B --> C[pdflatex]
    B --> D[xelatex]
    B --> E[lualatex]

    C --> F[生成PDF]
    D --> F
    E --> F

    subgraph "可选处理"
        G[.bib文件] --> H[bibtex]
        I[.idx文件] --> J[makeindex]
        H --> K[.bbl文件]
        J --> L[.ind文件]
    end

    K --> C
    L --> C

##选择指南

###引擎选择建议

1. 中文/多语言文档：xelatex 或 lualatex
2. 传统英文文档：pdflatex
3. 需要动态功能：lualatex（Lua脚本）
4. 底层开发：tex 或 luatex

##列举

###1. tex（原始 TeX 引擎）

• 作用：Knuth 开发的原始 TeX 排版引擎，处理 .tex 文件并生成 .dvi（DeVice Independent）文件。
• 特点：
  • 仅支持传统的 TeX 命令，不支持现代字体（如 OpenType）。
  • 主要用于历史兼容性或极简排版。
• 使用示例：
  sh

  tex mydocument.tex  # 生成 mydocument.dvicopy

###2. latex（LaTeX 格式 + pdfTeX 引擎）

• 作用：使用 pdftex 引擎处理 LaTeX 文档（.tex），默认生成 PDF（也可生成 DVI）。
• 特点：
  • 基于 pdftex，支持 PDF 输出、微调排版和基本字体扩展。
  • 但不支持 Unicode 和 OpenType 字体（需额外宏包如 fontspec）。
• 使用示例：
  sh

  latex mydocument.tex  # 生成 mydocument.dvi
  pdflatex mydocument.tex  # 生成 mydocument.pdfcopy

###3. xetex（XeTeX 引擎，支持 Unicode 和系统字体）

• 作用：TeX 引擎，原生支持 Unicode 和系统字体（如 .ttf/.otf）。
• 特点：
  • 直接调用系统字体，无需额外配置。
  • 适用于多语言排版（如中文、阿拉伯语）。
  • 输出格式为 .xdv（扩展 DVI），通常转换为 PDF。
• 使用示例：
  sh

  xetex mydocument.tex  # 生成 mydocument.xdv（通常自动转 PDF）copy

###4. xelatex（LaTeX + XeTeX 引擎）

• 作用：latex 的增强版，使用 xetex 引擎处理 LaTeX 文档，支持现代字体。
• 特点：
  • 支持 fontspec 宏包，可轻松使用系统字体。
  • 适合中文排版（如配合 ctex 宏包）。
• 使用示例：
  sh

  xelatex mydocument.tex  # 直接生成 PDFcopy

###5. luatex（LuaTeX 引擎，支持 Lua 脚本）

• 作用：扩展的 TeX 引擎，内置 Lua 解释器，允许动态脚本控制排版。
• 特点：
  • 支持 Unicode 和 OpenType 字体（类似 XeTeX）。
  • 可通过 \directlua{} 嵌入 Lua 代码，实现高级自动化。
  • 默认生成 PDF。
• 使用示例：
  sh

  luatex mydocument.tex  # 生成 PDFcopy

###6. lualatex（LaTeX + LuaTeX 引擎）

• 作用：latex 的现代替代品，使用 luatex 引擎，结合 LaTeX 和 Lua 扩展。
• 特点：
  • 支持 fontspec 和 Lua 脚本，灵活性极高。
  • 适合复杂排版（如自动生成内容、动态调整格式）。
• 使用示例：
  sh

  lualatex mydocument.tex  # 生成 PDFcopy

###总结对比

##note

##comment

use following to comment mulilines:

\iffalse
comments
another line
\ficopy

\newcommand{\chen}[1]{{\textcolor{red}{[Chen: #1]}}}
\newcommand{\liu}[1]{{\textcolor{magenta}{[Liu: #1]}}}
\newcommand{\wang}[1]{{\textcolor{blue}{[Wang: #1]}}}

\begin{document}
\liu{test}

\chen{test}

\wang{test}
\end{document}copy

##diff

latexdiff to diff in pdf. tldr:

  Determine differences between two LaTeX files.
  More information: <https://ctan.org/pkg/latexdiff>.

  Determine changes between different versions of a LaTeX file (the resulting LaTeX file can be compiled to show differences underlined):

      latexdiff old.tex new.tex > diff.tex

  Determine changes between different versions of a LaTeX file by highlighting differences in boldface:

      latexdiff --type=BOLD old.tex new.tex > diff.tex

  Determine changes between different versions of a LaTeX file, and display minor changes in equations with both added and deleted graphics:

      latexdiff --math-markup=fine --graphics-markup=both old.tex new.tex > diff.texcopy

git-latexdiff compare pdf in git history

Important options:

Usage: git latexdiff [options] OLD [NEW]
OLD and NEW are Git revision identifiers. NEW defaults to HEAD.
If "--" is used for NEW, then diff against the working directory.
    --latex               run latex instead of pdflatex
    --xelatex             run xelatex instead of pdflatex
    --lualatex            run lualatex instead of pdflatex
    --main <file>         name of the main LaTeX, R Sweave,
    --tmpdirprefix        where temporary directory will be created (default: /tmp).
                            Relative path will use repository root as a base
    --ignore-latex-errors keep on going even if latex gives errors, so long as
                          a PDF file is producedcopy

For example, use git latexdiff HEAD -- --tmpdirprefix tmp --main main.tex to check differences between worktree and last commit.

##picture

If fix position:

\usepackage{float} % 在导言区添加
\usepackage{graphicx} % 用于插入图片

...

\begin{figure}[H] % 使用 [H] 固定位置
    \centering
    \includegraphics[width=0.8\textwidth]{example-image}
    \caption{固定位置的图片}
    \label{fig:example}
\end{figure}copy

centering:

\usepackage{graphicx} % 在导言区添加

...

{
    \centering
    \includegraphics[width=0.8\textwidth]{example-image}
    \par % 确保居中生效
}copy

\(\latex\)

##vimtex

vimtex基本上是提供了全套的功能，包括

• 目录，标签等
• 各种环境，insert模式下的各种snippets，normal模式下的文本对象和命令
• 编译，报错
• 正向搜索（从tex定位到pdf）和反向搜索（从pdf定位到tex）
• conceal （有点影响性能）

而且帮助文档非常详尽，维护积极，而且vim上也能用

缺点几乎没有，除了对与某些信奉unix哲学做一件事并做到最好的人（比如说我）来说有些臃肿。另一个是预设置的快捷键很多，但不一定符合所有人习惯（又是我）。

##latex

首先需要一个latex发行版，比如texlive或者miktex。实际编译过程很复杂，为了生成目录和参考文献需要多次编译。但是latexmk可以帮助完成复杂的顺序。最重要的是，latexmk可以监听文本变化，自动重新编译，以此实现“实时”预览。

实际上不是实时。会在每次保存文件时编译，所以insert模式下敲字时并不会更新。另一方面还取决于编译速度。

在archlinux上，可以安装整个texlive，如果觉得太臃肿也可以安装其中部分包，例如我只安装了

texlive-bibtexextra
texlive-binextra
texlive-langchinese
texlive-latexextra
texlive-mathscience
texlive-pstricks
texlive-xetexcopy

除此之外还有tectonic等可用，但是难以实现实时预览。

可以用texpresso

##lsp

texlab

tex-fmt

##compile

原则上可以直接用命令行编译。但是既然在neovim里，可以用插件封装的命令。

用vimtex或texlab

##inverse and reverse search

##snippets

###mathzone

为了在文本和数学公式环境中使用不同的片段，例如CC只在数学公式中自动展开为\mathbb{C}，需要对能检测数学环境。

最简单的方法是调用vimtex的功能。

用python检测。

用treesitter检测。

###engine

UltiSnip

LuaSnip