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

时间:2023-03-09 04:09:23
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)以及生成帮助文档的整套流程大专栏  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 了。

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

使用

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

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

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

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

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

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

参考