hugo-cmpt-tmdb：给 Hugo 文章加一张影视卡片

hugo-cmpt-tmdb 是一个 Hugo 影视卡片组件，用一行短代码即可展示电影、电视剧资料和个人评分。

因为直接爬取豆瓣会被限流，又没有可用的 API，只能用 TMDB 了 🥲

能做什么

按 TMDB ID 获取海报、片名、年份、类型、简介、演职员和 TMDB 评分。

资料和海报在构建时获取并缓存，浏览时只加载本站图片和 CSS，无需额外的 JavaScript。支持 FixIt v1 的深浅色和手机布局。

封面是本站《沙尘暴》：王良对家的执念，刘盈盈的困局与反抗中的卡片截图。

如何接入

组件需要 Hugo 0.166.0 或更新版本。在站点根目录添加子模块：

1

git submodule add https://github.com/yuehei/hugo-cmpt-tmdb.git themes/hugo-cmpt-tmdb

以 FixIt 为例，在 Hugo 配置中追加组件和样式入口，保留列表中的已有项：

1
2
3
4

theme = ["FixIt", "hugo-cmpt-tmdb"]

[params.custom_partials]
head = ["inject/tmdb.html"]

使用 API 需配置自己的 TMDB 凭据；仅使用本地资料时无需凭据。

在文章中使用

插入《沙尘暴》，个人评分为 9.1：

1

{{< tmdb type="tv" id="272100" personal_rating=9.1 >}}

type 填 tv（电视剧）或 movie（电影），id 填 TMDB 条目 ID。personal_rating 为可选的个人评分，范围是 0～10。

默认优先读取本地资料，缺少可用条目时再调用 API；本地字段可覆盖远程资料。完整配置见项目 README。