Archlinux下VSCode+Latex+Zotero的论文写作方案

开源拖拉机将就着用吧,又不是不能用,再见Word、EndNote和Windows。顺便说一下你电的LaTeX模板怎么用。不定期更新到毕业。

又遇到了Lamport老爷子的东西,上一次看到Lamport还是上次还是看Paxos算法的时候。

Office很强,但是微软不给Linux开发桌面版(好吧,我有在线的教育版,在线版写写文档还行,但是排版有一些捉襟见肘)。好吧,虚拟机或者wine是可以的但是我不想用。wps的Linux版倒是很不错,但是调格式放到office上又乱了,对数学公式的支持也不是特别好。
另一个让我放弃word和wps的重要原因是我想要用git做版本控制,手动命名一个个v0.0.8、v0.2.1版本的论文初稿实在是太蠢了。
最近放弃WPS的原因是新版本实在太糊了,我在Archlinux上试图降级旧版又失败了。本来以为新版WPS字体模糊是因为没有配适4k分辨率的屏幕,这个文章WPS For Linux个人版更新(Qt5版本)的评论去也确实是这么说的。结果我打开1080p的笔记本,发现字体更糊了。
overleaf应该是我用过最好用的Latex在线编辑,但是我对在线的东西不是很信得过。TexStudio又不是太好看,高分屏下还比较糊,键位也不习惯,放弃了。lyx是很好用,但是我不太喜欢所见即所得,还是习惯左边源码右边编辑结果pdf这种。

最终又回到了VSCode,目前的方案是ArchLinux下Zotero+textlive+VSCode(LaTeX Workshop插件)

安装texlive

我用对中文支持比较好的xelatex,在Arch下我们装texlive的包就可以了。pdflatex也包含在里面,但是这个对中文支持没有那么好,一般用xelatex生成中文pdf。

1
pacman -S texlive-core texlive-langchinese  texlive-fontsextra

texlive的不少宏包在Arch上都有系统的包,你可以用yay等AUR helper装,如果想用tlmgr装,那就用tllocalmgr-git这个AUR包。

Zotero配置

参考文献抓取和管理

首先是中文论文网站引用和pdf抓取的问题,可以用下面这个插件:Zotero translators 中文维护小组

知网文献可以用这个插件:jasminum

下载并放到translater文件夹中(Linux下默认应该是~/Zotero/translators)

1
2
git clone https://github.com/l0o0/translators_CN.git 
cp -r translators_CN/translators/* ~/Zotero/translators

参照README更新插件的translater就行了。

VSCode有一个Zotero LaTeX插件,可以用快捷键直接插入文献。安装后报错Error adding citation: HTTPError: Response code 404 (Not Found),见Zotero Citations: could not connect to。安装beta版本后成功解决。yay -S zotero-beta

使用这个插件需要安装zotero插件zotero-better-bibtex

具体使用请参考:VScode使用说明(Zotero插件) 刘再华

安装好之后按Alt+z就可以方便的插入参考文献了。

然后要插入GB/T 7714格式化的参考文献,可以参考符合 GB/T 7714-2015 标准的 biblatex 参考文献样式

有模板可以直接套模板,模板应该会处理参考文献格式。没有特殊喜好可以用 等支持GB/T格式的模板。

ps:如果单纯为了插入GB/T格式的参考文献可以用一点脏办法: 电子科技大学LaTeX模板参考文献问题解决 (不得已的办法)

自建同步

Zotero的文件同步免费的只有300M,而且很慢。

我们可以自建文件同步,只要支持WebDAV协议就行了。这个好办,Nginx就能做到。

VSCode配置

LaTex插件选择

通常推荐装Latex Workshop这个插件。配置可以参考官方文档, wiki写的很全。功能当然没有TeXStudio全,但是已经满足我的日常需求了(一般只装这一个插件就够了)

另一个插件叫LaTeX。LaTeX Workshop功能比LaTeX插件多一点,如果只想把VSCode当一个普通的文本编辑器不想要额外的snippet等功能的话,装LaTeX这个插件就可以了。

编译配置

编译配置推荐使用latexmk的方案,可以省去xelatex-bibtex-xelatex*2的多次编译。

比如你电的毕业论文模板,完整的编译需要

1
2
3
4
5
xelatex main.tex
bibtex main.aux
bibtex accomplish.aux
xelatex main.tex
xelatex main.tex

编译的时候需要先latexmk编译一遍,再bibtex编译一遍,再latexmk编译一遍,见

或者参考这篇文章:我们该如何优雅地使用LaTeX in 2020

编辑settings.json, 加上能够编译参考文献的配置,就可以在左侧边栏点击运行了。(其实我还是喜欢在命令行里alias将这三个命令指定一个短命令)

1
2
3
4
5
6
7
8
9
10
11
"latex-workshop.latex.recipes": [
{
"name": "xelatex -> bibtex -> xelatex*2",
"tools": [
"xelatex",
"bibtex",
"xelatex",
"xelatex"
]
},
]

这样需要编译四次,有一个更好的方法是latexmk增量编译

我们将settings.json改成这个样子(方案来自在 VSCode 的 LaTeXworkshop 插件中使用 LaTeXmk

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
"latex-workshop.latex.tools": [
{
"name": "LaTeXmk",
"command": "latexmk",
"args": [
"-xelatex",
"-synctex=1",
"-shell-escape",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%",
"-outdir=%OUTDIR%",
]
},
],
"latex-workshop.latex.recipes": [
{
"name": "LaTeXmk",
"tools": [
"XeLaTeXmk",
]
},
],

这样只需要latexmk一个编译命令,latexmk的增量编译也比原来快了。

其他功能

LaTeX Workshop 左侧边栏可以查看字数统计
可以自定义snippest快捷命令
可以插入参考文献(需要手打`\cite{},支持搜索bib文件里的文献(可以用zotero导出并开启同步)), 这样就不用装zotero latex插件了。

json配置

这是我的settings.json配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
//双向搜索
"latex-workshop.view.pdf.viewer": "tab",
//将编译生成的文件放到build文件夹
"latex-workshop.latex.outDir": "build",
//使用latexmk解决插入文献bibtex需要多次编译的问题
"latex-workshop.latex.tools": [
{
"name": "LaTeXmk",
"command": "latexmk",
"args": [
"-xelatex",
"-synctex=1",
"-shell-escape",
"-interaction=nonstopmode",
"-file-line-error",
"%DOC%",
"-outdir=%OUTDIR%",
]
},
],
"latex-workshop.latex.recipes": [
{
"name": "LaTeXmk",
"tools": [
"XeLaTeXmk",
]
},
],
//去掉右下角烦人的警告
"latex-workshop.message.error.show": false,
"latex-workshop.message.warning.show": false,
"latex-workshop.latex.clean.fileTypes": [
//设定清理文件的类型(ctrl+alt+c:清除辅助文件)
"*.aux",
"*.bbl",
"*.blg",
"*.idx",
"*.ind",
"*.lof",
"*.lot",
"*.out",
"*.toc",
"*.acn",
"*.acr",
"*.alg",
"*.glg",
"*.glo",
"*.gls",
"*.ist",
"*.fls",
"*.log",
"*.fdb_latexmk",
"*.nav",
"*.snm",
"*.bcf",
"*.run.xml"
],
"extensions.ignoreRecommendations": true,
"zotero.latexCommand": "cite",
"[latex]": {
"editor.formatOnPaste": false,
"editor.suggestSelection": "recentlyUsedByPrefix"
},

电子科技大学论文模板

Github上有一个不错的模板是shifujun/UESTCthesis,但是时老师的这个模板很久没更新了。
另一个是还在一直更新的模板,本硕博都有,直接clone下来改一下就好了(你电图书馆推荐的,勉强算是半官方的吧)

1
git clone https://github.com/x-magus/ThesisUESTC

网上有一些教程,包括:
知乎上的一篇文章UESTC 本科Latex毕设论文模板 无痛上手指南,这个我本科写毕设的时候就看到同学在朋友圈转过。这个教程我不是很推荐,因为:

但是这里为了减少小伙伴们的学习成本达到“快速无痛上手”的目的(同时考虑到有些小伙伴用word写的很熟练),这里引用电子科大图书馆嵇灵老师的方法:用mathtype编辑,然后转化为latex代码。

河畔现任站长的介绍帖子:LaTeX 学校官方模板-2019年11月发 (需要登陆查看)
以及上一个帖子附件中嵇灵老师的PPT: 使用Latex模板撰写毕业论文(2019)
ps:个人不推荐这个PPT,里面推荐使用被思杰克马丁代理的Mathtype,推荐直接使用Office 2019的Alt+=手打公式(比LaTeX的公式甚至还舒服一点,也直接支持LaTeX的公式),实在想用图形界面输入公式就用AxMath吧,正版30多,还算良心不。

上面那些教程的安装和使用几乎都是Windows环境,编辑器是overleaf和texstudio,而且操作偏向图形化界面点点点(Linux用户应该不会喜欢连LaTeX打公式都要点点点再粘贴上去)

注意要安装下面这些额外的包,不然会报! LaTeX Error: File 'multirow.sty' not found等错误。

1
sudo pacman -S texlive-latexextra texlive-science texlive-bibtexextra

Archlinux下字体问题

一种选择是装win10字体,然后修改thesis-uestc.cls的Default字体设置。AUR有个包ttf-ms-win10-auto-zh_cn,但是这个包由于再分发的版权原因要下载整个win10的iso,然后解压只保留ttf字体文件。身边有win10的建议直接将ttf文件拷贝过来(只要simhei.ttfsimsong.ttfsimkai.ttf就可以了)。
或者安装方正字体(默认的),AUR有个包ttf-fangzheng由于版权原因,也不能直接yay安装,只提供PKGBUILD,需要到官网下载ttf然后手动makepkg

另一种选择是找到模板的字体设置,直接修改thesis-uestc.cls文件(反正毕业论文只要求宋体和黑体,又没说什么宋体和黑体,用系统默认的黑体和宋体就行了)

1
2
3
4
5
6
\else
\iflinux
\setCJKmainfont[BoldFont=FandolSong-Bold.otf,ItalicFont=FandolKai-Regular.otf]{FandolSong-Regular.otf}
\newCJKfontfamily{\heiti}{FandolHei-Regular.otf}
\newfontfamily{\heiti@letter}{FandolHei-Regular.otf}
\setallmainfonts{Times New Roman}

除了中文字体还需要一个Times New Roman罗马字体,这个AUR的包可以直接装。

1
yay -S ttf-times-new-roman

编译

直接运行latexmk main.tex就可以了。

在VSCode里面装了LaTeX Workshop可以点击左上角那个绿色的运行按钮。会弹出一个pdf,将pdf放到右边一栏

关于你电的一些问题

什么?教务处非要收word怎么办?要不妥协用Word,要不用pdf转图片转Word随便交一个上去,要不就pandoc顶着格式乱掉硬转一个,反正这个就是规定留档,没人看。
(隔壁西电早都支持提交LaTeX论文呢,不会有的985连这都不支持吧,非要冒着被制裁的风险用微软家的Word?不会吧?)

老板要用Word批注功能怎么办?这个没办法,回去用Word吧。
推荐你畔现任站长的一篇文章:适用于毕业论文的word排版技巧 之前本科毕设论文排版就看的这个,比你电图书馆的讲座教程和PPT好多了。

知网查重LaTeX会查公式,查重率高怎么办?不好意思这个没办法。

LaTeX教程和模板推荐

模板

LaTeX本来就是用于排版的专业排版工具,能做出很多相当漂亮和复杂的效果。LaTeX能做到什么程度可以看StackExchange上的这个问题:Showcase of beautiful typography done in TeX & friends

想要自己从0设计排版成这样的效果是需要肝的。而我用LaTeX是因为不想花太多精力在排版上,想把它当成Markdown一样的东西用。所以我需要模板。

模板可以来这里找:LaTeXStudio 不过这个网站最近突然换了前端页面还多了不少广告(有种不详的预感)

教程

教程这个不同人适合不同的教程,下面是我比较喜欢的一个:

一份其实很短的 LaTeX 入门文档

其他问题

关闭LaTeX Workshop右下角的烦人通知

LaTeX WorkShop插件每次保存都会弹出通知Formatting failed. Please refer to LaTeX Workshop Output for details.

关闭右下角每次都弹出的烦人提示

1
2
"latex-workshop.message.error.show": false,
"latex-workshop.message.warning.show": false,

双向跳转

双向奔赴了属于是

目前最新的LaTeX Workshop插件是无需配置可以直接跳转的。(插件内置的PDF.js,在VSCode内预览)
网上很多教程已经过时了,直接看官方文档。官方文档写的很清楚:https://github.com/James-Yu/LaTeX-Workshop/wiki/View#synctex

从pdf跳转到tex文件使用Ctrl+鼠标左键
从tex文件定位到pdf相应位置Ctrl+Alt+J

插入图片

插入图片可以放到相应位置然后手写\includegraphics{example.jpg}
如果想从剪切板自动粘贴,和Markdown一样,用paste image插件就行了。我Markdown的paste image配置和latex的不一样,所以放到workspace的json文件里

1
2
3
4
5
6
7
{
"pasteImage.defaultName": "X",
"pasteImage.encodePath": "none",
"pasteImage.path": "${currentFileDir}/pic",
"pasteImage.showFilePathConfirmInputBox": true,
"pasteImage.insertPattern": "\\includegraphics[scale =]{${imageSyntaxPrefix}${imageFilePath}${imageSyntaxSuffix}}"
}

或者我们在user的settings.json里加上

1
2
3
"[latex]": {
"pasteImage.insertPattern": .......
}

表示只对latex生效。

insertPattern选项请根据模板自己修改,比如你电的学位论文模板改成这样就可以了。

1
2
3
{
"pasteImage.insertPattern": "\\begin{figure}[h]\n\t\\includegraphics[width= 6cm]{${imageFileName}}\n\t\\caption{${imageFileNameWithoutExt}}\n\t\\label{fig:${imageFileNameWithoutExt}}\n\\end{figure}",
}

另外需要注意的是paste image插件的快捷键ctrl+alt+v和LaTeX Workshop冲突,要在Keyboard Shortcuts里面换掉一个,不然快捷键粘贴图片不起作用。

参考文献报错

设置参考文献这两行要放在\end{document}前面

1
2
\bibliography{export.bib}
\bibliographystyle{plain}

不然会报错

1
2
I found no \bibdata command---while reading file test.aux
I found no \bibstyle command---while reading file test.aux

某些知网文献bibtex编译报错

垃圾知网不仅弄出了天价查重、caj格式这些天怒人怨的东西,中文文献的引用格式也挺乱的,经常缺这个少那个,而且不支持bibtex。如果用zotero转出来也会因为缺少各种字段而报错。查了一下没什么太好的解决办法。
如何使用BibTeX引用中文参考文献? - 刘海洋的回答 - 知乎 刘海洋老师推荐自己写bibtex,但是我给这些东西写这些,我用LaTeX就是因为不想在word的排版上纠缠过多。

百度好歹干了点人事,能导出bibtex格式。但是有很多学位论文,百度学术也没有万方也没有,就知网有。

之前说过,如果单纯为了插入GB/T格式的参考文献可以用一点脏办法: 电子科技大学LaTeX模板参考文献问题解决 (不得已的办法)。比如插入知网文献的时候可以用这个。一开始觉得这是不太好的脏办法,在被知网的一些参考文献格式整麻了以后,觉得这才是最好的方法。直接粘贴纯文本,反正最后排版效果一样就行了。bibtex的理念不适合处理脏东西,脏东西要用脏办法。

编辑thesis-uestc.bst, 新建一个参看文献格式

1
2
3
4
5
6
FUNCTION {biaoti}
{
bibitem.begin
title write$
newline$
}

然后在reference.bib里面粘贴复制粘贴的文本就可以了,相当于引用纯文本

自动换行

只对Latex开启自动换行

1
2
3
"[latex]": {
"editor.wordWrap": "on"
}

电子科技大学论文模板识别不了linux环境

编译的时候加参数-shell-escape

链接

https://github.com/zuicy/UESTC_report_latex/tree/master/UESTC_report 电子科技大学实验报告的LaTeX模板,是你电信软学院的同学做的,看起来似乎全校通用(改一下学院名字就好了)。
LaTeXStudio上那个是比较老的模板:电子科大的实验报告 LaTeX 模板 - 用户投稿

Linux 下的 LaTex 写作工具链(1)

VScode使用说明(Zotero插件) 刘再华

https://github.com/mblode/vscode-zotero vscode zotero的Markdown引用文献插件。

使用 BibTeX 生成参考文献列表

https://en.wikibooks.org/wiki/LaTeX

https://github.com/hushidong/biblatex-zh-cn

https://github.com/hushidong/biblatex-solution-to-latex-bibliography

https://liam.page/2020/04/24/using-LaTeXmk-with-LaTeXworkshop-with-VSCode/

http://ddswhu.me/posts/2018-04/vs-code-for-latex/

https://www.tug.org/texlive/doc/texlive-zh-cn/texlive-zh-cn.pdf