该标签会去拿到某个repo仓库的issue内容,用sites标签
的形式显示出来,可以用做网站的友链
功能
该标签和issues-timeline
标签都适用于github
和gitee
使用方法
issue里面需要有JSON代码块:
1 | { |
Github写法
1 | {% issues sites | api=https://api.github.com/repos/yuang01/friends/issues?sort=updated&state=open&page=1&per_page=100&labels=active %} |
Gitee写法
1 | {% issues sites | api=https://gitee.com/api/v5/repos/yuang01/friends/issues?sort=updated&state=open&page=1&per_page=100&labels=active %} |
yuang01
: 用户名,friends
: 仓库名
上例中的 labels=active
参数可以控制默认的 issue 不显示,只有自己审核通过添加了 active
标签之后才会显示。上述示例对应的仓库链接:
效果(Github example)
效果(Gitee example)
分组显示
sites 类型的 issues 默认不分组,如果需要分组,可指定分组依据「key」,和分组白名单「value1」「value2」等,例如:
1 | group=version:v4,v3,v2 |
这个参数的作用就是,筛选出 JSON 中包含 "version": "v4"
或者 "version": "v3"
或者 "version": "v2"
的数据,并分组显示。
分组写法
1 | {% issues sites | api=https://api.github.com/repos/yuang01/examples/issues?sort=updated&state=open&page=1&per_page=100 | group=version:版本:v3.0,版本:v2.0,版本:v1.0 %} |
比较长,鼠标往后拖
分组示例对应的仓库链接: