LaTeX语法总结笔记

1   Latex环境的安装与配置

1.1   Texlive发行版的下载

• 官网导航下载地址，点击an ISO image or via torrent->download from a nearby CTAN mirror->下载最新的iso文件。
• 清华大学镜像下载地址，点击获取下载链接->应用软件->TeX 排版系统->TeX Live 2024 (Windows & Linux)。

1.2   Texlive的安装

1. 加载镜像，双击执行install-tl-windows.bat
2. 安装路径保持默认的C:/texlive/2024
3. 点击Advanced
   • N. of collections->Languages（全勾选无，然后只勾选下面三个，然后确认）
     • Chinese
     • Chinese/Japanese/Korean (base)
     • US and UK English
   • 取消勾选安装 Texworks 前端
4. 其他选项保持默认，然后点击开始安装。
5. 测试Tex安装情况。打开控制台（CMD或Powershell），输入命令测试tex -v、latex -v、xelatex -v。
   • P.S. 如果命令控制台显示找不到命令，在系统环境变量Path中添加texlive bin的路径：C:\texlive\2024\bin\windows。
6. Tex更新：控制台输入tlmgr update --all。

1.3   VS Code的相应配置

关于在VSC中建立latex的snippets 用户代码片段时，若需要输出 \ 换行命令，需要在 json 里输入六个 \\\ 才能真正输出\的，个人想法是VSC传递机制非标准化，不符合 标准的转义字符输出。

2   文档元素

2.1   图片

2.1.1   自适应缩放大小

使用width参数缩放到0.5倍的文本宽度，scale参数就是图片相对于原尺寸缩放，比较难以控制。

% 此处用textwidth文本宽度，或者也可以用linewidth线宽
\begin{figure}[h!]
    \includegraphics[width=0.5\linewidth]{figure}
    \caption{锚点文字}
    \label{图片注解}
\end{figure}

% 在minipage环境中，可以直接使用整倍线宽，就是minipage的宽度
\begin{minipage}[t]{0.48\linewidth}
    \includegraphics[width=\linewidth]{developer_hint}
    \caption{UI提示方案菜单：开发者模式}
    \label{开发者提示方案}
\end{minipage}

3   宏包

3.1   moderncv

moderncv的宏包是分文件编写的，具体语法参照texmf-dist\tex\latex\moderncv中的各个模块。

4   常见问题

4.1   reference.bib中参考文献中的title中写法

和LaTeX语法一样，如果有特殊符号，一样要使用反斜杠标注，例如_要写成_，不然编译会导致所有参考文献没有输出。

4.2   大型LaTeX文档中的input命令

编写大型的LaTeX文档，在子文件中的input命令的路径应输入完整，即从项目顶层路径。input命令仅仅是插入该文档，不会做其他工作。

例如项目文件夹为main，下设sub/subsub/两层文件夹，sub中的tex文件要想插入subsub中的tex文件，应为\input{sub/subsub/xxx.tex}，而非\input{subsub/xxx.tex}。原因就是input仅仅是做插入，当main中的tex文件插入sub中xxx.tex，如果仅仅输入\input{subsub/xxx.tex}，编译时main根本就找不到文件，路径缺失了sub。

5   参考文献

[1] 【latex】LaTeX调整图片大小的方法；自动调整合适的大小[EB/OL]. https://blog.csdn.net/weixin_39589455/article/details/128533896.