短代码
Hugo Narrow 可以直接使用 Hugo 内置的短代码模板,包括:
- Figure
- Vimeo
- YouTube
- ...
你可以访问Hugo 文档获取更多内置短代码。
此外还添加了两个短代码:
- Bilibili
- Tencent Video
短代码来自 Hugo Stack。
内置短代码
Figure
{{< figure
src="/images/examples/zion-national-park.jpg"
alt="A photograph of Zion National Park"
link="https://www.nps.gov/zion/index.htm"
caption="Zion National Park"
class="ma0 w-75"
>}}
Vimeo
展示 Vimeo 视频:
https://vimeo.com/channels/staffpicks/55073825
{{< vimeo 55073825 >}}
YouTube
展示 YouTube 视频:
https://www.youtube.com/watch?v=0RKpf3rK57I
{{< youtube 0RKpf3rK57I >}}
主题短代码
Bilibili
完整的参数如下:
{{< bilibili VIDEO_ID PART_NUMBER >}}
同时支持 AV 号和 BV 号,其中 PART_NUMBER 是可选参数,指定后展示对应分集。
展示 Bilibili 视频:
https://www.bilibili.com/video/BV1GJ411x7h7/
{{< bilibili BV1GJ411x7h7 >}}
Tencent Video
参数如下:
{{< tencent VIDEO_ID >}}
展示腾讯视频:
https://v.qq.com/x/cover/aav44xv50k8sfjb/o01836xm9bv.html
{{< tencent o01836xm9bv >}}
Masonry 布局图库
瀑布流布局图库:
markdown
{{< masonry columns=4 gutter=15 >}}


{{< /masonry >}}
链接
链接卡片支持三种方式调用。
- 直接使用参数。
markdown
{{< link title="Google" description="世界上最大的搜索引擎。" url="https://google.com" icon="https://google.com/favicon.ico" >}}
- 使用
data/links.yaml
文件中id/ref
参数。
markdown
{{< link id="github" >}}
{{< link ref="github" >}}
- 使用
data/links.yaml
文件中group/category
参数。
markdown
{{< link group="social" >}}
{{< link category="social" >}}
NOTE
icon
参数不是必须的, 如果未指定值, 模板会寻找链接的 favicon 文件(.svg/.ico), 如果仍未找到可用的值, 会回退到 assets目录下的 link.svg
文件.
自定义短代码
在 ~/layout/_shortcodes
目录下添加你的短代码模板,如果使用 Tailwind CSS,需要在本地编译样式应用到主题,本地编译详细方式见自定义样式