Brother QL Web 项目安装与使用教程-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00006/article/details/139489128

Brother QL Web 项目安装与使用教程

brother_ql_web A Python-based web service to print labels on Brother QL label printers. Based on brother_ql: https://github.com/pklaus/brother_ql 项目地址: https://gitcode.com/gh_mirrors/br/brother_ql_web

1. 项目目录结构及介绍

brother_ql_web/
├── static/
├── views/
├── .gitignore
├── LICENSE
├── README.md
├── brother_ql_web.py
├── config_example.json
├── font_helpers.py
└── requirements.txt

static/: 存放静态文件，如CSS、JavaScript等。
views/: 存放Web界面的模板文件。
.gitignore: Git忽略文件列表。
LICENSE: 项目许可证文件，采用GPL-3.0许可证。
README.md: 项目介绍和使用说明。
brother_ql_web.py: 项目的启动文件。
config_example.json: 配置文件示例。
font_helpers.py: 字体处理辅助脚本。
requirements.txt: 项目依赖的Python包列表。

2. 项目启动文件介绍

`brother_ql_web.py`

这是项目的启动文件，负责启动Web服务并处理打印请求。以下是该文件的主要功能和命令行参数：

usage: brother_ql_web.py [-h] [--port PORT] [--loglevel LOGLEVEL] [--font-folder FONT_FOLDER]
                        [--default-label-size DEFAULT_LABEL_SIZE] [--default-orientation [standard|rotated]]
                        [--model [QL-500|QL-550|QL-560|QL-570|QL-580N|QL-650TD|QL-700|QL-710W|QL-720NW|QL-1050|QL-1060N]]
                        [printer]

printer: 指定打印机的字符串描述符，例如 tcp://192.168.0.23:9100 或 file:///dev/usb/lp0。
--port PORT: 指定Web服务的端口号，默认为8013。
--loglevel LOGLEVEL: 设置日志级别。
--font-folder FONT_FOLDER: 指定额外的字体文件夹。
--default-label-size DEFAULT_LABEL_SIZE: 设置默认的标签尺寸，默认为62。
--default-orientation [standard|rotated]: 设置标签的方向，默认为"standard"，设置为"rotated"时文本会旋转90°。
--model [QL-500|QL-550|QL-560|QL-570|QL-580N|QL-650TD|QL-700|QL-710W|QL-720NW|QL-1050|QL-1060N]: 指定打印机型号，默认为QL-500。

3. 项目配置文件介绍

`config_example.json`

这是一个配置文件示例，用户需要将其复制为 config.json 并根据实际需求进行调整。以下是配置文件的主要内容：

{
    "port": 8013,
    "loglevel": "info",
    "font_folder": "/path/to/fonts",
    "default_label_size": "62",
    "default_orientation": "standard",
    "model": "QL-500",
    "printer": "tcp://192.168.0.23:9100"
}

port: Web服务的端口号。
loglevel: 日志级别，可选值为 debug, info, warning, error, critical。
font_folder: 字体文件夹路径。
default_label_size: 默认标签尺寸。
default_orientation: 默认标签方向，可选值为 standard 或 rotated。
model: 打印机型号。
printer: 打印机的字符串描述符。