【Latex魔术注解+导言区】Latex魔术注解+导言区分类介绍

在一篇Latex文档正式开始（\begin{document} ）之前，一般有文档最顶部的魔术注解和紧随其后的导言区

（一）魔术注解（%!TEX 指令=值）

魔术注解专门用于告诉编辑器应该使用哪个编译引擎（给编译器看的）。比如下面示例中适合的编译引擎是 XeLaTeX，因为文档中使用了ctex 宏包并包含中文。加上下面魔术注解后编辑器可以自动调用 XeLaTeX，无需手动选择

其实魔术注解除了指定编译引擎，还能指定主文档或文件编码，但一般只会用在指定编译引擎上

bash 复制代码

!TEX program = xelatex

（二）导言区

LaTeX 导言区的内容类别，大致分为5类（如下图）

解释一下3宏包提供的命令：通常必须先加载宏包，而后才可能使用该宏包提供的命令（即先有2后有3）.

比如：\usepackage{setspace} 是用来设置行距的专用宏包；而\setstretch{1.5}是 setspace 宏包提供的自定义行距倍数命令，可以精确控制行距的缩放比例.

【注意】魔术注解非必须，导言区必须

（三）简洁代码示例

bash 复制代码

%魔术注解：指定编辑器使用XeLaTeX引擎编译(因为文档包含中文) 
% !TEX program = xelatex
% 导言区分类内容分类示例（5类）
%1.文档类声明
\documentclass[a4paper,12pt]{article} 
%2.宏包 
\usepackage{ctex} %中文支持
\usepackage{geometry} %页面边距
\usepackage{fancyhdr} %页眉页脚
\usepackage{amsmath, amssymb} %数学符号
\usepackage{hyperref} %超链接
\usepackage{tcolorbox} %彩色盒子
\tcbuselibrary{skins, breakable} %tcolorbox扩展库
\usepackage{setspace} %行距设置

%3.宏包提供的命令 
\setstretch{1.3} %setspace宏包命令：设置行距
%geometry宏包命令：设置页边距
\geometry{left=2cm, right=2cm, top=2cm, bottom=2cm} 
%hyperref宏包命令：配置超链接
\hypersetup{colorlinks=true, linkcolor=blue} 
%tcolorbox宏包命令:将自定义的theorem环境(下面4类)用tcolorbox样式包装
\tcolorboxenvironment{theorem}{colback=blue!5, colframe=blue!75} 

%4.用户自定义命令/环境 
\newcommand{\R}{\mathbb{R}} %自定义命令
\newtheorem{theorem}{定理}[section] %自定义定理环境
%自定义简单环境
\newenvironment{note}{\par\smallskip\noindent\textbf{注：}}{\par} 

%5.全局参数与样式设置 
\setlength{\parindent}{0pt} %取消首行缩进
\setlength{\parskip}{0.5ex} %段落间距
\pagestyle{fancy} %使用fancyhdr页眉样式
\fancyhf{} %清空默认页眉页脚
\fancyhead[C]{\leftmark} %页眉居中显示章节名 
\fancyfoot[C]{\thepage} %页脚居中显示页码

\begin{document}
    
    \section{导言区分类示例}
    
    这是一个测试文档，用于验证导言区的五种分类均已正确设置。
    
    \begin{theorem}[勾股定理]
        在直角三角形中，直角边的平方和等于斜边的平方：
        \[
        a^2 + b^2 = c^2.
        \]
    \end{theorem}
    
    \begin{note}
        该定理适用于欧几里得平面几何。
    \end{note}
    
    自定义符号：实数集 \(\R\)，自然数集 \(\mathbb{N}\)。
    
\end{document}