跳至内容
Hextra v0.12 发布啦!🎉 查看更新内容

图标

要在行内使用此短代码,需在配置中启用行内短代码功能:

hugo.yaml
enableInlineShortcodes: true

可用图标列表可在 data/icons.yaml 中找到。

示例

使用方法

{{< icon "github" >}}

默认支持 Heroicons v1 轮廓风格图标。

如何添加自定义图标

创建 data/icons.yaml 文件,按以下格式添加您的 SVG 图标:

data/icons.yaml
your-icon: <svg>您的图标 SVG 内容</svg>

随后即可通过短代码调用:

{{< icon "your-icon" >}}

{{< card icon="your-icon" >}}

提示:Iconify Design 是寻找网站 SVG 图标的优质资源平台。

远程图标包

远程图标可以通过提供商前缀按需加载。Hextra 支持以下提供商:

提供商示例图标
Lucide{{< icon "lucide:house" >}}
Tabler Icons{{< icon "tabler:user" >}}
Simple Icons{{< icon "simple:hugo" >}}Hugo

远程图标会在构建时获取。默认提供商固定到主版本,并从以下 CDN URL 加载:

lucide: "https://unpkg.com/lucide-static@1/icons/%s.svg"
tabler: "https://unpkg.com/@tabler/icons@3/icons/outline/%s.svg"
simple: "https://cdn.jsdelivr.net/npm/simple-icons@16/icons/%s.svg"

远程图标名称可用于 Hextra 中任何接受图标名称的位置,包括卡片、标签页、徽章、提示框和导航栏菜单项。

选项

范围描述
name图标名称
attributes图标的属性。
最后更新于