Skip to content

Latest commit

 

History

History
219 lines (180 loc) · 7.1 KB

README.md

File metadata and controls

219 lines (180 loc) · 7.1 KB
Raw

LaTex模板

1. 前言

1.1. 想说的话

由于笔者平时有用LaTex书写数学笔记及编写论文的需求，希望能够编写一个简单的模板，供笔者和感兴趣的读者使用。模板内容主要参考https://zhuanlan.zhihu.com/p/604236564 ，笔者在此基础上进行微调，使模板更加清晰易用。

1.2. 运行环境

运行环境选用的是最常见的发行Texlive，编辑器采用vscode。

1.3. 配置文件

这里给出vscode配置Latex书写环境的关键文件settings.json，并在下面对模板中出现的编译链进行一一说明。

"latex-workshop.latex.autoBuild.run": "onSave",
    "latex-workshop.showContextMenu": true,
    "latex-workshop.intellisense.package.enabled": true,
    "latex-workshop.message.error.show": false,
    "latex-workshop.message.warning.show": false,
    "latex-workshop.latex.tools": [
        {
            "name": "xelatex",
            "command": "xelatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "pdflatex",
            "command": "pdflatex",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "%DOCFILE%"
            ]
        },
        {
            "name": "latexmk",
            "command": "latexmk",
            "args": [
                "-synctex=1",
                "-interaction=nonstopmode",
                "-file-line-error",
                "-pdf",
                "-outdir=%OUTDIR%",
                "%DOCFILE%"
            ]
        },
        {
            "name": "bibtex",
            "command": "bibtex",
            "args": [
                "%DOCFILE%"
            ]
        }
    ],
    "latex-workshop.latex.recipes": [
        {
            "name": "XeLaTeX",
            "tools": [
                "xelatex"
            ]
        },
        {
            "name": "xelatex*2",
            "tools": [
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "PDFLaTeX",
            "tools": [
                "pdflatex"
            ]
        },
        {
            "name": "BibTeX",
            "tools": [
                "bibtex"
            ]
        },
        {
            "name": "LaTeXmk",
            "tools": [
                "latexmk"
            ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
                "xelatex",
                "bibtex",
                "xelatex",
                "xelatex"
            ]
        },
        {
            "name": "pdflatex -> bibtex -> pdflatex*2",
            "tools": [
                "pdflatex",
                "bibtex",
                "pdflatex",
                "pdflatex"
            ]
        },
    ],
    // 用于在构建的时候把不需要的.out环境和log删除
    "latex-workshop.latex.autoClean.run": "onBuilt", 
    //这里代表删除类型，不能配置gz那个文件，因为这用于tex和pdf的双向同步
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux",
        "*.bbl",
        "*.blg",
        "*.idx",
        "*.ind",
        "*.lof",
        "*.lot",
        "*.out",
        "*.toc",
        "*.acn",
        "*.acr",
        "*.alg",
        "*.glg",
        "*.glo",
        "*.gls",
        "*.ist",
        "*.fls",
        "*.log",
        "*.fdb_latexmk"
    ],
    "latex.linter.enabled": false,
    "latex-workshop.latex.recipe.default": "lastUsed",
    "latex-workshop.view.pdf.internal.synctex.keybinding": "double-click",
  • 对于基本的文件编译，选择xelatex
  • 对于需要生成目录或引用公式的文件编译，选择xelatex*2
  • 对于生成完整的文章（目录，公式，文献引用），选择 xelatex -> bibtex -> xelatex*2。

2. 基本文件目录

这里给出了多章节模板的目录截图，可以看到其具有完整的结构，包括配置文件、封面、摘要、章节、文献等，我们对其一一进行解读。

image-202312260000570742.1. 配置文件

config文件夹存放着五个配置文件，分别是custom、format、package、theorem、config。

  • config.tex是总的配置文件，集成了其他四个配置文件的信息
  • custom.tex文件中配置的是一些自己顺手的宏定义
  • format.tex文件中配置了文章的格式如字体大小、行间距、列表格式等。请注意： \graphicspath是图形文件搜索路径指令，不能使用通配符来进行路径的配置，默认为 \graphicspath{ {cover/figure/},{figure/}} ，若每书写一个新的章节，建议在路径后面添加 chap*/figure ，如 \graphicspath{ {cover/figure/},{figure/},{chap1/figure/}}
  • package.tex文件中配置了需要引用的宏包。请注意：这里不能使用 unicode-math 宏包，不然重定义的 \boldsymbol 指令会失效，并且基于 \mathbb 的数学符号会出现不可预知的问题
  • theorem.tex文件中配置了定理、引理相关的环境。

2.2. 封面

由于是自用笔记模板，封面没做美化，就简单加了一个同济大学的logo，效果如下

image-20231229174602431

2.3. 前言/摘要

这是封面接着的下一页内容，对应着abstract/abstract.tex。由于前言和摘要没有本质区别，若是写书或笔记则使用前言作为标题，若是写论文则使用摘要作为标题。效果如下

image-20231229174618166

2.4. 章节

这是文章的主要内容，对应着chap*/chap.tex，并且给出下面的模板

\ifx\allfiles\undefined
\documentclass[12pt, a4paper, oneside, UTF8]{ctexbook}
\def\configPath{../config}
\input{\configPath/config}
\begin{document}
\else
\fi
% 在这里书写内容


% 在这里书写内容
\ifx\allfiles\undefined
\end{document}
\fi

这一部分不用过多赘述，按照模板正常书写即可。以下是部分页面展示

image-20231229175541689

由于用LaTex手打列表过于复杂，在这里推荐一个笔者常用的web网页，来帮助大家更快地入门LaTex，并更加专注书写内容。

https://www.tablesgenerator.com/#

2.5. 文献管理

这是文献管理部分，对应着literature/literature.bib文件，只需要在文件里面添加需要引用的文献，并在文章正文通过\cite命令引用即可。

3. 编译

3.1. 单章节编译

由于文章分为多个章节，一起编译的时间很长，对于单独的章节，我们也提供了编译的选项。即使用xelatex或xelatex*2编译。

3.2. 多章节编译

在main.tex中使用xelatex -> bibtex -> xelatex*2编译即可。若出现编译错误，请查看日志文件，并尝试删除中间文件*.bbl及*.synctex.gz文件重新进行编译。

若不存在文献引用只需要选择xelatex*2进行编译即可。