跳转到主要内容

一个简单的css精灵生成器。

项目描述

一个简单的css精灵生成器。

  • 自由软件:BSD 2-Clause许可

安装

pip install css-sprite

您还可以使用以下命令安装开发版本

pip install https://github.com/ionelmc/python-css-sprite/archive/main.zip

用法

从图像生成css精灵

css-sprite [-h] [--grid GRID] --output OUTPUT
    [--mode MODE] [--vertical] [--background BACKGROUND]
    [--template TEMPLATE | --template-path TEMPLATE_PATH]
    [--verbose] [--version] image [image ...]

输出主要是新图像,但您也可以生成相应的css。

位置参数

image 包含在精灵中的图像的路径。

选项
-h, --help

显示此帮助信息并退出

--grid GRID, -g GRID

要使用的网格单元格大小。以下之一:auto, X:Y。

--output OUTPUT, -o OUTPUT

输出文件。

--mode MODE, -m MODE

强制在输出中使用特定图像模式,请参阅:https://pillow.pythonlang.cn/en/latest/handbook/concepts.html#modes

--vertical, -v

垂直堆叠图像(默认情况下是水平堆叠)。

--background 背景色-b 背景色

背景颜色。

--template 模板-t 模板

在标准输出上输出CSS的Jinja模板。

--template-path 模板路径-p 模板路径

在标准输出上输出CSS的Jinja模板路径。

--verbose

使输出详细。

--version

显示程序版本号并退出。

模板变量

  • images - 字段列表的字典

    • index - 从1开始的计数器

    • index0 - 从0开始的计数器

    • filename - 源图像的路径

    • offset - 包含字段的字典(整数)

    • position - 包含字段的字典(整数)

    • width - 整数(目前与cell.width相同)

    • height - 整数(目前与cell.height相同)

  • grid - 包含字段的字典

    • width - 整数

    • height - 整数

    • vertical - 布尔值(如果你使用了--vertical,则为True)

  • cell - 包含字段的字典

    • count - 输入图像的数量

    • width - 整数

    • height - 整数

  • output - 输出文件的pathlib.Path

文档

https://python-css-sprite.readthedocs.io/

开发

要运行所有测试,请运行

tox

注意,要合并所有tox环境中的覆盖率数据,请运行

Windows

set PYTEST_ADDOPTS=--cov-append
tox

其他

PYTEST_ADDOPTS=--cov-append tox

变更日志

0.2.0 (2022-05-06)

  • 通过使用alpha合成允许图像重叠。当单元格小于图像且图像为透明时很有用。

  • 重构模板上下文。向后不兼容

0.1.1 (2022-04-18)

  • 删除了通用标志(由于py2不支持,因此不生成py2.py3 wheels)。

0.1.0 (2022-04-18)

  • 首次发布在PyPI。

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

css-sprite-0.2.0.tar.gz (19.2 kB 查看哈希值)

上传时间

构建分布

css_sprite-0.2.0-py3-none-any.whl (6.8 kB 查看哈希值)

上传时间 Python 3

由以下支持