目录
Stack主题虽然自定义程度很高,但它并不像Fixit、Luna等主题那样自带很多短代码。
由于我对代码的掌握程度仅仅取决于我能不能在当中找到我认识的英语单词,Hugo官方文档里的自定义短代码教学对我来说基本等同于天书。
但这无法阻止我眼馋别人的各种花里胡哨小功能,我也成功在热心网友的分享下找到了不少可行的短代码,想着干脆做成合集,既方便后来的朋友抄作业,也能当作模板让我能一键查询自己搜集的短代码的写法。
这篇文章将会长期更新,如果以后我学会了更多的短代码,也会一并放在这里。
作业大合集
按照本人的惯例,在展示我的搜集成果前应当感谢各位乐于分享的赛博友邻们。
-
首先还是塔塔!短代码的部分主要参考了这两篇文章:Hugo|另一篇 Stack 主题装修记录,Hugo|在文章中插入轮播图片,再次感谢塔塔!
-
来写一些好玩的Hugo短代码吧 By吕楪,我最开始添加的短代码就是从她的博客里找到的,从那以后深刻体会到了短代码有多么好玩,遂开始努力收集……悄悄在她评论区留言也被温柔地回复了,好开心!
-
短代码测试 By咖喱,是在互联网上赛博赶海时偶遇的博主,因为在她博客里看到了很想要的Shortcodes,从别的主题照搬文件复刻又失败了,只好厚着脸皮留言问她写法,过了几天居然在邮箱里收到了打包好的源码文件——!有点小小的感动,从我开始搭博客以来,遇到的都是非常非常好的朋友们!
-
自定义Hugo Shortcodes简码 By一路向北,同样也是赛博赶海时偶遇到的博主,写的这篇教程简直比数学课本还简洁利落,好多都是我从没见过的新代码,值得收藏!
前置准备
没有什么特别的准备!但可以提前打开custom.scss
文件和layouts/shortcodes
文件夹。
文本样式类
重点标记
1.代码:
- 新建
mark.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
2.使用:好喜欢蓝色!
|
|
文本缩写
1.代码:
- 新建
abbr.html
,内容为:
|
|
2.使用:这个短代码只在电脑端生效
|
|
文本折叠
1.代码:
- 新建
detail.html
,内容为:
|
|
2.使用:
这是第一个段落的内容。 这是第二个段落的内容,位于折叠部分,实际使用别忘了双括号!叠叠乐
|
|
高斯模糊
1.代码:
- 在
custom.scss
中添加:
|
|
2.使用:一些手动打码效果!
但总之换行的话就加个空标签。
|
|
文本黑幕
1.代码:
- 在
custom.scss
中添加:
|
|
2.使用:数据删除!数据删除!
但总之换行的话就加个空标签。
|
|
文字抖动
1.代码:
- 新建
shake.html
,内容为:
|
|
2.使用:
|
|
文字渐变
1.代码:
- 在
custom.scss
中添加:
|
|
2.使用:
我挑的配色很好看吧!
好喜欢蓝色(再次)(再次)
但总之换行的话就加个空标签。
|
|
文本位置
1.代码:
- 新建
align.html
,内容为:
|
|
2.使用:
文字居左
文字居中
文字居右
|
|
摘录引用
1.代码:
- 新建
blockquote.html
,内容为:
|
|
2.使用:
“年复一年,创作的冲动随年衰减,创作的能力逐渐消失——也许两者根本上是一回事,我们常把自己的写作冲动误认为自己的写作才能,自以为要写就意味着会写。”
|
|
居中引用
1.代码:
- 新建
quote-center.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
2.使用:
左右两边的符号可以自定义
使用需要双括号
换行需要空标签
|
|
键盘样式
1.代码:
- 在
custom.scss
中添加:
|
|
2.使用:Ctrl+Alt+Del
|
|
评分样式
1.代码:
- 新建
rating.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
2.使用:
|
|
卡片样式
1.代码:
- 新建
card.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
2.使用:
好像不能插入图片?
换行需要空标签。实际使用需要双括号。
|
|
仿Github样式
1.代码:
- 新建
github.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
- 在
data/SVG.toml
中加入图标(给出的代码是Github自己的图标,我已经换成了自定义的):
|
|
2.使用:这样是不是就能伪装成卡片式链接啦!
|
|
标签块样式
1.代码:
- 新建
notice.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
- 在
data/SVG.toml
中添加:
|
|
2.使用:
Warning:就像打开浏览器的开发者工具发现网站在报错。
info:咦,这是什么,点开看看!咦,这是什么,点开看看!咦,这是什么,点开看看!
note:可以标注一下,但是没必要。
tip:在示例里胡说八道会使观看者会心一笑。
|
|
对话框
1.代码:
- 新建
message.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
2.使用:
|
|
时间轴
1.代码:
- 新建
timeline.html
,内容为:
|
|
2.使用:
|
|
插入外链类
图片轮播
1.代码:
- 新建
imgloop.html
,内容为:
|
|
- 在
custom.scss
中添加:
|
|
- 在
config.yaml
找到params:
,添加enableimgloop: true
。
2.使用:
|
|
瀑布流相册
1.代码:
- 新建
gallery.html
,内容为:
|
|
- 在layouts/partials/footer/custom.html中插入:
|
|
- 在/layouts/partials/head/custom.html中插入:
|
|
2.使用:
|
|
多图排版
提示:不支持webp格式的文件!
1.代码:
- 在
custom.scss
中添加:
|
|
2.使用:
|
|
PDF/PPT插入
1.代码:
- 新建
pdf.html
,内容为:
|
|
2.使用:在手机端上好像看不见,不过在电脑上浏览效果还不错!
|
|
网易云音乐
1.代码:
- 新建
netease.html
,内容为:
|
|
2.使用:
|
|
Spotify
1.代码:
- 新建
spotify.html
,内容为:
|
|
2.使用:这是一个spotify的音乐模块,但是在中国大陆无法直连访问(本地测试也不行)。
|
|
哔哩哔哩(2024.05.21更新)
1.代码:
- 新建
bilibili.html
,内容为:
|
|
2.使用:夹带一点私货,来看岚少!
|
|
引用长毛象嘟文
1.代码:
- 新建
mastodon.html
,内容为:
|
|
2.使用:
|
|
引用NeoDB条目(2024.6.7再更新:罪魁祸首是墙)
之前遇到插入NeoDB短代码的文章让hugo server指令固定报错的问题,当时看描述是说问题出在因为shortcode loop导致timeout,我在config里新设置了100000ms的上限,强行等它loop完后启动本地预览,文章里显示的报错就变成了API错误。这也是为什么我因此认定是API出了问题,但今天看到这位朋友的博客,才意识到原来罪魁祸首是GFW。
总之令人纠结的事情似乎就这样告一段落了!目前在国内的朋友可以无视本地错误直接把代码上传,看生成的实际网页能否正常加载;如果还是希望启动本地预览,则可以在config.yaml
里增加(教程来自这篇博客):
|
|
这样稍微等Hugo自己跑一会儿就可以看到本地预览啦!
1.代码:
- 新建
neodb.html
,内容为:
|
|
- css样式:
|
|
2.使用:
|
|
手动输入NeoDB条目
教程来自爱海的热心援助,非常感谢她!
1.代码:
- 新建
book.html
,内容为:
|
|
- CSS:同NeoDB代码
2.使用
rate
一栏只能是1-10的整数,简介无法换行,tag
可以自由填写,例如book、movie、game等。
|
|