# CTAN

> 可调整选项：
> - 镜像地址：`https://mirrors.cernet.edu.cn/CTAN`
> - sudo：`开启`


> 本站收录所有共享帮助文档；文档存在不代表浙江大学镜像站当前提供该镜像。请查阅 https://mirrors.zju.edu.cn/mirrorz.json 确认当前目录与状态。
> 下列命令使用上述选项，请根据实际系统版本选择；未填写的文本选项需要在原文页面补充。

## 项目简介

CTAN (The Comprehensive TeX Archive Network) 是所有 TeX 排版系统相关材料的汇集地，收录了编译引擎、宏包及字体等的源代码与说明文档。目前，绝大多数 LaTeX 宏包会被上传至 CTAN 核心站点，随后同步到遍布全球的各个镜像。

本文提供了 TeX Live 和 MiKTeX 两大主要发行版的镜像配置方法。


## TeX Live

TeX Live 是目前使用最为广泛的 TeX 发行版，支持 Windows、Linux 和 macOS。其中，在 macOS 上发行的版本称为 MacTeX。

## 安装方法

TeX Live 发行版的常见安装方法可以参考如下文档。

```
https://mirrors.cernet.edu.cn/CTAN/info/install-latex-guide-zh-cn/install-latex-guide-zh-cn.pdf
```

除每年更新的完整版 ISO 镜像以外，CTAN 镜像中也包含在线安装器。这种方法可以使安装的所有宏包均为最新版本，但受网络连接状况影响较大。操作方法为（*很可能需要管理员权限*）：

1. 下载 install-tl.zip 并解压缩

```
https://mirrors.cernet.edu.cn/CTAN/systems/texlive/tlnet/install-tl.zip
```

2. Windows 下双击运行其中的 `install-tl.bat`。如果有图形化界面，可以在进入安装器前的右下角按钮指定使用镜像源。

    Linux 下使用如下命令：

```bash
perl install-tl --repository https://mirrors.cernet.edu.cn/CTAN/systems/texlive/tlnet
```

### 切换镜像

TeX Live 使用的 CTAN 镜像源可以从内置的包管理器 `tlmgr` 更改（*很可能需要管理员权限*）。

在命令行中执行

```bash
sudo tlmgr option repository https://mirrors.cernet.edu.cn/CTAN/systems/texlive/tlnet
```

即可永久更改镜像源。

如果只需要临时切换，可以用如下命令：

```bash
sudo tlmgr update --all --repository https://mirrors.cernet.edu.cn/CTAN/systems/texlive/tlnet
```

其中的 `update --all` 指令可根据需要修改。


## MiKTeX

MiKTeX 发行版的特点在于仅安装用户需要的宏包，节省了磁盘空间占用，但在部分实现细节上与 TeX Live 有所出入。该发行版支持 Windows、Linux 和 macOS。

### 安装

MiKTeX 仅提供 Windows 和 macOS 的独立安装包，前往[TeX 排版系统下载页](<https://mirrorz.org/app/TeX%E6%8E%92%E7%89%88%E7%B3%BB%E7%BB%9F>)即可。在 Linux 下的安装请参考[官方文档](<https://miktex.org/howto/install-miktex-unx>)。

### 使用镜像

MiKTeX 使用的 CTAN 镜像源可以从内置的 MiKTeX Console 图形化应用程序进行切换，也可以使用如下命令：

```bash
mpm --set-repository=https://mirrors.cernet.edu.cn/CTAN/systems/win32/miktex/tm/packages/
```


## pkgsrc

本节供 [pkgsrc 帮助](<https://mirrors.zju.edu.cn/docs/pkgsrc/>)使用

```
MASTER_SITE_TEX_CTAN= https://mirrors.cernet.edu.cn/CTAN/
```

---

许可：[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
文档索引：https://mirrors.zju.edu.cn/llms.txt
如仅限浙大校内网络访问，可将 mirrors.cernet.edu.cn 替换为 mirrors.zju.edu.cn。
