Featured image of post Hugo建站笔记

Hugo建站笔记

记录一下本站的搭建过程~

安装hugo

macOS下可以使用brew安装, debian系就用apt吧

brew install hugo

基础配置

新建hugo站点

使用hugo的cli命令新建站点

hugo new site myblog

安装主题

这里使用的是Stack主题

cd myblog
git init
git submodule add https://github.com/CaiJimmy/hugo-theme-stack.git themes/hugo-theme-stack

然后编辑根目录下的hugo.toml添加主题配置:

theme = "hugo-theme-stack"

设置语言

hugo.toml里设置语言为中文,同时改一下站点名称

defaultContentLanguage = "zh-cn"
title = "我的博客"

Stack主题配置

[params]
mainSections = [ "posts" ]

[params.sidebar.avatar]
src = "img/avatar.jpg"

[[params.widgets.page]]
type = "toc"

在页面展示目录的widget一开始不知道为啥一直展示不出来,添加了以下配置就好了

[markup.tableOfContents]
endLevel = 4
ordered = true
startLevel = 1

写文章

新建文章

hugo new posts/setting-up-hugo/index.md

dev环境查看

以上生成的文章是草稿状态,可以在本地启动hugo server默认是看不到的,需要添加参数

hugo server -D --navigateToChanged

--navigateToChanged参数是为了保存文章后让浏览器自动跳转到修改的文章

部署

Cloudflare Pages

我使用了Cloudflare Pages来部署,可以看官方文档就很详细了

配置自定义域名

部署完之后在应用下的Custom domains里配置一下自定义域名,然后按照说明去到DNS配置里加一下CNAME记录就好了