最近重新开始使用 Emacs 和 org-mode ,就又有了继续写一点博客的想法。看到有直接 org-mode 写好博客直接发布的方法,经过各方查找,使用 HUGO 来生成静态博客, Emacs 上用 ox-hugo 配合。这里就来讲一下 Hugo 的安装和使用。

安装

可根据官方链接来查看多种安装方法,我在 Windows10 上使用 Scoop 安装。 有两个版本可以选择: hugo 和 hugo-extended ,推荐安装 extended 版本。

1
scoop install hugo-extended

新建站点

1
hugo new site mysite

当前目录下会生成一个新的文件夹 mysite ,文件初始内容如下:

1
2
3
4
5
6
7
├── archetypes/
├── config.toml
├── content/   # 储存网站的所有文章内容
├── data/
├── layouts/   # 全局样式,优先级高于主题下的 layouts 文件夹
├── static/    # 静态文件,优先级高于主题下的 static 文件夹
└── themes/    # 主题目录

安装主题

可以在官方 HUGO 主题列表选择一个,然后在 themes 下把你要的皮肤 git clone 下来,我选择了 even

1
2
cd themes
git clone https://github.com/olOwOlo/hugo-theme-even even

根据 even 官方文档适当按自己的需要作出修改。

生成静态网站文件

在 mysite 根目录下运行 hugo ,默认会保存到 public 目录。

启动实时本地预览

1
hugo server -D

新建页面和文章

这一块内容暂时不写,因为我是通过 ox-hugo 将 org 文件自动生成 hugo 可用的 markdown 文件,这一块下次在 ox-hugo 里面说明。