Hugo 是由 Go 语言实现的静态网站生成器。简单、易用、高效、易扩展、快速部署。
根据官网的一些文档及网上的教程,尝试用 Hugo 搭建一个静态的博客站点。下面的操作在 win10 64 位家庭版中完成。bash 命令在 git bash 中操作。
安装
在 Hugo Releases 页面下载了最新的 v0.36 win64 位压缩包,解压后将其添加到环境变量中。
生成站点
使用 Hugo 快速生成站点:
1 | hugo new site test |
config.toml
是网站的配置文件,包括 baseurl
, title
, copyright
等等网站参数。
这几个文件夹的作用分别是:
- archetypes:包括内容类型,在创建新内容时自动生成内容的配置
- content:包括网站内容,全部使用markdown格式
- data:存放 Hugo 生成网站时的配置文件
- layouts:包括了网站的模版,决定内容如何呈现
- static:包括了css, js, fonts, media等,决定网站的外观
- themes:主题
添加主题
按照一般方法这一步应该添加主题,然后添加文章,然后就可以预览站点了。
这里选用了 Academic 这一主题。这是一个适合做个人简历的主题(学院风格)。按照它的方式进行安装,跳过了初始化网站的过程,直接从 git 上克隆一个版本过来。
1 | git clone https://github.com/sourcethemes/academic-kickstart.git hugo |
配置
修改一下网站的顶层配置文件,进行相应的配置。
1 | # Configuration of Academic |
本地预览
1 | hugo server |
部署
先在 git 上建立了一个空的 repo,名字为 YiweiNiu.github.io
。
在站点根目录执行 Hugo 命令生成最终页面:
1 | hugo --theme=academic --baseUrl="https://yiweiniu.github.io/" |
(注意,以上命令并不会生成草稿页面,如果未生成任何文章,请去掉文章头部的 draft=true
再重新生成。)
所有静态页面都会生成到 public
目录,将 pubilc 目录里所有文件 push
到刚创建的 Repository 的 master
分支。
1 | cd public |
浏览器里访问:https://yiweiniu.github.io/
即可查看。
日常使用
更新 hugo
到 hugo
的 releases 页面下载最新的安装包。
更新主题
1 | Display available updates to Academic. |
更新内容
1 | 生成新的 |