Windows 下 LaTeX 手动安装宏包（package）以及生成帮助文档的整套流程

本文简单介绍如何手动安装一个 LaTeX 宏包。

一般来说，下载的 TeX 发行版已经自带了很多宏包，可以满足绝大部分需求，但是偶尔我
们也可能碰到需要使用的宏包碰巧没有安装的情况，这时我们就需要自己下载安装宏包了
。

下载 package 可以从 CTAN（Comprehensive TeX Archive
Network）下载。下载下来的宏包，有的直接包含 .sty文件（.sty 文件就是package
的最终形式）;有的下载下来只包含了 .ins, .dtx，以及一个 readme 文件，这时需
要自己编译生成 .sty 文件，以及生成相应的 manual。下面详细介绍生成 sty 文件
以及帮助文档的步骤。

以下步骤的前提是你已经安装好了 TeX 发行版，本文以 MikTex 为例，请确保 MikTex 的
可执行程序已经加入了系统的环境变量中（PATH）。另外我的系统的 win 8.1，win 7 应
该也是一样的。

第一步：下载宏包，解压，不赘述，下载地址 https://www.ctan.org/pkg，我下载的一
个宏包名称是 qrcode，是用来生成二维码的，以这个宏包的编译为例来讲解。

第二步：找到你的解压后安装包地址，在我的电脑上是 E:LaTeX_packageqrcode， 然
后打开电脑的命令提示符界面，把当前的路径改到这个 package 所在的文件夹，也就是
E:LaTeX_packageqrcode

第三步：生成 qrcode.sty，在命令提示符界面输入 latex qrcode.ins, 经过一段时
间编译，qrcode.sty 就生成了；然后接着生成帮助文档 manual, 在命令提示符界面输
入 latex qrcode.dtx,编译完成以后，会生成一个叫做 qrcode.dvi 的文件，这个文
件也可以用 ctex 自带的 yap 程序打开，不过不是很方便，所以最好还是把它转为 pdf
格式，两步，先输入 dvips qrcode.dvi，生成 qrcode.ps 文件，再输入 ps2pdf
qrcode.ps，最终就生成了 qrcode.pdf的帮助文档，帮助文档包含这个 package 的基
本用法，命令的格式等。最终完成的样子如下

大专栏  Windows 下 LaTeX 手动安装宏包（package）以及生成帮助文档的整套流程.com/18-1-22/32725143.jpg" title="生成的 package" style="float: middle;"/>

第四步：生成 qrcode.sty 文件以后还需要把这个文件放到 LaTeX 能够识别的路径下，
在 ctex 下，以我的电脑为例，这个路径是 D:Program
FilesCTEXMiKTeXtexlatex,你可以在这个路径下建立一个文件夹，譬如 qrcode，然
后把 qrcode.sty 放到这里。接着在你的电脑里找到 MikTex 的 settings 这个程序，
settings 有两个，选择后面括号里有 admin 的那个,打开以后，在 general 选项卡下有
Refresh FNDB 按钮，点击，过一会，这个 package 就会被加入 MikTex 的路径中，然后
在你的 tex 文件中就可以使用这个 package 了。

使用

利用这个宏包，最后可以生成文本对应的二维码，代码如下：

documentclass{article}
usepackage{qrcode}
begin{document}
This is a qrcode for Google HK.
qrcode{https://www.google.com.hk/}
end{document}

最后生成的二维码如下图：

其他宏包的如果要手动安装，应该都是类似操作的。Happy TeXing！

如果不想如此麻烦，可以选择使用 TeX Live，完整版
已经预装了大多数你要使用的 package。

参考

• https://en.wikibooks.org/wiki/LaTeX/Installing_Extra_Packages
• https://tex.stackexchange.com/questions/150182/dvi-to-pdf-convertor