如何避免PyLaTeX生成\usepackage时带连字符包名出现大括号？

问题描述 #

使用PyLaTeX编写代码生成含tikz-feynman包的LaTeX文档时，PyLaTeX会自动将包名中的连字符转义，生成的.tex文件中\usepackage命令里的包名变成tikz{-}feynman，而非正确的tikz-feynman，导致文档无法编译。

问题代码：

from pylatex import Document, Package

doc = Document("my_diagram")
doc.packages.append(Package("tikz-feynman", options=["compat = 1.0.0"]))
doc.append("Some text...")
doc.generate_tex()

解决方案 #

方案1：直接插入原始LaTeX命令 #

绕过PyLaTeX的包名转义逻辑，用RawLaTeX直接添加正确的\usepackage命令：

from pylatex import Document, RawLaTeX

doc = Document("my_diagram")
# 直接插入未经转义的\usepackage命令
doc.append(RawLaTeX(r"\usepackage[compat=1.0.0]{tikz-feynman}"))
doc.append("Some text...")
doc.generate_tex()

方案2：强制指定未转义的包名 #

PyLaTeX的Package类会自动转义包名中的特殊字符，我们可以手动覆盖package_name属性，强制使用原始包名：

from pylatex import Document, Package

doc = Document("my_diagram")
pkg = Package("tikz-feynman", options=["compat=1.0.0"])
# 覆盖转义后的包名，使用原始名称
pkg.package_name = "tikz-feynman"
doc.packages.append(pkg)
doc.append("Some text...")
doc.generate_tex()

以上两种方法都能确保生成的.tex文件中包名保持为tikz-feynman，正常编译文档。

内容的提问来源于stack exchange，提问作者Lukas_peron