跳转至
quickthumb
全部文档

渲染第一组卡片

先搭建一个节目卡片版式,并用三组不同内容分别渲染。 接着修改标题,制作出属于你自己的版本。

1. 安装 quickthumb

你需要 Python 3.11 或更高版本。在你的 Python 环境中执行:

python -m pip install quickthumb

如果需要先创建独立环境,请参考安装,配置完成后再返回此处。 本示例仅使用基础包及其内置字体:安装后无需下载字体、图片或可选渲染器。

2. 保存并运行版式代码

在 quickthumb 源码仓库之外的工作目录中,将以下代码保存为 episode_cards.py:

from quickthumb import Canvas, Stroke

INK = "#111111"
WHITE = "#FFFFFF"


def episode_card(episode, title, accent):
    return (
        Canvas(1280, 720)
        .background(color=INK)
        .shape("rectangle", position=(0, 0), width=1280, height=360, color=accent)
        # The numeral stands on the band and crops at the top edge.
        .text(
            str(episode),
            size=540,
            color=INK,
            # A stroke in the text color thickens the regular-weight built-in font.
            effects=[Stroke(width=8, color=INK)],
            position=(1240, 360),
            align=("right", "bottom"),
            letter_spacing=-10,
        )
        .text(
            "THE BUILDER'S\nNOTEBOOK",
            size=26,
            color=INK,
            effects=[Stroke(width=1, color=INK)],
            position=(48, 44),
            letter_spacing=1,
        )
        .text(
            "EPISODE",
            size=26,
            color=INK,
            effects=[Stroke(width=1, color=INK)],
            position=(48, 330),
            align=("left", "bottom"),
            letter_spacing=1,
        )
        .text(
            title,
            size=136,
            color=WHITE,
            effects=[Stroke(width=2, color=WHITE)],
            position=(48, 688),
            align=("left", "bottom"),
            max_width=1184,
            max_height=290,
            auto_scale=True,
            balance_lines=True,
            line_height=1.04,
        )
    )


episodes = [
    (12, "Ship your first release", "#FF4B1F"),
    (13, "Make room for better work", "#FFD400"),
    (14, "Build less. Finish more.", "#4D8DFF"),
]

for episode, title, accent in episodes:
    episode_card(episode, title, accent).render(f"episode-{episode}.png")

在同一目录下运行该脚本:

python episode_cards.py

打开同目录下的 episode-12.png、episode-13.png 和 episode-14.png。 每张图片尺寸均为 1280 × 720。脚本每次运行时都会写入这些文件名,并覆盖同名旧文件。

3. 制作下一张卡片

保持函数不变,在 episodes 列表中再追加一行:

(15, "Your next big idea", "#FF4B1F"),

再次运行脚本并打开 episode-15.png。你已成功复用同一个版式,生成了新的期数、标题和强调色。

标题会在 max_width 限制内自动换行。auto_scale=True 允许文字自动缩小以适应指定的宽度和高度。批量生成卡片前,建议先用实际可能出现的最长标题测试排版效果。

调整设计

在 episode_card() 函数内修改颜色、数字或标题字号以及位置,即可一次性更新所有卡片。图层会严格按照添加顺序依次绘制。 如果想使用自己的字体,可以在每次 .text() 调用中传入本地字体路径,例如 font="/path/to/your-font.ttf";如果字体本身字重足够,也可以移除 Stroke 描边效果。

扩展版式时,可使用 canvas.diagnose() 检查常见问题,如超出画布的图层或对比度过低。本示例故意裁切了数字,因此会报告一项 off-canvas 结果。有关检查项及其局限,请参阅诊断;诊断无告警并不等同于设计视觉效果出众。

选择后续方向