LaTeX从懵逼到入坑——LaTeX安装指南

最近入坑了LaTeX，做一份安装指南。

入坑LaTeX的动机

前些日子在github上用hexo搭建了blog，但是自己写博客依然遇到了两个大坑，自己没有填平已经不想填了。
一个是自己搭建的blog无法高效支持图片的插入，另一个是markdown与latex有冲突。
今天尝试图片的插入，本地测试正常但是发布到github上搭建的blog就无法正常显示，网络链接强行插入可行。
鉴于以上两种原因，决定入坑一种新技能，那就是latex。

其实，很早前就想入坑latex的想法。
感觉PDF的版式很规整不容易因为平台或者设备的变更而出现格式混乱。
在杠毕业论文的时候，不停的调论文格式啊调啊调的，实在是浪费生命。

LaTeX就是让你把精力集中在写文章上，而不是调格式上。

珍爱生命，入坑LaTeX。

了解LaTeX

Tax

七十年代末，Donald E. Knuth（高德纳）在看到其多卷巨著“The Art of Computer Programming”第二卷的校样时，对由计算机排版的校样的低质量感到无法忍受。因此决定自己来开发一个高质量的计算机排版系统，这样就有了TeX。

Tax的发展

由于TeX的命令太多不容易记，于是有人在其基础上开发出多款容易使用的TeX系统。

###　入门笔记

懒得自己码字，直接甩个入门链接。　LaTeX简介

一开始在万门大学上看到LaTeX的入门课程，然后就简单的看了一节，于是就有了玩LaTeX的决(chong)心(dong)。

简洁入门课中用到的是CTeX, 配合着WinEdt，讲解的示例文档中还用了CJK的包。
因为CTeX已经好久没有更新了，比较古老，而且有些地方比较麻烦，有些新东西不支持。所以就不选择这个了，白下载一份又默默删掉。

这里采用国际TeX 用户组织 TUG的TexLive， macOS用户可以选择macTeX.

昨天了解了许多，看了知乎上关于编辑器的交流(更多资料8)，看了latex开源小屋里的一些介绍和模板，看了texlive的安装指南。
在github上star了几份模板。也下载了几份模板，其中有线性代数的教材。

TexLive安装

LaTeX使用方案

根据个人情况，有这么几种方案：

TexLive + TeXStudio
TexLive + Visio Studio Code + Latex Workshop + Git + Sumatra PDF
vim + vimtex + neocomplete + SumatraPDF

暂时还不是vim死粉，所以第3中方案先记下来，以后换另一个系统的时候可以尝试配置一下。
之前已经安装了vim、VSCode、Git，还有Adobe Acrobat CC pro，不如前两个都准备下以便有备用方案。2333

总而言之，最缺的就是TexLive了。

TexLive安装记录

有特殊需要注意的就记录，没有的话就尽量省略过程。

1. 下载TexLive

TexLive下载
上交的镜像站点
 清华的镜像站点
当然也可以移步到CTAN的站点下载，选一个下载速度快的就行。

2. 查看相关文档

懒得很，跳过MD5等验证。

下载下来的是ISO压缩文件，解压缩。
查看README，得知texlive-doc中是安装文档，有中文版。

3. 开始安装TexLive

双击打开install-tl-advanced.bat开始安装。

$双击install-tl-advanced.bat$

选择高级设置。

$选择高级设置$

点击more加载完整界面。

$点击more加载完整界面$

修改安装路径。选择需要的包，可以去掉一些语言包。我没打算用TeXworks所以取消了对勾。

$设置路径选择需要的包$

安装进行中。

$安装进行中$

安装完成。

$安装完成$

其实还没有完成。

$真正的安装完成$

其实，TeXLive2019相对更早的版本来说，基本不用设置，直接运行install-tl-windows.bat一键安装也完全可以。

4. 验证是否安装成功

打开命令行工具
输入tex -v、latex -v、xelatex -v命令，如果能正常的输出版本信息说明安装成功了。

$TeX安装版本信息$

5. 基本命令的使用

编译：latex test.tex命令 –>生成.dvi文件–>使用命令dvipdfmx test.dvi–>生成PDF文件
也可以直接使用xelatex test.tex命令直接生成PDF文件
查看文档：texdoc lshort-zh, texdoc ctex

TeXStudio安装

TeXStudio下载

下载TeXStudio
TeXStudio官网
 TeXStudio在sourceforge的官网页面
官网可能较慢，可以选择第二个链接下载。

TeXStudio安装

选择路径，这个比较简单。

一些设置

setting -> general -> language -> zh-cn

重新设置了下默认编译器和默认文献工具。这里默认文献工具选的biber是因为参考的博客是选了这个，不知道是不是默认编译，看VSCode配置latex workshop的时候都是bibtex。到时候用的时候比较一下，如果发现啥及时更改。

$TexStudio默认编译器和文献工具修改$

修改了下文献编译工具，改了自己想用的PDF和DVI查看工具，PS还不知道哪里会用到所以没有改。

$TexStudio文献命令修改$

此处设置，参考了关于LaTeX安装相关参考中的第1项，其实我觉得只把默认编译改一下就行了，或者不需要修改设置。

Visual Studio Code LaTeX Workshop Extension

安装Visual Studio Code
打开Extension，搜索安装LaTeX Workshop，可以多加一个LaTeX language support.
在VSCode里，ctrl+shift+p，输入set，选择Preferences: Open Settings (json),在花括号内插入一些代码。

(20190701)尝试失败。

(接下来是20190702更新)
前面尝试失败，可能是安装完插件后需要重启一下VSCode才行，总之配置完重启一下不会有啥问题。

此处对于扩展的设置，参考了关于LaTeX安装相关参考中的第2-5项。

了解了要修改的几个模块的规则，也或选择或搭配了自己的设置。

tool 编译方式

此处代码参考了[参考4]，直接拿来用。
DOC改为DOCFILE可以识别中文路径。

"latex-workshop.latex.tools": [
    {
        // 编译工具和命令
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "%DOCFILE%"
        ]
    },
    {
        "name": "pdflatex",
        "command": "pdflatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOCFILE%"
        ]
    },
    {
        "name": "bibtex",
        "command": "bibtex",
        "args": [
            "%DOCFILE%"
        ]
    }
],

recipe 编译链

编译组合设置。
这里只用了[参考3]中的代码，调整了下名字和顺序，其实只参考[参考4]中的也行。

//编译组合，编译链
    "latex-workshop.latex.recipes": [
        {
          "name": "xelatex",
          "tools": [
            "xelatex"
          ]
        },
        {
            "name": "xelatex -> bibtex -> xelatex*2",
            "tools": [
              "xelatex",
              "bibtex",
              "xelatex",
              "xelatex"
            ]
        },

        {
          "name": "bibtex",
          "tools": [
            "bibtex"
          ]
        },

        {
          "name": "pdflatex",
          "tools": [
            "pdflatex"
          ]
        },
        {
          "name": "pdflatex -> bibtex -> pdflatex*2",
          "tools": [
            "pdflatex",
            "bibtex",
            "pdflatex",
            "pdflatex"
          ]
        },
        
        {
          "name": "latexmk",
          "tools": [
            "latexmk"
          ]
        },
    
    ],

外部PDF预览

参考[参考4]直接复制过来修改自己的路径。

//设置外部预览为SumatraPDF
"latex-workshop.view.pdf.viewer": "external",
"latex-workshop.view.pdf.external.command": {
    "command": "D:/Program Files/SumatraPDF/SumatraPDF.exe",
    "args": [
        "%PDF%"
    ]
},

正向定位

参考[参考4]直接复制过来修改自己的路径。

//配置正向搜索，正向定位
"latex-workshop.view.pdf.external.synctex": {
    "command": "D:/Program Files/SumatraPDF/SumatraPDF.exe",
    "args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "%PDF%"
    ]
},

(上面是20190702更新)

Sumatra PDF

比较欣赏Sumatra PDF的一个地方是，它可以实时加载文件，在LaTeX编译生成pdf的过程不需要不停地关闭打开。之前用的Adobe Acrobat CC Pro似乎做不到这一点。另外Sumatra PDF小巧轻便还可以放到可移动设备里面，真的是给赞。

(下面是20190702更新)

此处反向定位参考了[参考4], 然后发现不好使，参考了github上的讨论，需要多加一个-r 。

其实是看参考[参考5]看的早，有个印象是直接让VSCode打开SumatraPDF会出现反向定位不好使需要提前手动打开SumatraPDF才行。然后自己一直搞不定反向定位。
看了刚刚那个github上的讨论才知道，直接用VSCode控制打开就行，不需要加-r也行。

打开 SumatraPDF，进入设置->选项->设置反向搜索命令行。

“Code.exe” “resources\app\out\cli.js” -g “%f”:”%l”

把前面两者的路径替换成自己电脑上的具体路径。

“D:\Program Files\Microsoft VS Code\Code.exe” “D:\Program Files\Microsoft VS Code\resources\app\out\cli.js” -g “%f”:”%l”

(上面是20190702更新)

入坑LaTeX的动机

了解LaTeX

Tax

Tax的发展

TexLive安装

LaTeX使用方案

TexLive安装记录

1. 下载TexLive

2. 查看相关文档

3. 开始安装TexLive

4. 验证是否安装成功

5. 基本命令的使用

TeXStudio安装

TeXStudio下载

TeXStudio安装

一些设置

Visual Studio Code LaTeX Workshop Extension

tool 编译方式

recipe 编译链

外部PDF预览

正向定位

Sumatra PDF

更多资料

关于LaTeX入门与学习的资料

关于LaTeX安装相关参考