新的标签插件语法
自 Volantis 6.6.0 起使用新的标签插件语法,代号 Stellar 语法。
为了兼容旧版本的插件,如果开发中存在冲突,新版标签的名称「开头首字母」统一设计成「大写」字母。
Volantis 6.6.0 起内置的标签组件和 Hexo 官方的一样使用空格分隔多个参数,所以如果参数内容中需要出现的空格被意外分隔开了的时候,请使用 代替。为了方便理解,本文档语法格式中的可选参数用方括号括起来,键值对参数用冒号分隔开,例如:
{% Image src [description] [download:bool/string] %} |
就表明第一个参数是图片链接,第二个参数是图片描述,而 download 是可选参数,并且值是布尔或字符串类型,第二三个参数为可选参数。
参数解析规则
以图片标签为例,使用空格分隔开之后得到一个数组,如果图片描述文字中有空格,多分出来的这些「参数」被合并到最后一个「非键值对参数」中,什么是「非键值对参数」呢?举个例子您就明白了:
{% Image https://gcore.jsdelivr.net/gh/cdn-x/wiki/stellar/photos/183e71e0ad995.jpg 来自印度的 Rohit Vohra 使用 iPhone 12 Pro Max 拍摄。 download:https://www.apple.com.cn/newsroom/images/product/iphone/lifestyle/Apple_ShotoniPhone-rohit_vohra_12172020.zip ratio:1960/1468 %} |
这个例子中,download:https://xxxx 是有冒号分隔开的,download 为键,后面的网址为值,所以叫做「键值对参数」;与此相对的,没有冒号分隔的就叫做「非键值对参数」。键值对参数可以放在任何位置,我可以通过匹配键来解析,而非键值对参数则只能通过顺序解析,所以它们必须和文档中要求的前后顺序一致。
一般核心的、重要的参数会设置成非键值对参数,而可选参数设置成键值对参数。
文本修饰标签集
最后更新于 6.6.0 版本
- 这是
高斯模糊 标签 - 这是
密码 标签 - 这是 下划线 标签
- 这是
着重号 标签 - 这是
波浪线 标签 - 这是
删除线标签 - 这是 上角标 标签
- 这是 下角标 标签
- 这是 键盘样式 标签,试一试:⌘ + D
- 这是 {% blur 高斯模糊 %} 标签 |
emoji
最后更新于 6.6.0 版本
内置了可配置的表情标签
使用方法如下:
{% emoji aini %} |
如果对高度有特别要求,可以指定高度,例如:
<center>{% emoji blobcat party height:1em %}{% emoji blobcat party height:2em %}{% emoji blobcat party height:3em %}{% emoji blobcat party height:2em %}{% emoji blobcat party height:1em %}</center> |
tag_plugins: |
在配置文件中,文件名用
{name}代替。
icon
最后更新于 6.6.0 版本
支持在任意位置插入图标,支持外链图标,也可以在 icons.yml 中提前配置好。
可以指定图标的颜色吗?
当然可以,还可以在主题配置中设置默认颜色:
icons.yml 中的图标:{% icon solar:planet-bold-duotone %} |
tag_plugins: |
还支持 style 参数,可以直接对样式进行修改,仅支持外链图标,style 参数中间不能有空格。
mark
最后更新于 6.7.0 版本
标记标签,支持多彩标记,包括:默认 红 橙 黄 绿 青 蓝 紫 亮 暗 警告 错误 一共 12 种颜色。
支持多彩标记,包括:{% mark 默认 %} {% mark 红 color:red %} {% mark 橙 color:orange %} {% mark 黄 color:yellow %} {% mark 绿 color:green %} {% mark 青 color:cyan %} {% mark 蓝 color:blue %} {% mark 紫 color:purple %} {% mark 亮 color:light %} {% mark 暗 color:dark %} {% mark 警告 color:warning %} {% mark 错误 color:error %} 一共 12 种颜色。 |
hashtag
最后更新于 6.7.0 版本
Volantis Hexo GitHub Gitea如果没有指定颜色,且没有设置默认颜色,则随机取一个颜色,快来试试吧~
{% hashtag Volantis https://volantis.js.org/ %} |
Image
最后更新于 6.7.0 版本
图片标签是一个精心设计的应对各种尺寸插图的标签,对于大图,可以放置一个「下载」按钮,语法格式如下:
{% Image src [description] [download:bool/string] [width:px] [padding:px] [bg:hex] [fancybox:bool/string] %} |
src: 图片地址 |
横向铺满的图片
无论在什么宽度的设备上都希望横向铺满的图片,一般不需要额外操作。可以在链接后面写上图片描述,如有必要,可以通过设置 download:true 使其显示一个「下载」按钮链接指向图片地址,如果下载链接与显示的图片地址不同,可以 download:下载链接 来使其能够下载原图。
{% Image https://unpkg.com/volantis-static@0.0.1761982841160/media/wallpaper/minimalist/2020/001.webp 这是图片描述 download:https://unpkg.com/volantis-static@0.0.1761982841160/media/wallpaper/minimalist/2020/001.webp ratio:1280/960 %} |
竖图(小图)优化
宽度较小而高度较大的图片,可以设置宽、高、填充间距、背景色等对其布局进行优化,使得它在不同宽度的屏幕下都能获得不错的视觉体验:
{% Image https://images.unsplash.com/photo-1625171515821-1870deb2743b?ixlib=rb-4.0.3&ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&auto=format&fit=crop&w=774&q=80 width:350px 这是图片的描述文字 ratio:720/1080 %} |
如果不进行约束,在宽屏设备上会占用很大篇幅
可以设置填充宽度和颜色,支持 bg:var(--background) 动态颜色,能够适配暗黑模式:

{% Image https://unpkg.com/volantis-static@0.0.1761982841160/media/wallpaper/minimalist/2020/004.webp bg:var(--background) padding:16px width:100px ratio:512/512 %} |
支持 Fancybox 插件点击放大
在任意 Image 标签中增加 fancybox:true 参数即可为特定图片开启缩放功能。如果一个页面没有任何地方使用,则不会加载 Fancybox 插件。
如果您希望全站所有的 Image 标签都开启此功能,可在主题配置文件中修改以下参数:
######## Tag Plugins ######## |
如果想在页面中展示较小的图片,但在 fancybox 中展示较大的高清的图片,可以用 fancybox:大图链接 参数。
blockquote
最后更新于 6.7.0 版本
段落引用,这个是标准写法 > 引用内容 的增强版本,适合不太强调的、大段落的引用。
这是使用 "> 引用" 写法的例子
这是使用 blockquote 标签的例子
> 这是使用 "> 引用" 写法的例子 |
本来这个叫 quote,但是发现文章显示不全,和 box 标签以前命名为 noteblock 时的表现一样,可能又命中了 hexo 某些隐藏彩蛋。
quot
最后更新于 6.7.0 版本
强调引用
适合居中且醒目的引用:
居中且醒目的引用
支持自定义引号:
热门话题
其中自定义引号素材在主题配置文件的 tag_plugins.quot 中配置:
tag_plugins: |
写法如下
适合居中且醒目的引用:{% quot 居中且醒目的引用 %} |
特别引用
此外,加上
el:h2/h3/h4/h5/h6可以作为标题使用
使用任意图标
您可以通过 prefix 或 suffix 参数设置任意图标或图片,支持 URL 或 icons.yml 文件中配置,例如:
这是一个 icons.yml 配置的示例
这是一个 url 的示例
写法如下
{% quot prefix:solar:planet-bold-duotone 这是一个 icons.yml 配置的示例 %} |
虽然丰富多彩的图标可以使其变得更醒目,但是滥用就会导致文章显得杂乱无章。
poetry
最后更新于 6.7.0 版本
诗词
莫笑农家腊酒浑,丰年留客足鸡豚。
山重水复疑无路,柳暗花明又一村。
箫鼓追随春社近,衣冠简朴古风存。
从今若许闲乘月,拄杖无时夜叩门。
{% poetry 游山西村 author:陆游 footer:诗词节选 %} |
paper
最后更新于 6.7.0 版本
纸张标签
出师表
先帝创业未半而中道崩殂,今天下三分,益州疲弊,此诚危急存亡之秋也。然侍卫之臣不懈于内,忠志之士忘身于外者,盖追先帝之殊遇,欲报之于陛下也。诚宜开张圣听,以光先帝遗德,恢弘志士之气,不宜妄自菲薄,引喻失义,以塞忠谏之路也。
后出师表
先帝深虑汉、贼不两立,王业不偏安,故托臣以讨贼也。以先帝之明,量臣之才,固知臣伐贼,才弱敌强也。然不伐贼,王业亦亡。惟坐而待亡,孰与伐之?是故托臣而弗疑也。
{% paper style:underline title:文言文 author:诸葛亮 date:三国 footer:节选 %} |
style: underline/无 # 是否带下划线 |
正文中可以设置行段落格式以显示不同的效果
<!-- section 小节标题 --> |
reel
最后更新于 6.7.0 版本
卷轴标签
时维九月,序属三秋。
潦水尽而寒潭清,烟光凝而暮山紫。
俨骖騑于上路,访风景于崇阿。
临帝子之长洲,得天人之旧馆。
层峦耸翠,上出重霄;
飞阁流丹,下临无地。
鹤汀凫渚,穷岛屿之萦回;
桂殿兰宫,即冈峦之体势。
{% reel 滕王阁序 author:王勃 date:重九日 footer:节选 %} |
title: # 标题 |
Link
最后更新于 6.8.0 版本
{% Link title url [icon:src] %} |
演示效果
上述示例的源码
{% Link 这是标题 https://volantis.js.org/ icon:https://unpkg.com/volantis-static@0.0.1761982841160/media/org.volantis/blog/Logo-NavBar@3x.png %} |
xlink
最后更新于 6.8.0 版本
链接卡片
外链卡片标签的语法格式为:
{% xlink href [title] [icon:src] [desc:true/false] %} |
参数含义:
href: 链接 |
不带摘要的样式: |
随着网站流量的增加,使用主题默认的 api 很可能会导致流量超限,推荐使用自部署的 api 抓取网站信息。参考下方仓库的 README 。
并在主题配置中填入你的 api
data_services: |
button
最后更新于 6.7.0 版本
按钮这个功能在 6.7.0 版本后开始支持。
文档 源码 示例{% button 探索 https://volantis.js.org/ icon:solar:planet-bold-duotone %} |
{% button text url [icon:key/src] [color:color] [size:xs] %} |
# 必填 |
okr
最后更新于 6.7.0 版本
目标管理,这是一个 OKR(Objectives and Key Results)示例:
来自2088年末的复盘:已《基本》实现目标 ![]()
- 当 KR 进度为 100% 时,标签默认显示为 已完成
- 当 KR 未设置进度时,默认为 0%
- 当 O 未设置进度时,则显示所有 KR 进度平均值
您可以在 _config.yml 文件中修改标签的颜色和文案
您可以在 _config.yml 文件中增加任意的标签配置
在咸水和海滩之间找一亩地
求出圆周率后15位
找出宇宙的终极逻辑
去地狱里走两步

写法如下:
{% okr o1 %} |
copy
最后更新于 6.8.0 版本
复制行
对于单行内容,可以使用 copy 标签来实现复制功能:
您可以设置 git:https 或者 git:ssh 或者 git:gh 来快速放置一个 git 仓库链接:
{% copy curl -s https://sh.xaox.cc/install | sh %} |
Radio
最后更新于 6.7.0 版本
单选
{% Radio 没有勾选的单选框 %} |
checked: true/false |
Checkbox
最后更新于 6.7.0 版本
复选
{% Checkbox 普通的没有勾选的复选框 %} |
checked: true/false |
Audio
最后更新于 6.7.0 版本
音频标签
支持音乐外链以及网易云音乐,网易云支持设置 type 以及 autoplay 参数。
{% Audio https://github.com/volantis-x/volantis-docs/releases/download/assets/Lumia1020.mp3 %} |
type: 2/0 # 歌曲/歌单 # 不设置默认为2歌曲模式 |
Video
最后更新于 6.7.0 版本
视频标签
支持 bilibili, youtube 和视频外链,可设置最大宽度, bili, yt 均可设置宽度和自动播放
{% Video bilibili:BV1GP4y1d729 %} |
width: 500px # 须带单位 80% 20em 100mm... |
目前 bilibili 的 iframe 标签不能放进 grid 容器里,原因未知。
chat
目前是半成品,处于不可用状态
最后更新于 6.8.0 版本
聊天标签
非常感谢 @且听风吟 开发了精美的聊天风格标签,并提供了详细的使用文档。内置qq和微信风格,可配单聊、群聊、user、设备等,支持文本、icon、图片、语音、视频、文件和链接。user可在chat_users.yaml中统一设置,也可在具体使用时单独设置。
示例
你好
你好
@且听风吟 Are U OK

你好
@且听风吟 Are U OK

@且听风吟 欢迎欢迎
这是一个图片
这是一个图片
@且听风吟 好哦
你好
Are U OK

你好
Are U OK

你好
Are U OK
你好

Are U OK
你好
欢迎欢迎

这是一个图片
好哦
这是一个图片
你好
Are U OK

你好
Are U OK

Frame
最后更新于 6.7.0 版本
设备框架
{% Frame iphone11 img:https://res.xaox.cc/gh/cdn-x/wiki@main/prohud/toast/demo-loading.png video:https://res.xaox.cc/gh/cdn-x/wiki@main/prohud/toast/demo-loading.mp4 focus:top %} |
Note
最后更新于 6.7.0 版本
备注块
{% Note [title] content [color:color] %} |
title: 标题(可选) |
具有标题的备注块
直接写备注内容,默认是和代码块一样的样式,第一个空格前面的是标题,后面的是正文,如果标题中需要显示空格,请使用 代替。
这是正文 哈哈。
{% Note 这 是标题 这是正文 哈哈。 %} |
彩色备注块
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
一共支持12种颜色,可以满足几乎所有的需求了
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 link
{% Note 一共支持12种颜色,可以满足几乎所有的需求了。 color 可设置 red、orange、amber、yellow、green、cyan、blue、purple、light、dark、warning、error 几种取值。 [link](/) %} |
box
最后更新于 6.7.0 版本
盒子容器 Note 标签就是使用 box 容器实现的,它们样式是相同的:
{% box [title] [color:color] [child:codeblock/tabs] %} |
这是标题
这是 box 内容
彩色代码块
设置 child:codeblock 并设置 color:颜色枚举 可以实现 10 种不同颜色的代码块,彩色代码块一般可以用在代码正确与错误的示范对比场景。
推荐的写法
func test() { |
不推荐的写法
func test() -> () { |
{% grid %} |
嵌套多段代码块
同一个 box 标签里面直接放多个代码块就可以啦:
+ (void)test { |
func setup() { |
{% box child:codeblock color:red %} |
嵌套其它标签
例如嵌套一个 Tabs 标签:
{% box child:tabs %} |
grid
最后更新于 6.7.0 版本
网格分区容器,支持固定列数、动态列数、设置间距和圆角。
动态列数
默认的布局为【最小宽度为240px】即如果页面宽度大于 480px 则会显示为 2 列,大于 720px 则会显示为 3 列,以此类推,下面是效果:
The Galactic Center is the rotational center of the Milky Way galaxy. Its central massive object is a supermassive black hole of about 4 million solar masses, which is called Sagittarius A*. Its mass is equal to four million suns. The center is located 25,800 light years away from Earth.
Ōwhiro Bay, Wellington, New Zealand
Published on May 31, 2022
SONY, ILCE-6000
Free to use under the Unsplash License
{% grid %} |
如果要修改最小宽度,可以这样写:
{% grid w:350px %} |
固定列数
如果要固定为 2 列,可以这样写:
{% grid c:2 %} |
背景样式
普通 Box 样式:
cell 1
cell 2
cell 3
cell 4
可浮起的卡片样式:
cell 1
cell 2
cell 3
cell 4
普通 Box 样式: |
设置间距
默认间距为 16px,如果需要修改,可以这样写:
{% grid bg:card gap:32px w:120px %} |
cell 1
cell 2
cell 3
cell 4
设置圆角半径
默认圆角半径等同于卡片的圆角半径,如果需要修改,可以这样写:
{% grid bg:card br:4px w:150px %} |
cell 1
cell 2
cell 3
cell 4
这里的 br 是 border-radius 的缩写,虽然和
<br>易混淆,但是我不知道是否有其他更好的命名,全称太长了。
Folding
最后更新于 6.7.0 版本
折叠容器,折叠块标签的语法格式为:
{% Folding title [codeblock:bool] [open:bool] [color:color] %} |
codeblock: true/false |
彩色可折叠代码块
备注标签相较于旧版进行了增强,可以实现更多种颜色,还可以通过设置 child:codeblock 来实现可折叠的代码块。以下是一个默认打开的代码折叠框:
默认打开的代码折叠框
func test() { |
代码如下:
{% Folding child:codeblock open:true color:yellow 默认打开的代码折叠框 %} |
危险,请不要打开这个
通过设置颜色,以实现更醒目的作用,但不要滥用色彩哦~
警告,真的很危险
通过设置颜色,以实现更醒目的作用,但不要滥用色彩哦~
最后一次警告,千万不要打开这个
不要说我们没有警告过你,Windows 10 不是為所有人設計,而是為每個人設計。
folders
最后更新于 6.7.0 版本
多个折叠容器聚合,样式相比 Folding 简单一些,适用于多个折叠标签平铺显示的场景,例如题目列表:
题目1
这是答案1
题目2
这是答案2
题目3
这是答案3
代码如下:
{% folders %} |
Tabs
最后更新于 6.6.0 版本
分栏容器,这个标签移植自 NexT 主题,但做了以下修改:
- 支持设置
align:center来使内容居中 - 设置默认激活的标签方式为
active:1而非, 1(使用默认格式降低学习成本,且显式声明可读性更强) - 不需要
<!-- endtab -->来作为结束标识(会自动判断) - 不需要
tabs id来保证唯一性(会设置唯一标识) - 不支持
@icon方式设置图标
演示效果

let x = 123 |
| a | b | c |
|---|---|---|
| a1 | b1 | c1 |
| a2 | b2 | c2 |
示例代码
{% Tabs active:2 align:center %} |
Gallery
最后更新于 6.7.0 版本
图库功能,其内部只能填写 md 格式的图片。
{% Gallery [layout:grid/flow] [size:mix/s/m/l/xl] [ratio:origin/square] %} |
{% Gallery %} |
swiper
最后更新于 6.3.0 版本
轮播容器,默认一张图片是 50% 宽度,通过设置 width:min 设置为 25% 宽度,width:max 设置为 100% 宽度。
{% swiper effect:cards %} |
{% swiper width:min/max %} |
{% swiper effect:cards/coverflow %} |
注意 一个页面只能设置一次,第一个 swiper 容器的效果全局生效。
navbar
最后更新于 6.8.0 版本
导航栏
文章内也可以插入一个导航栏:
{% navbar active:/wiki/ [文章](/) [项目](/wiki/) [留言](#comments) [GitHub](https://github.com/xaoxuu/) %} |
active 传入要高亮的那个按钮的 url
banner
最后更新于 6.8.0 版本
横幅容器
用于独立页面顶部
{% banner 随记 bg:https://res.xaox.cc/gh/cdn-x/xaoxuu@main/posts/20250706164631268.webp %} |
用于用户个人资料页
{% banner 某某 这是个人简介 avatar:https://res.xaox.cc/gh/cdn-x/xaoxuu@main/avatar/classic.webp bg:https://res.xaox.cc/gh/cdn-x/xaoxuu@main/posts/20250706163949681.webp %} |
用作文章摘要卡片
设置 link 可以让整个卡片响应点击事件,实现点击跳转到对应文章:
{% banner 博客进阶:自动化部署 本文讲了如何利用脚本和 GitHub Actions 简化博客搭建和部署流程,提高效率。 bg:https://res.xaox.cc/gh/cdn-x/xaoxuu@main/posts/20250706160404696.webp link:/blog/20221126/ %} |
Timeline
最后更新于 6.8.0 版本
时间线
支持静态和动态时间线数据源:
- 静态数据
- github issues 支持多种筛选参数,详见 API
- github releases 支持多种筛选参数,详见 API
- gitea issues 支持多种筛选参数,详见 API
- gitea releases 支持多种筛选参数,详见 API
- memos
- ...
常见的使用场景请看这篇文章:
静态时间线
静态数据是写死在 md 源文件中的,在 deploy 时就已经确定了。
主要部分功能已经开发的差不多了。

今天除夕,也是生日,一个人在外地过年+过生日,熬夜开发新主题,尽量在假期结束前放出公测版。
{% Timeline %} |
动态时间线
动态数据是从 GitHub Issues 中拉取的,使用方法为:
- 建一个仓库
- 创建一个
issue并添加一个label进行测试 - 写
Timeline标签时加上api:https://api.github.com/repos/your-name/your-repo/issues
例如:
{% Timeline api:https://api.github.com/repos/xaoxuu/blog-timeline/issues?direction=asc&per_page=3 %}{% endtimeline %} |
效果如下:
示例
- fork shaoyaoqian/WeiboSpider 的爬虫,修改自己的仓库名
- 修改
.github/workflows/main.yml中的微博ID为你想爬取的ID,修改完后每天会自动爬取你的微博,存储为 json 文件,输出文件在 output 分支
{% Timeline limit:20 type:weibo api:你的json文件地址 %}{% endTimeline %} |
静态 + 动态
用法同静态和动态单独使用时一样,例如:
{% Timeline reversed:true api:https://raw.github.xaox.cc/xaoxuu/ghapi-json-generator/refs/heads/output/v2/repos/xaoxuu/blog-timeline/issues%3Fper_page%3D5/data.json %} |
数据筛选
只显示某个人的数据
筛选最近3条todo
筛选评论最多的3条建议
上述示例代码如下:
{% folders %} |
更多用法详见:
albums
最后更新于 6.8.0 版本
专辑
配置数据源:
- title: 标题 |
文章中插入方式:
{% albums 分组名 %} |
posters
最后更新于 6.8.0 版本
海报
配置数据源:
- title: 标题 |
文章中插入方式:
{% posters 分组名 %} |
md
最后更新于 5.0 版本
在局部渲染外部md文件。
{% md https://gcore.jsdelivr.net/gh/volantis-x/hexo-theme-volantis/README.md %} |
md
site
最后更新于 6.2.0 版本
网站卡片标签
网站卡片可以显示网站截图、logo、标题、描述,使用方法和 友链标签 一模一样,唯一的区别是数据文件名称为 sites.yml,可以和友链数据混用,通过分组过滤实现不一样的效果。
{% sites [筛选方式]:[组名] %} |
演示效果
上述示例的源码
{% sites only:community_team %} |
可以支持的参数
数据按组筛选
支持分组(白名单模式和黑名单模式)显示:
// 显示 communtiy_team |
friends
最后更新于 6.2.0 版本
友链标签
您可以在任何位置插入友链,支持静态数据和动态数据,静态数据需要写在数据文件中:
volantis_developer: |
标题和描述都支持 md 格式,需要写在引号中。如果指定了 api 和 repo 字段,则从 issues 中取第一个 json 代码块数据作为友链。
{% friends %} |
数据按组筛选
友链支持分组(白名单模式和黑名单模式)显示:
// 显示 volantis_developer |
friends only:volantis_developer
实现动态友链
可以加载来自 issues 的友链数据,除了需要在 _data/friends.yml 中指定 api 和 repo 外,还需要做一下几件事:
从 xaoxuu/friends 作为模板克隆或者 fork 仓库,然后提交一个 issue 进行测试,不出意外的话,仓库中已经配置好了 issue 模板,只需要在模板中指定的位置填写信息就可以了。
提交完 issue 一分钟左右,如果仓库中出现了 output 分支提交,可以点击查看一下文件内容是否已经包含了刚刚提交的 issue 中的数据,如果包含,那么再次回到前端页面刷新就可以看到来自 issue 的友链数据了。
关于自建 Vercel API 如果您想使用自己的 api,请把您刚创建的仓库导入到 Vercel 项目,详见 小冰博客 的教程。
特别感谢小冰博客通过 Vercel 进行加速的方案,解决了原本直接请求 GitHub API 速度过慢的问题。
只显示动态数据
如果您不想创建 friends.yml 来设置任何静态数据,可以在标签中设置 api 来只显示动态数据:
{% friends api:https://raw.githubusercontent.com/volantis-x/examples/output/v2/data.json %} |
友链+文章
动态友链支持显示每个友链最新的N篇文章,并按文章更新顺序给友链排序,只需要增加 posts:true 参数:
{% friends posts:true api:https://raw.githubusercontent.com/volantis-x/friends-example/output/v2/data.json %} |




























