🔨 LaTeX 使用总结

安装 TexLive

# 方法1(Ubuntu)
# <https://www.tug.org/texlive/debian.html>
sudo apt install texlive-full

# 方法2(Ubuntu)
# <https://github.com/scottkosty/install-tl-ubuntu>
wget https://github.com/scottkosty/install-tl-ubuntu/raw/master/install-tl-ubuntu && chmod +x ./install-tl-ubuntu

中文

宏包 CJK、xeCJK、zhspacing 可以让文档支持中文,CJK 是中文(Chinese)、日文(Japanese)、韩文(Korean)三国文字的缩写。也可以设置 documentclass 为 ctexart。推荐使用 xeCJK 结合 xelatex 编译,相对 CJK 使用简单,并且生成得到的书签目录没有乱码。

CJK

\documentclass{article}
\usepackage{CJK}
\begin{document}
\begin{CJK}{GBK}{song}
    文章内容
\end{CJK}
\end{document}

xeCJK

\documentclass{article}
\usepackage{xeCJK}
\begin{document}
    文章内容
\end{document}

ctexart 应用 ctexart 的好处是,特别针对中文排版作了优化。但是,如果设置了中文,并且有持续构建进行编译(仅仅为了查看编译是否成功),需要注意在构建的环境安装对应的中文字体。以上两种方法只要不配置字体,采用系统默认字体,编译是不会报错的。

\documentclass{ctexart}
\begin{document}
    文章内容
\end{document}

reference: 如何评价 xeCJK?,知乎xeCJK 宏包,PDF

package 的引用

% 单个包引入
\usepackage{pack1}
\usepackage{pack2}
\usepackage{packn}

% 多个包引入
\usepackage{pack1, pack2, packn}

在引入的包没有参数设置的情况下,使用第二种要简洁许多。

引入格式文件

What are .cls and .sty files? How are they different?

可以将包的引入、包的设置等等都放入一个 clssty 文件中,然后引入,放置在 \begin{document} 之前。如果是样式文件, 推荐用 sty 后缀, 而不是 cls。如果是针对特定类的,则用 cls, 反之用 sty

cls cls 即 classes 表示类文件, 如 articlebookbeamer

\input{format.cls}

sty sty 即 style files, 或称为 packages, 为样式文件.

% mystyle.sty
\usepackage{mystyle}

从外部进入 tex 文件

当编写内容比较多事,可以分割为多个文件,然后再一起引入,调试错误也比较方便。

% latexFileName1.tex
% latexFileName2.tex
\include{latexFileName1} % 不要加 tex 后缀
\include{latexFileName2}

\input\include 区别在于,这种方式不会每个文件都从新的一页开始,而是连续的。并且用 \input 在编译时对应的 TeX 子文件不会产生编译过程文件(.aux)。

\input{latexFileName1}
\input{latexFileName2}

循环引入 tex 文件

Calling several tex files with a loop?, stackoverflow

文件、表格、图片太多,引入太麻烦怎么办?可以使用 pgffor 包。

\foreach \x in {1,...,3}{
    \input{filename-\x}
}
% 引入 filename1.tex, filename2.tex, filename3.tex

绘图

图片路径 通过设置图片路径,不需要再添加图片是带上路径。需要注意,如果是通过一个主 tex 文件包含 (includeinput),图片的相对路径应该是相对与主 tex 文件的。图片放在子文件夹下,可以通过 \graphicspath 设置路径,这样就不用在 \includegraphics 命令中添加完整路径,而直接引用图片名即可。使用 \graphicspath 可以设置单个或多个路径。

\graphicspath{{imagepath1/}{imagepath2/}…{imagepathn/}}

绘图工具 编程方式可用 PGF/TikZ 绘图;直观的绘制矢量图可用 Inkscape,生成 PDF 后再引入;drawio 有在线和本地客户端,可导出 PDF,功能类似 Viso,适合绘制流程图架构图。

  1. How I draw figures for my mathematical lecture notes using Inkscape, 2019

添加 PDF 书签

% 添加书签, 并添加内容间的连接(目录、引用等)
\usepackage{hyperref}

参考文献引用

bibtex 格式参考文献文件后缀为 bib,通过此种方式引入参考文献,可以方便利用文献软件进行管理. 其他的诸多好处可以在如何在LaTeX写作中管理参考文献?中查看。

xelatex main.tex
# 参考文献编译
bibtex main.aux
xelatex main.tex
xelatex main.tex

工程文件夹结构

样板工程可参考The-Way-MATLAB-Learning

  1. 文件夹结构。

     .
     ├── main.tex                 # 主文件
     ├── main.sty                 # 样式文件: pakcage 引入及配置等
     ├── Makefile                 # 脚本命令定义
     └── tex                      # 内容
        ├── code                  # 代码
        ├── algorithm             # 算法
        ├── figure                # 图片
        ├── table                 # 表格
        ├── title.tex             # 标题
        ├── abstract.tex          # 摘要
        ├── content.tex           # 目录
        ├── sectionExample.tex    # 示例章节
        ├── appendix.tex          # 附录
        ├── bib.tex               # 参考文献
        └── bib.bib               # 参考文献 Bibtex 文件
    
  2. main.tex

     % main.tex
     \documentclass{article}
    
     \usepackage{main}                   % 样式
    
     \begin{document}
       \thispagestyle{empty}
       \include{tex/title}               % 封面
       \setcounter{page}{0}
    
       \thispagestyle{empty}
       \include{tex/abstract}            % 摘要
       \include{tex/content}             % 目录
    
       \include{tex/sectionExample}      % 章节
       \include{tex/appendix}            % 附录
       \include{tex/bib}                 % 参考文献
     \end{document}
    
  3. tex/content.tex 目录

     % tex/content.tex
     \tableofcontents
     \listoffigures
     \listoftables
     \lstlistoflistings
    

latexmk: 自动化编译

latexmk – Fully automated LaTeX document generation

利用套件里面的 latexmk 命令, 可以实现监视文件变化自动编译、清除缓存文件等功能。

# 清除编译临时文件
latexmk clean

# 预览并自动编译(采用 xelatex, 默认是 pdflatex)
latexmk -pdf -pdflatex="xelatex -interactive=nonstopmode" -pv your.tex

# 简化版
latexmk -pv your.tex

如果需要设置常用属性(比如编译采用 xelatex 还是 pdfletx), 可以了解 .latexmkrc 文件的配置。

Beamer 使用

使用 algorithm 错误

Using Algorithm2e package in Beamer

  • 错误: ! LaTeX Error: Not in outer par mode.
  • 解决: \begin{algorithm}[H], 后加 [H]

使用 verbatim 错误

错误 File ended while scanning use of \@xverbatim

解决 \begin{frame}[fragile], 对应 frame 后加 [fragile]

工具使用问题

Sublime Text + LaTeXTools:文件分割后使用 cite 提示 no bib files found

No bib files found!??, GitHub

问题描述 将单个 tex 文件的每一章节分割为独立的 tex 文件,并放置于 include 文件夹下,载主文件中用 \input 引入。 此情况下,输入 \cite{ 提示 no bib files found

解决方案 在分割出来的章节 tex 文件首行加入 % !TEX root = ..\report.tex

资源