MiKTeX 安装及使用
MiKTeX 安装及使用
为了使用 LaTeX
,需要 TeX
系统例如 TeXLive
、MiKTeX
、MacTeX
等等。通常 TeXLive
每年更新一次,兼容性强,并且保持跨操作系统的一致性。集成了几乎所有宏包,安装后即可直接使用,对新手还是非常友好的。然而正是因为它默认带有大量宏包,导致体积太大(超过 4G),本人才考虑使用 MikTeX
,几乎所有宏包只有在使用时才会安装。
这里给出国内的 TeXLive
镜像:
MiKTeX 下载
MiKTeX
下载不需要镜像,可在官网下载,下载地址:https://miktex.org/download。这里选择 windows 版本,直接下载即可。
安装
官网也是有简易教程的,可以先看去一下 Install MiKTeX on Windows。
下载完成后直接打开,按默认设置安装(可调整安装目录),
这个页面可以使用默认的,也可以将 "Ask me first" 改为 "Yes",这样每当我们的文档需要安装宏包时,它会自己直接安装,而不是每次都询问。我们输出的pdf
通常是 A4
纸的页面大小,这里不做更改。接下来等待它安装完成即可。
安装完成后打开 MiKTeX Console
,windows 系统可在开始菜单中的最近添加找到,或者在安装时所选的安装目录下:miktex\bin\x64\miktex-console.exe
。
首次打开可能会提示存在问题,这只需要检查更新即可:
检查到更新后,点击左侧更新,然后立即更新即可。
更新完成后会提示重启:
使用
重新打开这个控制台,在界面中选择启动 TexWorks 前端:
打开后,输入以下基本的 LaTeX
文档结构:
\documentclass{article}
\usepackage{ctex}
\begin{document}
\section{Hello World}
你好世界
\end{document}
上方选择 pdfLaTeX
,然后点击绿色三角形按钮编译:
首先该编辑器会让你保存文件,保存后再次点击绿色按钮,MiKTeX
可能会询问是否安装一些宏包(因为使用了 ctex
宏包,用于支持中文),编译完成会打开一个 pdf
,这就是编译输出的产物:
至此,我们已经完成了 LaTeX 写作的最重要的一步。
设置镜像(无效果)
提示:此处的操作并没有解决问题。如果实在需要安装好吧,建议在国内镜像下载 TexLive 并安装(见本文开头)。
最近(2022-10-23)发现下载不了宏包,似乎是被墙了,连 MiKTeX 官网都访问不了(很多非国内网站都是如此,后来发现是校园网的锅)。
日志报错是
Timeout was reached
Data: code="28", url="https://api2.miktex.org/hello"
使用 mpm 命令(MiKTeX Package Manager) 查看可用源,或者打开官网 https://miktex.org/repositories,任选一个 Country 为 China 的都可:
mpm --list-repositories
# 注意,这个选项已经被标记为 deprecated
设置镜像(以北外镜像为例):
mpm --set-repository=https://mirrors.bfsu.edu.cn/CTAN/systems/win32/miktex/tm/packages/
新版 MiKTeX 推荐用以下命令自动选择并设置镜像:
mpm --pick-repository-url
这里列举部分 MiKTeX 的国内镜像:
- 北京外国语大学 https://mirrors.bfsu.edu.cn/CTAN/systems/win32/miktex/tm/packages/
- 清华大学 https://mirrors.tuna.tsinghua.edu.cn/CTAN/systems/win32/miktex/tm/packages/
- 北京交通大学 https://mirror.bjtu.edu.cn/CTAN/systems/win32/miktex/tm/packages/
- 中国科学技术大学 https://mirrors.ustc.edu.cn/CTAN/systems/win32/miktex/tm/packages/
- 华为云 https://repo.huaweicloud.com/CTAN/systems/win32/miktex/tm/packages/
说在后面
这里只是刚刚能够使用 LaTeX,还没有涉及到很多 LaTeX 语法、公式、宏包、TeX 命令行等等。而实际上 LaTeX 也有其专门的 IDE:TexStudio、WinEdt(收费)等,同样提供了很多开箱即用的功能,以及常用的宏命令提示等等,当然,插件颇为丰富的 VS Code 也有对应的用于 LaTeX 写作的插件:LaTeX Workshop
,可定制性高,例如可以配置 snippet,但有时遇到编译错误它不能很好的对错误定位和提示,关于这点还是比较推荐 TexStudio。
当文档比较长的时候,pdf 到 TeX 源码和 TeX 到 pdf 的双向定位也是比较重要的,这里再推荐一个轻量的 pdf 阅读器:SumatraPDF,它和 winedt、vscode 都能很好的配合,当然 TexStudio 也可以,但是它自带 pdf 阅读器。
学习 LaTeX 更多的还是看手册,看宏包的使用说明文档,比较推荐的入门书就是 lshort-zh-cn,这个文档译名是《一份(不太)简短的 LaTeX2e 介绍》或《112 分钟了解 LaTeX2e》,这里还有国内外各一个论坛,遇到的问题可以上来搜索和询问:Stack Exchange、LaTeX 工作室,提问也有其对应的要求,例如一个最小工作示例(MWE),要学习的内容还算挺多,慢慢来吧。