BIThesis

# 🍌 如何开始

# 准备工作

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

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

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

# 下载合适的 LaTeX 发行版

❗ 请注意

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

# Windows 和 Linux 系统

对于 Windows 和 Linux 系统，我们可以直接下载使用 TeX Live 发行版。

  • 在线安装：官方的安装指南位于 - Installing TeX Live over the Internet。使用这一方法会下载 install-tl-windows.exe（Windows）或 install-tl-unx.tar.gz（Linux），之后运行相应的可执行程序，安装程序即可将整个 TeX Live 发行版下载安装到我们本机。（通常会安装 3GB 左右的程序。）

  • 离线安装：使用北京理工大学校园网的同学也可以直接使用我校官方 TeX Live 镜像进行安装。我校 TeX Live 镜像资源位于 /CTAN/systems/texlive/Images，其中我们选择下载 texlive2019.iso 即可。Windows 10 可直接挂载 ISO 镜像（双击即可），其余系统用合适的软件也可。之后在打开的文件夹中点击执行 install-tl-windows（Windows）或 install-tl（Linux）即可离线安装全部 TeX Live 组件。

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

    sudo apt install texlive

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

# macOS 系统

对于 macOS 系统，我们可以直接下载使用 MacTeX 发行版。MacTeX 发行版是以 pkg 文件进行发布安装的，我们进入 MaxTeX 的下载页面，点击下载 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 打开你所使用的终端模拟器），在其中输入下面的命令：

  • 验证 latexmk、xelatex LaTeX 编译器的安装情况：

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

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

    biber --version

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

# 挑选合适的 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 的官网下载安装各个系统版本的 TeXstudio。

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

🤫 小声

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

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

← 下载与使用模板 →