主题开发

FlatPaper 内置图标速查

2026-05-17 #主题#参考

更新版本:v0.3.4 - 2026-06-27

FlatPaper 主题采用内置的图标 Registry 系统,能够自动根据配置和模板文件按需提取并打包页面所用到的 SVG 图标。在 Hexo 生成时,只输出实际用到的 symbol,不加载外部图标 CDN。

对于主题配置(如菜单、个人资料社交链接),你可以使用任何匹配的内置图标(无前缀优先匹配 Lucide,Font Awesome Free 6 使用前缀,如 fa-brands:githubfa-solid:trash-can)。

默认内置经典图标一览

以下列出了主题默认必定打包的经典图标,你可以直接在主题配置或文章中通过名称调用。下方是该图标在 Registry 中的名称:

站点导航

home
archive
link
user
search
menu
panel-left
aperture
compass
users
radio
layout-grid

方向与关闭

arrow-left
arrow-right
chevron-left
chevron-right
close / x
arrow-up
chevron-down
chevron-up

时间与状态

sun
moon
palette
calendar
clock
history
flame

内容与归档

folder
tag
hash
leaf
eye
table-of-contents / list-tree

交互与通信

heart
message-circle
message-square
share-2
send
mail / email
gift
shuffle

订阅

rss
atom

品牌(描边风格)

githubtwitter 这类无前缀名称会优先从 Lucide 解析;如果需要指定 Font Awesome 品牌图标,可使用 fa-brands: 前缀。

github
twitter

品牌(填充风格 · Font Awesome)

新版 Twitter(X)以及其他常见平台来自内置 Font Awesome Free 6 品牌图标,使用 fill="currentColor"

x-twitter
steam
bilibili
youtube
facebook
instagram
telegram
weibo
alipay
weixin
paypal

如何在文章中使用

而在文章正文里(Markdown)使用时,最简单通用的方式依然是直接嵌入 <svg> 代码,把下方对应的 SVG 复制粘贴即可。

把对应图标的 <svg> 整段贴到 Markdown 里就行,颜色会跟随当前文字色(currentColor),大小可以修改 width / height

描边风格(Lucide)模板:

1
2
3
4
5
<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24"
fill="none" stroke="currentColor" stroke-width="1.8"
stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
<!-- 把对应图标的 <path>/<circle>/<line> 等子元素粘到这里 -->
</svg>

填充风格(Font Awesome / 品牌)模板:

1
2
3
4
<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24"
fill="currentColor" aria-hidden="true">
<!-- 品牌或填充风格的 path/circle 等元素 -->
</svg>

调整尺寸与颜色

  • 大小:改 <svg>width / height。也可以直接给容器 CSS 设 font-size,配合 width="1em"/height="1em" 跟随字号缩放。
  • 颜色stroke(描边)和 fill(填充)都设成了 currentColor,会自动跟随当前文字色。想强调时,包一层带 style="color: var(--green-deep)" 的容器即可。
  • 行内对齐:放在行内文字旁会基线偏移,可加 style="vertical-align: -2px"

想要使用更多图标?

得益于全新的内置 Registry 系统,你现在可以直接在配置文件中引入海量的第三方图标,而无需修改主题源码:

  • Lucide 图标:去 Lucide 官网 浏览,直接在配置中填写图标名字(如 bell, settings)。
  • Font Awesome 6 图标:去 Font Awesome Free 检索,加前缀填入配置中即可:
    • 品牌图标(Brands)前缀:fa-brands:(如 fa-brands:mastodon
    • 实心图标(Solid)前缀:fa-solid:(如 fa-solid:bell
    • 常规图标(Regular)前缀:fa-regular:(如 fa-regular:bell

若想在文章正文(Markdown)中使用更多图标,直接将官网的 SVG 代码复制粘贴进文章中即可。

评论
微信
支付宝
分享

评论