使用PyLaTeX生成PDF时如何添加页面边框？

PyLaTeX本身确实没有专门封装添加页面边框的API，但咱们可以通过插入原生LaTeX代码来实现这个需求，下面给你两种实用的方案：

方案一：使用fancybox包实现简单页面边框 #

fancybox是LaTeX中用于添加各类边框的常用工具包，我们可以在PyLaTeX文档中导入这个包，并添加对应的命令来生成页面边框：

from pylatex import Document, Command, Package

# 保留你原有的geometry配置
geometry_options = { 
    "head": "40pt", 
    "margin": "0.5in", 
    "bottom": "0.6in", 
    "includeheadfoot": True 
}
doc = Document(geometry_options=geometry_options)

# 导入fancybox包
doc.packages.append(Package('fancybox'))

# 配置页面样式和边框参数
doc.preamble.append(Command('fancyhf'))  # 清空默认页眉页脚样式
doc.preamble.append(Command('pagestyle', 'fancy'))
# 设置边框的上下左右偏移量（这里都是0.5cm，你可以根据需求调整）
doc.preamble.append(Command('fancyframe', options=['0.5cm', '0.5cm', '0.5cm', '0.5cm'], arguments=''))

# 添加你的文档内容
doc.append("这是带页面边框的测试内容")

# 生成PDF，保留tex文件方便调试
doc.generate_pdf("bordered_document", clean_tex=False)

方案二：使用tikz包绘制自定义边框（更灵活） #

如果需要更个性化的边框样式（比如圆角、彩色边框、装饰元素），tikz包会是更好的选择，它能让你完全自定义边框的外观：

from pylatex import Document, Package, NoEscape

# 保留原有geometry配置
geometry_options = { 
    "head": "40pt", 
    "margin": "0.5in", 
    "bottom": "0.6in", 
    "includeheadfoot": True 
}
doc = Document(geometry_options=geometry_options)

# 导入tikz和辅助计算的calc包
doc.packages.append(Package('tikz'))
doc.packages.append(Package('calc'))

# 插入原生LaTeX代码来绘制边框，用NoEscape避免PyLaTeX转义内容
border_code = NoEscape(r"""
\AddToShipoutPictureBG{
    \begin{tikzpicture}[overlay, remember picture]
        % 绘制带圆角的蓝色粗边框，偏移量和样式可自由调整
        \draw[thick, blue, rounded corners=5pt]
            ($(current page.north west)+(0.5in, -0.5in)$)
            rectangle
            ($(current page.south east)+(-0.5in, 0.5in)$);
    \end{tikzpicture}
}
""")
doc.preamble.append(border_code)

# 添加文档内容
doc.append("这是用TikZ绘制的自定义边框测试内容")

# 生成PDF
doc.generate_pdf("custom_border_document", clean_tex=False)

小提示 #

• 确保你的LaTeX环境已经安装了对应的包（fancybox和tikz都是主流LaTeX发行版自带的，一般不需要额外安装）。
• 调整边框参数时，保留clean_tex=False可以查看生成的TeX文件，方便调试样式。
• 你可以修改代码中的颜色（比如blue改red）、厚度（thick改ultra thick）、偏移量等参数，打造符合需求的边框。

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