相关推荐:《vscode基础教程》
visual studio code (以下简称 vs code)是微软推出的一款编辑器,在尝试为用他配置 python 开发环境之后,我深深的被 vs code的代码高亮和中文显示吸引了,以至于用了这么多年的 sublime text 都想迁移到 vs code,搭建好 latex 环境之后,我对比了下 sublime text 和 vs code,感觉 sublime text 这块更成熟(特指 latex),vs code 属于追赶者,用过之后觉得还是很不错的~~
基本要求texlive 或者 miktex (本文以 texlive 2015 为例)visual studio codelatex workshop (vs code 插件)软件的安装texlive 和 visual studio code 的安装这里不赘述,需要注意的一个事情是,安装之后需要将 texlive 的 bin 目录(c:\texlive\2015\bin\win32)添加到系统的环境变量(path)中。
插件的安装在安装 visual studio code 之后,在左侧打开 扩展(快捷键 ctrl+shift+x),搜索 latex workshop,选择安装,并选择重启 vs code 激活插件。
两种编译方式使用可变 tex 引擎在我们编写 latex 文档的时候,有两个命令很特殊,一个是 %!tex program = xelatex,一个是 % !tex root = relative/or/absolute/path/to/root/file.tex,前者指定编译方式,后者指定主(根)文件,借助这个,我们可以对不同文档设定不同的编译方式,这就简化了编译时的麻烦。如果我们指定了文档的编译方式,则只需要按照下面配置就可以编译 latex 文档了。
具体做法是,在 vs code 左下角,点击齿轮图案的按钮,选择 设置,在右侧添加 latex workshop 的配置命令
"latex-workshop.latex.clean.enabled": false, "latex-workshop.view.pdf.hand": true, // 可变编译方式 "latex-workshop.latex.toolchain": [ { "command": "", // 注意这里是留空的 "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%doc%" ] } ],
然后我们选择新建一个文档(前几天看到两个博主借鉴我们 2014 年 sublime text 搭建 latex 编写环境博文的内容,连下面的代码都是一样的,但是在文中却没有引用我们的,呵呵呵),鉴于此,我决定加入一些个人信息。
%!tex program = xelatex% 使用 ctexart 文类,utf-8 编码\documentclass[utf8]{ctexart}\title{测试}\author{ddswhu}\date{\today}\begin{document}\maketitlethis is the context of the article.这就是文章的所有内容。\end{document}
将这个文件保存为 test.tex,然后使用快捷键 ctrl+alt+b 编译,或者在文档中,鼠标右键,选择 build latex project,这样就能使用 xelatex 编译 test.tex 了。
其实,latex workshop 默认的编译方式是 latexmk,我们还可以仿造 miktex 里面的 texify 命令,只需要将配置修改为
"latex-workshop.latex.toolchain": [ { "command": "texify", "args": [ "--synctex", "--pdf", "--tex-option=\"-interaction=nonstopmode\"", "--tex-option=\"-file-line-error\"", "%doc%.tex" ] }]
指定编译方式修改插件配置文件说到指定单独的编译方式,这里还是有两个不同的方式,一种是在上述的配置基础上继续修改,可以将 command修改为 xelatex或者pdflatex以及bibtex。
以下是一个完整的 pdflatex 编译(pdflatex->bibtex->pdflatex->pdflatex)
"latex-workshop.latex.toolchain": [ { "command": "pdflatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%doc%" ] }, { "command": "bibtex", "args": [ "%docfile%" ] }, { "command": "pdflatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%doc%" ] }, { "command": "pdflatex", "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%doc%" ] }]
因为这里指定了具体的编译方式,所以在文档部分不需要指定编译方式。由于配置文件是全局的,所以这种方式对于不同文件,你需要临时配置文件,有点不太方便。
修改项目任务文件在 vs code 中,在操作时并不是以单个文件为依托,而是以项目或者工程为单位。对应的,在 vs code,我们需要将这个文件夹导入到 vs code 中,并为这个项目配置 tasks.json 文件,在 tasks.json 文件中指定编译方式等。
具体操作是,在任务栏选择 任务->运行任务,然后 vs code 会提示没有任务,需要配置任务,然后选择使用模板创建任务,在模板选择的时候,选择 ms.build 就行。然后将 tasks.json文件内容修改为(filename 替换为你需要编译的文件名(主文档))。
{ "version": "0.1.0", "isshellcommand": true, "suppresstaskname": true, "tasks": [{ "taskname": "pdflatex", "command": "pdflatex", "isbuildcommand": true, "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "filename.tex" ]}, { "taskname": "bibtex", "command": "bibtex", "istestcommand": true, "args": ["filename.aux"] }, { "taskname": "xelatex", "command": "xelatex", "isbuildcommand": true, "args": [ "-synctex=1", "-interaction=nonstopmode", "-file-line-error", "filename.tex" ]}, ]}
这样,任务配置好了,接下来就只要运行就行了。依次选择 任务->运行任务,选择你所需要的编译方式,如果需要完整编译,假设文档有 bib 文件,则需要选择 pdflatex->bibtex->pdflatex->pdflatex,这种配置的好处是,你可以完全控制编译方式,能选择编译 bib 文件,适用于大型项目,比如论文,笔记或者书籍等(推荐)。并且只要你配置好 tasks.json文件之后,以后打开文件就不用管编译方式和配置了,可以直接运行任务就行。
其他设置修改快捷键编译的默认快捷键是 ctrl+alt+b,由于我习惯了 sublime text 的 ctrl+b,所以这里我们再提一下 vs code 快捷键的设置,在 vs code 左下角,点击齿轮图案的按钮,选择 键盘快捷方式,然后再搜索栏里面选择 latex workshop,将第一个 build latex project 的快捷键修改为 ctrl+b 即可。
反向定位跳转通过右侧的红色 pdf 按钮,我们可以打开 pdf 预览,我们在查看 pdf 的时候,可以通过快捷键 ctrl+shift+left跳转到代码。
更多编程相关知识,请访问:编程教学!!
以上就是浅谈vscode搭建 latex 编写环境的方法的详细内容。