begin{document}
装LATEX的路简直令我无法形容,看CSND,看B站,上Youtube,看教程。我折腾了16个小时整整两天。很多教程视频都是很老的了。我和你们一样,就是一个小白,第一次用LaTex和vs code,我在不懂得json语法的情况下在设置区里添加了各种各样的代码,都失败了。相反,我一气之下把添加到设置区的代码全删了,除了workshop之外的插件都删了,反而成功了。
正文:
- 安装texlive最新版本,我想默认会勾选添加环境变量的(官方:http://www.tug.org/texlive/)(如果你不知道什么是环境变量。。。https://www.bilibili.com/video/BV1w741147G9)
- 安装VS CODE,免费开源的人人都能。(官网:https://code.visualstudio.com)
- 进入VS CODE,左边拓展包,搜索latex,安装LaTeX workshop。(是的你不需要别的插件。现在是2020年。)
- 新建文件,保存后缀为*.tex,注意文件名和路径都不能有中文(不然的话你可能无法使用xelatex)
- 想在文章中加入中文,可以usepackage[UTF8]{ctex},也可以直接documentclass[UTF8]{ctexart}
- 试着编译一下,默认是ctrl+alt+b。
提示:
- ctrl+alt+j即可从代码跳到pdf。可以搜索latex sycnctex from cursor改成别的键
- crtl+点击pdf即可反向查找,如图代码被白框包围。可以搜索Synctex:Keybinding 改成双击
- 先写caption后写label,不然引用可能不正确
- *.bib文件名称别带空格!(我曾经怎么都没搞懂哪里错了最后是瞎几把打开aux文件才发现问题的。)(尤其是Endnote会默认导出有空格的文件名)
- 右键选择格式化文档,VS CODE能自动排版你的代码,但是不能排版chapter, section, subsection之间的缩进,需要自己在workshop插件里面去设置。
- 如果你需要用XeLatex,只需要在文档中加入%!TEX program=xelatex即可,然后用快捷键编译或者点击插件菜单栏中Build LaTex Project编译。(这是magic comment模式,可以被识别不会被当成注释。)(可以试着插入一张bmp格式的图片来测试你是否成功使用了xelatex编译)(xelatex很慢,如果文档很小很简单就别用xelatex了,可以用pdflatex)
- 如果你使用biblatex宏包处理文献,那么你必须使用biber编译文献。同样,想用biber也只需要在文档中加入%!BIB program=biber即可。
可选项:
- 代码自动换行:点击齿轮打开设置,搜索Editor:WordWrap,将off修改为on即可。
- 在设置里面搜索latex-workshop.latex.autoClean.run并改为onBuilt,这样可以自动删掉多余的垃圾文件。有时候不这样的话编译就会出错。
- Workshop默认会自动编译,你一改变文档他就试图自动编译,建议搜索latex-workshop.latex.autoBuild.run,把onfilechange变成never。
- 设置->配置用户代码片段。例如我在输入的时候直接写png或者jpg就可以插入图片
建议(按照优先级排序):
- 学一学VS CODE的各种神奇操作,快捷键,插件(比如TabNine),不然就失去了用VS CODE的意义。
- 学习json的格式,搞懂setting.json是怎么生效的
- 如果有时间请略读一遍workshop插件的官方wiki:https://github.com/James-Yu/LaTeX-Workshop/wiki
- 学习texstudio和overleaf的基本用法。大家都是来写论文的,人品好的还可能有学校提供的模板。这些模板千奇百怪,万一我的方法你还是无法成功,给自己留手后路。
下面是一些“邪教”:
- VSCode插件搜索Vim甚至NeoVim
- Pandoc
- Capslock+
下面是一些废话,可以不看:
2020.11.06: 时过境迁,我已经转专业读北航软件学院了。当初接触VSCode只是为了能方便地完成毕业设计,如今它已经成了我离不开的生产利器。感谢在当初LaTex上“浪费”的每一秒,都是成长。
-------------------------------------------------
%祝大家毕设顺利
end{document}