Notes

# LaTeX

# TinyTeX

A lightweight, cross-platform, portable, and easy-to-maintain LaTeX distribution based on TeX Live

相当于 Miniconda 之于 Anaconda

从仓库的 tools 目录中下载执行 install-windows.bat (opens new window) 安装脚本（安装过程中可能会出现「找不到 luatex.dll」的错误，实际不影响使用），然后使用 tlmgr install pkg1 pkg2 ... 命令安装 pkgs-yihui.txt (opens new window) 以及其它自己需要的包（善用 VS Code Join Lines 命令），比如：

chktex
latexindent
texcount

cm-super
libertinust1math

nicematrix
IEEEtran

## BibLaTeX
biblatex, biber, logreq

## 中文
ctex, cjk, cjkpunct, xecjk

import
tocloft     ## table of contents, list of figure/table
contour     ## colored contour around a given text
stackengine
glossaries, mfirstuc, xfor, datatool, tracklang
algorithm2e, ifoddpage, relsize

# tlmgr Common Commands

搜索缺失的包

tlmgr search --global --file "keywords"

tlmgr install [option...] pkg...
tlmgr update [option...] [pkg...]
tlmgr option <key> [value]         ## change (or display) a global option

有些参数，比如 --repository，在所有 tlmgr 命令中都可使用

tlmgr update pkg1 --repository https://mirrors.sustech.edu.cn/CTAN/systems/texlive/tlnet

也可以使用 tlmgr option 修改全局设置

tlmgr option repository https://mirrors.sustech.edu.cn/CTAN/systems/texlive/tlnet

tlmgr manual (opens new window)

# TinyTex 卸载

# Linux
tlmgr path remove
rm -r "~/.TinyTeX"

# macOS
tlmgr path remove
rm -r ~/Library/TinyTeX

# Windows
tlmgr path remove
rd /s /q "%APPDATA%\TinyTeX"

# Escape

& % $ # _ { } ~ ^ \

Note: use \ell instead of l in math mode

# Personal Template

LaTeX code

packages.sty

%% Improve typesetting.
\usepackage{microtype}

%% Use geometry package to set up margins.
%% A4 paper is 8.27 × 11.69 inch.
\usepackage[a4paper,margin=1in]{geometry}

%% Set line spacing.
\usepackage{setspace}
\onehalfspacing%

%% Compact list (avoid too loose list under 1.5 linespace)
\usepackage{enumitem}
\setlist{itemsep=0pt}

%% For `\includegraphics'
\usepackage{graphicx}

\usepackage{booktabs}
\usepackage{xcolor}

%% ━━━━━ Math ━━━━━
\usepackage{amsmath}
%% For `\mathbb'
% \usepackage{amssymb}
%% For `\coloneqq', `\underbrace'
%% If enabled, no longer need to load `amsmath' manually
\usepackage{mathtools}
\usepackage{bm}

% \DeclareMathOperator*{\argmin}{arg\,min}

%% ━━━━━ URL ━━━━━
\colorlet{urlcolor}{red}

%% Setup the hyperref package for enabling links, bookmarks, and PDF properties.
\usepackage{hyperref}
\hypersetup{
    colorlinks = true,
    citecolor  = blue
}

%% ━━━━━ Others ━━━━━
\newcommand{\todo}[1]{\textcolor{blue}{[To-do: #1]}}

main.tex

\documentclass[12pt]{article}

\usepackage{packages}

\begin{document}

\begin{center}
    \LARGE\textbf{Title}\\[5pt]
    \normalsize Author\\\today
\end{center}

\section{Introduction}

Your text

\pagebreak

\bibliography{ref}
\bibliographystyle{plain}

\end{document}

# Useful Snippets

# Change Math Color

\definecolor{math}{HTML}{0c7f99}
\everymath{\color{math}}
\everydisplay{\color{math}}
%% Clear unwanted coloring
\usepackage{etoolbox}
\AtBeginEnvironment{table}{\everymath{}}

https://tex.stackexchange.com/questions/347268/change-math-color-globallyx (opens new window)

# Proper Brackets

%% Remove the unexpected spacing introduced by `\left` and `\right`
\let\oldleft\left
\let\oldright\right
\renewcommand{\left}{\mathopen{}\mathclose\bgroup\oldleft}
\renewcommand{\right}{\aftergroup\egroup\oldright}
\newcommand{\rbracket}[1]{\left(#1\right)}
\newcommand{\sbracket}[1]{\left[#1\right]}
\newcommand{\cbracket}[1]{\left\{#1\right\}}

# Sample Table

\begin{table}
    \centering
    \begin{tabular}{llll}
        \toprule
          & A & B & C \\
        \midrule
        D & E & F & G \\
        \bottomrule
    \end{tabular}
    \caption{Caption}\label{tab:example}
\end{table}

tabular 用来容纳表格真正的内容（必要成分）
table 则额外创建了一个 float 环境（就像 figure），还可以包含 caption

# 删除线 (Strikethrough)

\usepackage{ulem}
\sout{text to be striked out}

# 设置全局非衬线字体

%% https://en.wikibooks.org/wiki/LaTeX/Fonts#Font_families
\renewcommand{\familydefault}{\sfdefault}
%% Prevent warnings caused by sf font
%% https://tex.stackexchange.com/questions/155604/itemize-under-sf-produce-a-font-warning
\let\oldtextbullet\textbullet%
\renewcommand{\textbullet}{\rmfamily\oldtextbullet}
\usepackage{lmodern}

# 其它

authblk

# 段落样式

# 行距

\usepackage{setspace}
\onehalfspacing%

%% Compact list (avoid too loose list under 1.5 linespace)
\usepackage{enumitem}
\setlist{itemsep=0pt}

# 设置段首无缩进

  • 全局：use \setlength{\parindent}{0pt} in preamble.
  • 局部：use \noindent in the front of that paragraph

List of mathematical symbols by subject (opens new window) - Wikipedia

LaTeX twoside document binding offset (opens new window)

# BibLaTeX

基本使用

%% 最好放在 hyperref 之前
\usepackage[style=authoryear,bibstyle=numeric,uniquename=false,natbib=true]{biblatex} % [^1]
\bibliography{ref}          %% deprecated, but still supported for BibTeX compatibility
% \addbibresource{ref.bib}  %% preferable way of BibLaTeX

\begin{document}
...
\printbibliography
\end{document}

%% [^1]: authoryear 会设置 uniquename=full，当出现同姓的作者时会加入作者名以消除歧义
%%       如 Zhang et al. → Y. Zhang et al.
去除文献样式中期刊会议名称之前的 "In:"

而不影响 incollection 的样式

%% https://tex.stackexchange.com/a/10686/208192
\renewbibmacro{in:}{%
  \ifboolexpr{%
     test {\ifentrytype{article}}%
     or
     test {\ifentrytype{inproceedings}}%
  }{}{\printtext{\bibstring{in}\intitlepunct}}%
}
使 authoryear 整体作为可点击的链接 
% hyperlinks the entire citation label (hyperlinks authoryear rather than year)
% ref: https://tex.stackexchange.com/a/27107/208192
\DeclareFieldFormat{citehyperref}{%
  \DeclareFieldAlias{bibhyperref}{noformat}% Avoid nested links
  \bibhyperref{#1}}

\DeclareFieldFormat{textcitehyperref}{%
  \DeclareFieldAlias{bibhyperref}{noformat}% Avoid nested links
  \bibhyperref{%
    #1%
    \ifbool{cbx:parens}
      {\bibcloseparen\global\boolfalse{cbx:parens}}
      {}}}

\savebibmacro{cite}
\savebibmacro{textcite}

\renewbibmacro*{cite}{%
  \printtext[citehyperref]{%
    \restorebibmacro{cite}%
    \usebibmacro{cite}}}

\renewbibmacro*{textcite}{%
  \ifboolexpr{
    ( not test {\iffieldundef{prenote}} and
      test {\ifnumequal{\value{citecount}}{1}} )
    or
    ( not test {\iffieldundef{postnote}} and
      test {\ifnumequal{\value{citecount}}{\value{citetotal}}} )
  }
    {\DeclareFieldAlias{textcitehyperref}{noformat}}
    {}%
  \printtext[textcitehyperref]{%
    \restorebibmacro{textcite}%
    \usebibmacro{textcite}}}
忽略 bib 文件中不需要的属性 
% Ignore certain bibtex fields
\AtEveryBibitem{% Clean up the bibtex rather than editing it
  \clearfield{date}
  \clearfield{eprint}
  \clearfield{isbn}
  \clearfield{issn}
  \clearfield{month}
  \clearfield{series}
  \clearlist{address}
  \clearlist{location}
  \clearlist{organization}

  \ifentrytype{book}{}{% Remove publisher and editor except for books
    \clearlist{publisher}
    \clearname{editor}
  }
}

# 字体

%% `enc` means encoding
\usepackage[T1]{fontenc}    %% `OT1` (old TeX) only contains 128 chars, that's why `<>` becomes `¡¿`
\usepackage[utf8]{inputenc} %% So you can use Unicode chars

%% Linux Libertine
% \usepackage{libertine}
% \usepackage{libertinust1math}
%% The Libertine Mono looks bad, you may want to revert it
% \renewcommand{\ttdefault}{cmtt}

%% TeX Gyre Pagella font
% \usepackage{tgpagella}
%% Pazo Math font
% \usepackage{mathpazo}

More

# 中文支持

如果只是需要输入中文字符，可以引入 xeCJK 宏包并设置字体

\usepackage{xeCJK}
\setCJKmainfont{SimSun}

%% 更完整的设置
% \setCJKmainfont{SimSun}[BoldFont=SimHei,ItalicFont=KaiTi]
% \setCJKsansfont{SimHei}
% \setCJKmonofont{FangSong}

宏包 xeCJK 只提供字体和标点控制等基本语言支持。对于中文文档，可以使用更为高层的 ctex 宏包或文档类，它将自动调用 xeCJK 并设置好中文字体，同时提供了进一步的本地化支持（如表头，日期，首行缩进）。

\usepackage{ctex}  %% https://ctan.org/pkg/ctex

%% 按需设置字体
% \setCJKmainfont{Source Han Serif SC}[ItalicFont=KaiTi]
% \setCJKsansfont{Source Han Sans SC}
% \setCJKmonofont{Sarasa Mono SC}
%% \usepackage[fandol]{ctex} 预设也很不错

使用 XeLaTeX 编译

  • 自行安装字体时需要选择「为所有用户安装」
  • 使用 fc-list :lang=zh 查看有哪些中文字体

（英文版 Windows 需要先安装中文语言包，Settings > Time & Language > Region & Language > 中文 > Options > Basic typing）

More

# a4paper/letterpaper 不起作用

Quite a lot of old classes, e.g. article, don't set the pdf sizes. An option like a4paper sets only things like the TeX \paperwidth, the linewidth and similar lengths.

You will have to insert the necessary command yourself. For pdflatex this is

\pdfpagewidth=\paperwidth%
\pdfpageheight=\paperheight%

BTW: The people who can't reproduce your problem probably have a4paper as default. In this case they would see your problem if they used e.g. the option letterpaper.

# Change TeX Live Default Setting

tlmgr paper letter
tlmgr paper a4

# Beamer

% Gets rid of bottom navigation bars
\setbeamertemplate{footline}[page number]{}

% Gets rid of navigation symbols
\setbeamertemplate{navigation symbols}{}

# VS Code, LaTeX Workshop, SumatraPDF, and SyncTeX

见 LaTeX Workshop Wiki (opens new window)

此外，在 SumatraPDF > Settings > Options > Set inverse search command-line 中填入相应的

"C:\Users\<username>\AppData\Local\Programs\Microsoft VS Code\Code.exe" -g -r "%f:%l"

# 未整理

subfig → stackengine 假装 subfig caption

caption 包，\ContinuedFloat 等

Last updated: 4/28/2022, 1:35:14 PM

← nicematrix →