简单记录一下博客的搭建历程

hugo不完全食用指南

很早就想弄一个博客，但碍于嫌麻烦且没有看得上眼的主题就一直没弄。

最近看到了FixIt（LoveIt的一个分支）挺对我的口味的，期中估计还要一段时间，时间充足，直接冲了。

博客用的是Hugo，主题FixIt。新博文目前还是手动上传，后续会弄github联动。

LoveIt的分支还有很多，比如DoIt等，但FixIt的文档比DoIt看着舒服各种意义上，且有轻量加密功能。最终选了FixIt。

本文中环境为VPS->Nginx->Hugo，主题FixIt。

一些可能的坑

• 主题部分功能需要用到加强版，需要安装hugo-enhanced
• nginx中映射目录应为/xxx/blog/public
• menu的path需要跟页面的md名称对应。比如friends.md的path是/friends/

常用命令备忘

• 生成静态内容 hugo
• 创建新页面 hugo new +路径
• 测试服务器 hugo server --bind 0.0.0.0

配置文件

默认为博客目录下的config.toml

先用这份配置，然后随便写个hello-world看看能不能正常渲染。

然后参见官方文档一点一点调就行了。

修改模板

每次new一个新博文出来的时候参照的模板就是/blog/archetypes/default.md

可以参照这里的模板，修改这里的内容。

其实全抄下来也行

shortcode 备忘

各种类型的伸缩格

下面的例子中的大括号和尖括号为了不被识别为特殊格式做了转义，实际应用不需要。

1
2
3
4
5
6
7

\{\{\< admonition tip "This is a tip" true \>\}\}

some text

tip can be replaced with [note,abstract,info,tip,success,question,warning,failure,danger,bug,example,quote]

\{\{\< /admonition \>\}\}

todo: Github 联动/自动化

碎碎念

其实一开始用的是hexo和next主题，但后来觉得太单调就又换了hugo和DoIt，然后DoIt的文档好像搭在cloudflare pages上然后打不开，只能用wayback machine，还都是英文（当时没看到github里的示例站点）。然后网上冲浪的时候又看到了这个FixIt。

就emm，幸好后来看到的两个东西是同族的，要不然真的要吐血了。

其实nginx也有点问题，本来想直接在nginx层做http 301 to https的，但会报重定向次数过多，可能是我写配置文件写的有问题吧[捂脸]。反正前面是cloudflare会帮我做https，回源流量做不做也无所谓吧，嘛~