开源项目Blabel安装与配置完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01207/article/details/143042980

开源项目Blabel安装与配置完全指南

blabel :label: Python label/sticker PDF generation. HTML templates, built-in barcodes, qr codes, and other goodies 项目地址: https://gitcode.com/gh_mirrors/bl/blabel

项目基础介绍

Blabel是一款由Python编写的开源标签生成工具，专为打印带有条形码、二维码等信息的标签而设计。它通过HTML模板和CSS样式定义标签布局，非常适合生物样本标签制作等场景。此项目属于EGF Codons合成生物学软件套件的一部分，拥有MIT许可证，这意味着任何人都可以自由地使用、修改和分发。

主要编程语言: Python

关键技术和框架

HTML与Jinja模板引擎: 用于定义标签的视觉外观。
CSS: 控制标签的整体样式与布局。
WeasyPrint: 一个Python库，负责将HTML渲染成PDF格式，是Blabel的核心依赖，使得能够生成适合打印机的PDF文件。
内置支持的条形码生成技术: 包括QR码、DataMatrix等，方便集成到标签上。

准备工作与详细安装步骤

步骤1：环境准备

确保您的计算机上已安装Python 3.x版本，并且有权限安装Python包。可以通过在终端输入python3 --version来检查Python版本。

若未安装Python，可以从官方网站下载并安装适合您操作系统的Python版本。

步骤2：安装Blabel

打开终端（Mac/Linux）或命令提示符/PowerShell（Windows），运行以下命令安装Blabel及其所有依赖：

pip install blabel

如果有遇到WeasyPrint安装的问题，可能需要额外安装系统级别的依赖，如Pango、Cairo和GDK-Pixbuf。在macOS上，可以通过Homebrew安装Pango：

brew install pango

对于某些Linux发行版，可能还需要安装libffi-dev以确保成功编译依赖项：

sudo apt-get install libffi-dev  # 对于基于Debian的系统

若需特定版本的WeasyPrint以适配旧系统，可以指定版本号安装：

pip install weasyprint==52

步骤3：创建标签模板与样式表

创建一个HTML模板文件（例如：item_template.html），用以定义每个标签的内容。参考项目示例，使用Jinja语法插入动态数据。
编写一个CSS样式表文件（如：style.css），控制标签的样式，包括页面尺寸、字体等，记得利用CSS @page规则适应标签纸张大小。

步骤4：编写Python脚本进行标签生成

在Python脚本中，实例化LabelWriter对象，关联到之前创建的模板与样式文件，然后提供数据列表（每个元素代表一个标签要打印的信息）。

from blabel import LabelWriter

label_writer = LabelWriter("item_template.html", default_stylesheets=["style.css"])
records = [
    {"sample_id": "s01", "sample_name": "Sample 1"},
    {"sample_id": "s02", "sample_name": "Sample 2"}
]
label_writer.write_labels(records, target='output.pdf')

上述脚本将依据提供的数据生成PDF文件，每个标签一页，可用于打印。