UOS系统下搭建latex环境

UOS系统下搭建latex并使用plantuml进行绘图。

本文适读人群

有linux下使用vscode开发经验
了解linux下环境变量原理以及设置

本文能够知道什么

latex的搭建
latex中使用plantuml
vscode如何使用latex

本文不知道什么

latex的语法
plantuml的搭建

latex的安装

在官网对Tex Live进行下载，下载链接。下载之后会得到一个install-tl-unx.tar.gz，解压之后获取install-tl，直接运行输入I即可安装。不推荐使用命令安装sudo apt install texlive-full，debian上游的版本太老。

将已安装成功的texlive路径加入至环境变量

1
2
3

export MANPATH=${MANPATH}:/usr/local/texlive/2021/texmf-dist/doc/man
export INFOPATH=${INFOPATH}:/usr/local/texlive/2021/texmf-dist/doc/info
export PATH=${PATH}:/usr/local/texlive/2021/bin/x86_64-linux

~~2. 将已安装成功的texlive的可执行程序软链放入/usr/bin中，如果用其他的都可放入~~s

调用tex --version，有版本信息则是调用成功

latex引用包配置

查看本地包存放地址
1
kpsewhich -var-value=TEXMFHOME

将引用包存放至本地目录，在开发tex文件时，就可以找到了。

1	环境变量为 /home/mecry/texmf, 自定义包存放至/home/mecry/texmf/tex/latex/目录下

vscode的配置

在vscode扩展商店中安装LaTeX Workshop和LaTeX Utilities扩展插件
在vsocde首选项设置中搜索latex-workshop.latex.tools，点击setting进行设置

增加以下配置,此配置只针对lualatex，当vscode进行编译时调用的就是lualatex

{
"latex-workshop.latex.recipes": [
    {
        "name": "lualatex->biber->lualatex",
        "tools": [
            "lualatex",
            "biber",
            "lualatex"
        ]
    }
],
"latex-workshop.latex.tools": [
    {
        "name": "lualatex",
        "command": "lualatex",
        "args": [
            "-synctex=1",
            "-shell-escape",
            "-interaction=nonstopmode",
            "-file-line-error",
            "-pdf",
            "%DOC%"
        ]
    },
    {
        "name": "biber",
        "command": "biber",
        "args": [
            "%DOCFILE%"
        ]
    }
],
"latex-workshop.view.pdf.viewer": "tab",
"window.zoomLevel": -1
}

latex-workshop.latex.tools：编译工具选项，也就是我们上面在 Build LaTex project 下拉菜单看到的，只要在这里配置了 tools ，就会新增到下拉菜单里供我们选择。
latex-workshop.latex.recipes：配置每一个编译的小环境。

latex中使用plantuml

首先需要将本机的plantuml环境搭建成功，此文档不进行赘述默认已完成安装
在plant官网下载对应的jar扩展包
调用命令下载plantuml脚本
1
sudo apt install plantuml
编辑/usr/bin/plantuml脚本，将本机下载的plantuml.jar路径进行编辑，将$JAVA开头这句话进行替换
1
$JAVA -Djava.net.useSystemProxies=true $HEADLESS -jar "/usr/share/plantuml/plantuml.jar" "$@"
-Djava.net.useSystemProxies=true $HEADLESS这句话影响plantuml颜色，不加就会是黑白的，/usr/share/plantuml/plantuml.jar这个路径为系统的plantuml.jar路径，将第二步下载的文件进行替换。

编辑/usr/share/texlive/texmf-dist/tex/lualatex/plantuml/plantuml.lua脚本，将其plantuml路径进行替换

--local plantUmlJar = os.getenv("PLANTUML_JAR")
--if not plantUmlJar then
    --texio.write_nl("Environment variable PLANTUML_JAR not set.")
    --return
--end

注释plantumljar

1
2
3

texio.write("Executing PlantUML... ")
--  local cmd = "java -jar " .. plantUmlJar .. " -t"
local cmd = "plantuml -charset UTF-8 -t"

将plantuml加入至cmd命令中并加上-charset UTF-8 -t，处理中文问题。

Link Mecry

【问题解决】UOS下搭建latex