简单使用 tinytex + vscode

有 TexLive 全家桶不就行了,要啥自行车啊(x

简介

Github

Doc

Tiny 是 yihui 制作的一款基于 texlive 的轻量级、跨平台、简单易用的 latex 发行版。与传统安装体积动则上 G 的 texlive 相比,TinyTex 是按需所取、大幅精简,用 tlmgr 包管理器安装即可,其 几百M的体积就已基本可用。

安装 TinyTex

R 语言途径

简单安装和配置 R 语言

Arch Wiki

如已配置请跳过此部分

1
2
$ sudo pacman -S r
$ touch ~/.Renviron ~/.Rprofile

.Renviron

1
2
3
4
5
R_HOME_USER = /path/to/your/r/directory # 设置你自己的目标路径,下同
R_PROFILE_USER = ${HOME}/.config/r/.Rprofile
R_LIBS_USER = /path/to/your/r/library
R_HISTFILE = /path/to/your/filename.Rhistory # Do not forget to append the .Rhistory
MYSQL_HOME = /var/lib/mysql

.Rprofile

1
2
3
4
5
6
7
8
9
10
11
12
# The .First function is called after everything else in .Rprofile is executed
.First <- function() {
# Print a welcome message
message("Welcome back ", Sys.getenv("USER"),"!\n","working directory is:", getwd())
}

options(digits = 12) # number of digits to print. Default is 7, max is 15
options(stringsAsFactors = FALSE) # Disable default conversion of character strings to factors
options(show.signif.stars = FALSE) # Don't show stars indicating statistical significance in model outputs
error <- quote(dump.frames("${R_HOME_USER}/testdump", TRUE)) # post-mortem debugging facilities

options("repos" = c(CRAN="https://mirrors.tuna.tsinghua.edu.cn/CRAN/")) # 换用 tuna 源

如果不在配置文件中修改源的话,接下来在交互模式内,第一次安装包的时候也会出现一个窗口需要你来选择源。由于弹出窗口是 tk 实现的,所以需手动安装其作为依赖。如果第一次安装选择错误,那么可以进入交互模式后输入 chooseCRANmirror() 来修改,如提示所言,退出交互模式为 q(),并且会问你是否保存会话。

在命令行输入 R,进入交互模式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
$ R

R version 3.5.2 (2018-12-20) -- "Eggshell Igloo"
Copyright (C) 2018 The R Foundation for Statistical Computing
Platform: x86_64-pc-linux-gnu (64-bit)
R is free software and comes with ABSOLUTELY NO WARRANTY.
You are welcome to redistribute it under certain conditions.
Type 'license()' or 'licence()' for distribution details.
Natural language support but running in an English locale
R is a collaborative project with many contributors.
Type 'contributors()' for more information and
'citation()' on how to cite R or R packages in publications.
Type 'demo()' for some demos, 'help()' for on-line help, or
'help.start()' for an HTML browser interface to help.
Type 'q()' to quit R.

> install.packages('tinytex') # 安装 tinytex
> tinytex::install_tinytex()

如果你和我一样并非使用 root 权限安装的话,会出现以下提示,作为普通用户,输入 yes 即可,写入个人目录正合我意。

1
2
3
4
> install.packages('tinytex')
Warning in install.packages("tinytex") :
'lib = "/usr/lib/R/library"' is not writable
Would you like to use a personal library instead? (yes/No/cancel)

如果你看的是中文文档的话,其中默认使用了 devtools 这个包,你需要自己先手动安装,即 install.packages('devtools'),无特殊需求的话直接按上述命令就好。

然后喝杯茶,坐和放宽。

脚本安装

1
wget -qO- "https://yihui.name/gh/tinytex/tools/install-unx.sh" | sh

添加环境变量

安装完成之后会在 $HOME 目录下出现一个 .TinyTex 的文件夹,并且将其中的二进制软链接到了 $HOME/bin,你需要将这个文件夹添加到自己的 $PATH 中才可正常使用 tlmgr 等一系列工具。环境变量生效之后,TinyTex 安装部分至此结束。

中文配置

常用的包有耳熟能详的 ctexxecjkcjkcjkpunctfandol 等,如果是直接用脚本安装的话可能需要手动装更多依赖,如果不确定要装什么包的话可以先找个简单的示例文档进行编译和预览,再根据报错提示来安装缺失的依赖包。

安装包过程同上,可以使用 R 语言提供的交互式命令行安装,即 tlmgr_install('PackageName'),也可以直接在命令行下用 earch --file --global ctexart.cls 查找对应的包名,再使用 tlmgr install <PackageName> 安装,或者是 tlmgr --gui 从自带的图形界面(虽然丑了点)进行安装和配置。这里在安装之前改到了 ustc 的源,以加快下载速度。

https://mirrors.ustc.edu.cn/CTAN/systems/

vscode 上的 tex 支持由 LaTeX Workshop 提供

Ctrl+P 打开快捷菜单,粘贴命令安装。

1
ext install James-Yu.latex-workshop

示例文档 预览效果如上,其默认编译器的 pdflatexctex 中文包支持不是很好,建议按照官方 wiki 说明在文档添加 % !TEX program = xelatex ( Magic comment),使用 xelatex 作为指定编译器。

其余具体 LaTeX 使用方法不妨参见 TUNA 的演示教程