跳转至

安装

使用 pip 安装

pip install latticesvg

可选功能

LatticeSVG 提供两组可选依赖，按需安装：

pip install latticesvg[png]

安装 CairoSVG 以支持 SVG → PNG 转换。

pip install latticesvg[hyphens]

安装 Pyphen 以支持多语言自动断词（hyphens: auto）。

pip install latticesvg[png,hyphens]

系统依赖

FreeType

LatticeSVG 使用 freetype-py 进行字形精确测量，需要系统安装 FreeType 库。

sudo apt install libfreetype6-dev

sudo dnf install freetype-devel

brew install freetype

macOS 通常已预装 FreeType。

freetype-py 会自动下载预编译的 FreeType DLL，通常无需额外操作。

Cairo（仅 PNG 输出）

如需 PNG 输出，还需安装 Cairo 图形库：

sudo apt install libcairo2-dev

brew install cairo

参阅 CairoSVG 安装指南。

验证安装

import latticesvg
print(latticesvg.__version__)  # 0.1.0

from latticesvg import GridContainer, TextNode, Renderer

page = GridContainer(style={"width": "200px", "padding": "10px"})
page.add(TextNode("Hello LatticeSVG!"))
Renderer().render(page, "test.svg")
print("✓ LatticeSVG 安装成功")

开发安装

如果你想从源码安装并参与开发：

git clone https://github.com/nicholasgasior/LatticeSVG.git
cd LatticeSVG
pip install -e ".[dev,docs]"
pytest  # 运行测试