HappyTexing

大幅加速LaTeX编辑的工具集

English version

用LaTeX写作业的时候，总是苦恼速度太慢，于是有了这个仓库。所有的配置都只适用于 linux (我用的Ubuntu 19.04)，也许在macos下面也能用.

你可以使用脚本安装所有工具或者自己下载。

git clone https://github.com/yujie6/HappyTexing.git
sudo bash install.sh

1. 加速工具

1.1 Vimtex

Vimtex 集成了 latexmk, 一个可以实时编译的tex工具（texlive自带）. 也就是说只要你修改文件后进行了保存，latexmk会自动帮你编译并且将修改显示在pdf上

\ll 后台运行 latexmk.
\lv 查看 pdf，你可以在.vimrc中设置pdf查看器.
\le 查看报错.
:nn 查看所有相关的命令.

除此之外你还可以在.vimrc中自定义latexmk的编译选项。例如

let g:vimtex_compiler_latexmk = {
        \ 'background' : 1,
        \ 'continuous' : 1,
        \ 'build_dir' : '.',
        \ 'executable' : 'latexmk',
        \ 'options' : [
        \   '-xelatex',
        \ ],
        \}

1.2 UltiSnips

这是提速的核心. 我强烈推荐安装这个vim插件来加速latex的编辑. 你可以查看这个博客窥见他有多么的方便。

tex.snippets文件里集成了所有编辑tex文件时使用的snippet，你也可以自己编写snippet，格式如下

snippet 触发字符 "代码片段说明" [参数]
代码片段内容
endsnippet

主要参数有

b 表示触发字符应该在一行的开始
i 表示触发字符可以在单词内（连续展示会使用这个选项）
w 表示触发字符的前后必须是一个字母分界点
r 表示触发字符可以是一个正则表达式
t 表示展开的代码片段中如果有制表符，原样输出，即使你的 vimrc 里面设置了 expandtab
m 表示删除代码片段右边的所有空白字符
e 表示自定义上下文
A 表示自动触发，不需要按 tab，类似于 VIM 中的 abbr

除了自动展开这一功能，Ultisnips还支持python和shell。例如

snippet today
Today is the `date`.
endsnippet

1.3 preamble.tex

这是一个保存自定义命令和宏的头文件.

\input{../preamble.tex}

编辑中文最好使用 \documentclass{ctexart}. 并且将 xelatex作为你的编译器。为了能够在latexmk中使用xelatex, 只需添加

$pdflatex="xelatex";

到$HOME/.latexmkrc.

2. 编辑环境美化

2.1 Zathura

Zathura 是一个轻量级的 pdf 查看器，他有着和vim差不多的快捷键. 你可以通过

vim ~/.config/zathura/zathurarc

来配置zathura。比如我可以加两行来修改颜色

set recolor-darkcolor  \#bfc7d5
set recolor-lightcolor \#262626

这样当我使用ctrl R 进入夜间模式时，其背景颜色就和我的vim一样了，看起来就很舒服。

2.2 vim美化

这个没有研究太多，我用了palenight和vim-airline. 以及vim-plug（一个插件管理器）, 安装和更新插件都十分方便. 更多细节可以查看 .vimrc .

3 快速做图（可选）

inkscape 是一个极为强大的开源作图软件，支持所有平台。它支持输出 .pdf_tex，也就是说你可以在图里自由的加入公式。配合Gilles开发的快捷键工具，你可以很快的输出高质量图片。这个软件需要一些学习成本，而且可能并不是每个人都需要作图，所以下载与否需要考虑一下。

4. 致谢

非常感谢 Gilles Castel的博客。我拜读了他的几篇博客感觉醍醐灌顶，这真的帮我省了很多时间。如果你有使用起来比较方便的工具或者宏，欢迎提交pull request。

yujie6/HappyTexing