安装 - stone-zeng/fduthesis GitHub Wiki

安装 fduthesis

fduthesis 是复旦大学 LaTeX 论文模板。使用之前，您需确保电脑上已装有比较新的 TeX 发行版。常见的发行版有：

  • TeX Live
    • 由 TUG 官方维护，最为流行
    • 有良好的跨平台支持
    • 通常选择安装完整版，磁盘空间占用较大
    • 需要每年安装新版本
  • MacTeX
    • TeX Live 在 macOS 上的适配版本
  • MiKTeX
    • 由 Christian Schenk 个人维护
    • 宏包在需要时自动安装
    • 可以滚动更新
    • 中国大陆地区由于网络问题，极易更新失败
  • CTeX 套装：
    • 基于 MiKTeX
    • 与 ctex 宏集 / 宏包不是一回事
    • 有很大可能会破坏系统环境变量
    • 现已停止维护，请珍爱生命，不要使用！

我们的推荐是：

  • Windows 或 Linux：TeX Live 最新版本
  • macOS：macTeX 最新版本
  • 再次强调，请不要安装 CTeX 套装！

如果已经安装了 TeX 发行版，请阅读：

如果您没有 / 不愿 / 不能安装发行版，也可以考虑通过 Overleaf 网站使用 fduthesis。

TeX 发行版的安装

以下分系统介绍 TeX 发行版的安装方式。这里只介绍我们上面推荐的配置。

Windows

TODO

macOS

macOS 上推荐使用 MacTeX 发行版。

安装 Homebrew（可选）

Homebrew 是 macOS 下的一个软件包管理器，可以「安装 Apple 没有预装但你需要的东西」。若需安装 Homebrew，请打开终端，输入以下命令：

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

执行之后按照屏幕提示操作。

在中国大陆地区，可以考虑更换默认镜像。

以 中国科学技术大学开源软件镜像 为例：

  • Homebrew

    cd "$(brew --repo)"
git remote set-url origin https://mirrors.ustc.edu.cn/brew.git

  • Homebrew Core

    cd "$(brew --repo)/Library/Taps/homebrew/homebrew-core"
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

  • Homebrew Bottles

    echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile

  • Homebrew Cask

    cd "$(brew --repo)"/Library/Taps/homebrew/homebrew-cask
git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git

具体请参见 Homebrew 源使用帮助。

安装 MacTeX

如果您已经安装了 Homebrew，请在终端中输入

brew cask install mactex

Homebrew 将自动完成安装。

如果没有 / 不愿 / 不敢安装 Homebrew，可以在 MacTeX 官网 直接下载其 .pkg 安装包，并根据向导进行安装（同样建议选择国内镜像，如 中科大镜像 或 清华镜像）。

安装之后建议打开 TeX Live Utility 更新宏包，如图所示：

mactex-update

MacTeX 是完整版的 TeX Live，因而几乎不必再担心缺包的问题。

Linux

Linux 推荐使用 TeX Live。Linux 本身发行版众多，我们这里仅以 Ubuntu 为例进行介绍。

使用包管理器

Ubuntu 自带的包管理器 apt 可以满足绝大多数人的需求。在终端输入以下命令即可：

sudo apt-get update
sudo apt-get install texlive-full

安装「纯净版」TeX Live

源里面的 TeX Live 更新较慢，且不能使用 TeX Live 自带的包管理器 tlmgr。如果确有需要，可以安装「纯净版」TeX Live。具体请参考 在 Ubuntu 中安装 TeX Live 2018。

编辑器的安装

TODO

模版本身的安装

主流 TeX 发行版均已收录 fduthesis，因此通常情况下可直接使用。即使因为您安装了精简版的 TeX Live、MiKTeX 或其他发行版，也应尽量通过自带的包管理器（如 tlmgr）进行安装。

然而，出于稳定性的考虑，CTAN / TeX 发行版中的模版更新较慢；且在 TeX Live 的年度维护期中，您将无法通过 tlmgr 更新（除非使用 pretest 版）。此时，您可以考虑直接从 GitHub 上下载（即所谓「扁平化安装」）。

通过 Git 克隆 fduthesis 到本地：

git clone https://github.com/stone-zeng/fduthesis.git

若未安装 Git，也可在项目主页 直接下载。解压后运行 install-win.bat（Windows）或者 install-unix.sh（macOS/Linux），之后会在同一目录下生成 thesis 文件夹，其中将包含有所需要的全部文件。您可在其中的 fduthesis-template.tex 基础上修改，也可创建空白文件从头开始。

说明：

  1. Release 页面 提供的 fduthesis.tds.zip 文件适用于在 TeX 发行版中手动安装。如无特殊需要，请尽量通过通过自带的包管理器进行安装。
  2. 模版的主要开发直接在 master 分支上进行，在活跃开发期很可能出现 bug。所以，请做好备份后再安装、使用最新测试版。
  3. 论文写作中请及时备份，并尽量避免较大的更新（如 TeX Live 的年度升级）。
Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️