Pages

Monday, May 13, 2019

转:论文写作利器 LaTex 系列之推荐套装

From: http://www.huangpan.net/?p=1756

软件安装和配置

依次安装如下软件并进行配置,其中

TeX Live(必装)

TeX Live 是由国际 TeX 用户组织 TUG 开发的 TeX 系统,支持不同的操作系统平台。这也是本方案的核心,配置所有的编译环境和各种宏包,还附带了一个编辑器(不是很好用)。

下载

由于 TeX Live 2019 常规安装需要一边下载一边安装,速度较慢,所以博主推荐直接下载 ISO 文件,可一次性获取完整的安装文件,可以使安装过程更为顺畅。放上清华大学的镜像,点击链接下载。

安装

  1. 下载的文件是 ISO 光盘镜像文件,用虚拟光驱挂载或者直接用解压工具打开即可。
  2. 在解压出来的主目录中找到 install-tl-advanced.bat 文件,右击并以管理员身份运行注意:文件夹路径里面不能有中文,不然打不开。



  1. 选择安装目录。注意:安装后将会占用5G左右的磁盘空间,建议将安装目录切换到D盘或者其他空间较大的盘中。
  2. 其他默认即可。

VSCode(必装)

VSCode 全称 Visual Studio Code,是微软出的一款轻量级代码编辑器,免费、开源而且功能强大。它支持几乎所有主流的程序语言的语法高亮、智能代码补全、自定义热键、括号匹配、代码片段、代码对比 Diff、GIT 等特性,支持插件扩展,并针对网页开发和云端应用开发做了优化。软件跨平台支持 Win、Mac 以及 Linux。 更多关于 VSCode 的介绍,请点击链接查看本站文章。

下载

下载链接

安装

查看本站安装教程

LaTex Workshop(必装)

LaTex Workshop 是 VSCode 的插件,这个插件为 VS Code 提供了 LaTeX 语言支持。

下载安装

在 VSCode 的扩展管理中,搜索 latex,第一个结果就是我们要安装的插件。



基本配置

在 VSCode 里面按住快捷键,CTRL+SHIFT+P,然后输入 set,用 ENTER 选择第一个。

然后将下面的代码复制粘贴到你的 setting.json 文件最外面移对花括号里。
"latex-workshop.latex.recipes": [{
        "name": "xelatex",
        "tools": [
            "xelatex"
        ]
    },
    {
        "name": "xelatex ->bibtex -> xelatex*2",
        "tools": [
            "xelatex",
            "bibtex",
            "xelatex",
            "xelatex"
        ]
    },
    {
        "name": "pdflatex",
        "tools": [
            "pdflatex"
        ]
    }
],
"latex-workshop.latex.tools": [{
        "name": "xelatex",
        "command": "xelatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "pdflatex",
        "command": "pdflatex",
        "args": [
            "-synctex=1",
            "-interaction=nonstopmode",
            "-file-line-error",
            "%DOC%"
        ]
    },
    {
        "name": "bibtex",
        "command": "bibtex",
        "args": [
            "%DOCFILE%"
        ]
    }
],
现在就可以用 VSCode 编辑 LaTex 文档并编译出 PDF 文件了,按 CTRL+ALT+B 编译,然后按 CTRL+ALT+V 打开 PDF 文件。

还有一些小细节

为了使用过程更舒服,博主还建议修改两个参数:
"latex-workshop.latex.autoClean.run": "onBuilt",
"latex-workshop.latex.autoBuild.run": "never",
]
由于 LaTex 编译过程会产生一些辅助文件,放在那没什么用,看着也糟心,所以第一个参数是指定在PDF文件生成后自动清除辅助文件。第二个参数是指保存是否自动编译 LaTex 文件,因为 VSCode 有自动保存功能,所以每次自动保存都会编译 LaTex 文件,这样就会导致电脑每隔一段时间就会自动编译文档,没有必要。

Sumatra PDF(推荐)

Sumatra Pdf 是一款轻量级的 PDF 阅读器,类型为开放软件,并且有安装版和便携版两个版本。 VSCode 内置的 PDF 查看器功能比较简单,而且不太方便,而 Adobe Reader 则相对体积大,打开速度慢。Sumatra PDF 小巧强大,启动速度快,作为本方案的 PDF 阅读器最合适不过,而且还可以和源码之间实现定位跳转,弥补 LaTex “所见非所得”的劣势。

下载安装

基本配置

要使用 Sumatra PDF 预览编译好的PDF文件,将下列代码复制粘贴至 setting.json 配置文件内。
"latex-workshop.view.pdf.viewer": "external",
"latex-workshop.view.pdf.external.command": {
    "command": "C:/Programs/SumatraPDF/SumatraPDF.exe",  //SumatraPDF.exe的实际路径
    "args": [
        "%PDF%"
    ]
},

配置正向搜索(LaTex->PDF)

"latex-workshop.view.pdf.external.synctex": {
    "command": "C:/Programs/SumatraPDF/SumatraPDF.exe",  //SumatraPDF.exe的实际路径
    "args": [
        "-forward-search",
        "%TEX%",
        "%LINE%",
        "%PDF%"
    ]
},
右键文件空白处,单击 SyncTeX from cursor 或者 CTRl+-> 即可正向搜索。

配置反向搜索(PDF->LaTex)

打开 Sumatra PDF,进入设置->选项对话框,在“设置反向搜索命令行”处填入如下内容:
"C:\Program Files\Microsoft VS Code\Code.exe"  -g "%f:%l" %Code.exe的实际路径%
双击 PDF 中的任意一处即可跳转到 VSCode 中所对应的内容的源代码处。注意:由于从 VSCode 调用 Sumatra PDF 时是作为子进程的,为避免反向搜索失败,最好是先独立的运行SumatraPDF.exe后再进行正反向搜索。

Git(推荐)

Git 是用于 Linux 内核开发的版本控制工具。经常写论文的人都知道,一篇论文需要修改很多遍才能满意,这个过程中就有许多论文版本,比如初稿,终稿,最终版,打死也不改最终版等等版本,版本一多,就需要管理了,不然太乱了。有的时候可能觉得最终版就是最后要交的版本了,可老师突然说上一个版本更好一点,可上一个版本你都删了,或者你也不知道上一个版本是哪一个了,这就很尴尬了。所以写论文时,一个好的版本控制工具就尤为重要了。

下载安装

官网下载链接

基本教程

博主准备后面再写一篇关于 Git 的文章,先放上我的入门教程,廖雪峰老师的文章,点击查看

VSCode 插件

VSCode 自带了终端,所以可以直接在终端里用命令进行 Git 操作。不过刚开始可能不习惯,需要一些图形按钮进行辅助,而且这些插件还加强了 Git 的操作,还是很有必要安装的。
  • GitLens
  • Git History

其他配置

latex-formatter

这是一款 VSCode 的 LaTex 代码格式化插件,虽然 LaTex 最终显示效果和源码的排版没关系,但排版美观的 LaTex 源码可以让人更加沉浸在写作中,并且清晰的排版可以让初学者更容易找到源码中的错误。它的效果如下:
\chapter{balabalabala}
    \section{balabalabala}
        \subsection{balabalabala}
            \par balabalabala
        \subsection{balabalabala}
            \par balabalabala
    \section{balabalabala}
        \subsection{balabalabala}
            \par balabalabala
上面的缩进使我们一眼就可以看出他们之间的等级关系。

LaTex 辅助软件

挖一个坑,下篇文章再讲。

验证配置是否成功

新建一个文件夹(文件夹名字和文件夹的路径里面不能有中文),在文件夹里面新建一个 test.tex 文件。依次,文件夹上右键 -> open with Code,将下列代码复制粘贴进 test.tex 中。
%!Tex Program = xelatex
\documentclass{article}
\usepackage{zhfontcfg}
\begin{document}
\title{My \LaTeX{}}
\author{黄盼}
\maketitle
%\today
\par{配置成功。}
\end{document}
先单独启动 Sumatra PDF 阅读器,再按 CTRL+ALT+B,编译完后,再按 CRTL+ALT+V,调用 Sumatra PDF 阅读器查看编译好的 PDF 文件。在 PDF 适当位置双击,即可跳转至 VSCode 中的 LaTex 源码,在源码处,右键,单击 SyncTeX from cursor 即可查看对应 PDF 所对应位置。