# 🍌 如何开始

# 准备工作

首先,在使用模板之前,你需要在本机安装 LaTeX 环境。一个完整的 LaTeX 环境包括:

  • 开源免费的 LaTeX 发行版(包含有必备的 LaTeX 编译器与有用的宏包)
  • 以及一个得心应手的 LaTeX 编辑器

我们在 Windows、macOS 与 Linux 环境中均可以使用 LaTeX 进行文档撰写。按照操作系统的不同,我们分别进行介绍。

# 下载合适的 LaTeX 发行版

❗ 请注意

BIThesis 中参考文献为了和校方规定的模板格式(信息与文献 参考文献著录规则 - GB/T 7714-2015 (opens new window))保持一致,使用了仅支持 TeX Live 2019 及以上版本的宏包,如果你曾经安装过 TeX Live 且目前正在使用的 TeX Live 版本不是 2019 及以上版本,那么请及时更新为最新的 TeX Live 2019 及以上版本。

# Windows 和 Linux 系统

对于 Windows 和 Linux 系统,我们可以直接下载使用 TeX Live 发行版 (opens new window)

  • 在线安装:官方的安装指南位于 - Installing TeX Live over the Internet (opens new window)。使用这一方法会下载 install-tl-windows.exe(Windows)或 install-tl-unx.tar.gz(Linux),之后运行相应的可执行程序,安装程序即可将整个 TeX Live 发行版下载安装到我们本机。(通常会安装 3GB 左右的程序。)
  • 离线安装:使用北京理工大学校园网的同学也可以直接使用我校官方 TeX Live 镜像进行安装。我校 TeX Live 镜像资源位于 /CTAN/systems/texlive/Images (opens new window),其中我们选择下载 texlive2020.iso 即可。Windows 10 可直接挂载 ISO 镜像(双击即可),其余系统用合适的软件也可。之后在打开的文件夹中点击执行 install-tl-windows(Windows)或 install-tl(Linux)即可离线安装全部 TeX Live 组件。

❗ 请注意

北理工镜像站自 2021 年 2 月 18 日起,已经停止校外IPv4访问的支持 (opens new window)。因此当我们访问上面镜像资源时,有可能无法打开。对此我们可以选用其他的镜像源。

  • 使用包管理工具进行安装:使用 Linux 系统的同学也可以选择使用合适的包管理工具进行 TeX Live 的安装。以 Ubuntu 为例子,只需要运行:

    sudo apt install texlive
    

    即可下载安装整个 TeX Live 发行版。

# macOS 系统

对于 macOS 系统,我们可以直接下载使用 MacTeX 发行版 (opens new window)。MacTeX 发行版是以 pkg 文件进行发布安装的,我们进入 MaxTeX 的下载页面 (opens new window),点击下载 MacTeX.pkg 即可下载完整的 MacTeX 安装包(大约 3.9GB)。之后双击运行即可安装。

另外,使用 Homebrew 包管理的同学,也可以通过 Homebrew Cask 直接安装 MacTeX:

# 加载 Homebrew Cask
brew tap caskroom/cask

# 利用 Cask 安装 MacTeX
brew cask install mactex

# 确认安装

为了保证我们 LaTeX 发行版的安装没有问题,我们需要验证一下 LaTeX 编译工具的安装情况。我们打开终端(Windows 打开 PowerShell、macOS 打开 Terminal、Linux 打开你所使用的终端模拟器),在其中输入下面的命令:

  • 验证 latexmkxelatex LaTeX 编译器的安装情况:

    # 验证 latexmk 的安装
    latexmk --version
    # 验证 xelatex 的安装
    xelatex --version
    

  • 验证 biber 参考文献编译器的安装情况:

    biber --version
    

出现类似的输出,说明我们编译器安装应该是没有问题的。

# 更新 LaTeX 环境至最新

❗ 为什么需要更新 LaTeX 环境?

在 V2.0 版本以后,BIThesis 采用宏集的方式进行核心样式的发布。因此,BIThesis 的 LaTeX 模板必须和 bithesis 宏集 (opens new window) 一起使用。

所幸,bithesis 已经被常见的 TeX 发行版收录(比如 TeX Live 以及 MiKTeX),所以更新环境是为了确保 bithesis 成功安装到你的 LaTeX 环境中。

# bithesis 宏集的安装与更新

TeX Live 的包管理器是 tlmgr。我们可以在系统命令行中运行以下命令来更新所有 LaTeX 宏包。

tlmgr update --self --all

如果你在使用其他的发行版(如 MikTex),可以使用相应的包管理器更新或者安装 bithesis。

# 验证 bithesis 宏集已经正确安装

一般来说,你可以尝试运行

texdoc bithesis

来打开 bithesis 的宏集手册(目前手册中仅有少量内容)。 如果能够打开文档,就意味着 bithesis 正确安装。

# 挑选合适的 LaTeX 编辑器

理论上来说,任何一个「文本编辑器」均可以用来撰写 LaTeX 文档,但是一个得心应手的 LaTeX 编辑器一定会让我们撰写论文的效率大增。

# 使用 VS Code 配合 LaTeX Workshop 插件编辑 LaTeX 文档

VS Code 是微软开发的基于 Electron 跨平台技术的新晋代码编辑器,开源免费、拓展性强、功能强大,是当代开发者的首选。用 VS Code 配合 LaTeX Workshop 插件我们可以打造一个强大的 LaTeX 编辑器。

使用 VS Code 作为 LaTeX 编辑器时,我们需要特别配置编译工具 tools 与编译工具链 recipes。对于包含有目录、参考文献、图片与表格引用的 LaTeX 文档,我们往往需要使用多个编译工具串联编译。具体的 VS Code 编译方法,请继续阅读 下载与使用模板:Downloading and using templates

# 使用 TeXstudio 编辑 LaTeX 文档

❗ 请注意

使用 macOS 的同学,请谨慎使用 TeXstudio,据反映 TeXstudio 有比较复杂难以解决的问题,因此请使用 Mac 的同学尽量使用 VS Code(或下文提到的付费 Texpad)来使用本模板。

TeXstudio 是老牌 LaTeX 编辑器,使用跨平台技术 Qt 编写而成。虽然界面相对老旧,但是依旧可靠。我们可以去 TeXstudio 的官网 (opens new window)下载安装各个系统版本的 TeXstudio。

默认情况下 TeXstudio 的编译工具链均已经配置完毕,基本开箱即用。对于如何用 TeXstudio 编译本模板,请继续阅读 下载与使用模板:Downloading and using templates

🤫 小声

另外,如果你是特别不差钱的 Mac 用户,希望用最好用最牛逼的 LaTeX 编辑器,你也可以去购买目前售价 $29.99 美元(约合人民币 209.69 元)的 Texpad (opens new window)。使用 macOS、iOS 原生技术栈开发,Texpad 可能是目前使用体验最顺滑的 LaTeX 编辑器,另外由于 Texpad 使用私有 LaTeX 发行版,使得 Texpad 支持实时预览成果 PDF 与双向同步滚动支持。有这方面需要(与金钱)的同学可以考虑入手。

准备就绪后,我们就可以开始使用 BIThesis 提供的模板进行 LaTeX 文档的撰写啦!请继续阅读:下载与使用模板:Downloading and using templates

Last Updated: 3/21/2021, 2:16:41 PM