阅读前你需要了解这些内容:
- git
- MarkDown
使用 Hugo 搭建博客的步骤非常简单。
按照官网 Quick Start 即可快速创建一个站点。此文旨在对官方文档细节补充以及部署到自己的github上。
-
下载Hugo
-
解压出对应包中的Hugo.exe到一个空目录
-
将 2 中存放Hugo.exe的目录添加到系统变量"path"中。(不会设置?点这里)
-
进入Hugo官网 点击 Quick Start
-
当下载并设置好Hugo后,就可以直接从Step 2开始操作。
1
2
3
4
5
6
7
8# 这个 quickstart 请改成你想要的名字,最好对应你github上的名字且全小写
# 比如:untilthecore.github.io-generator
# 这个命令会生成 untilthecore.github.io-generator 的文件夹
# 这个文件夹就是博客站点的生成器,为了方便知道这个文件夹是干什么的,在最后加上 generator,当然 creator 也行
hugo new site quickstart
# 那么真正要输入的命令为
hugo new site untilthecore.github.io-generator -
当得到站点生成器文件夹后,使用
cd 命令进入文件夹并依次执行以下命令1
2
3
4
5
6# 为 untilthecore.github.io-generator 初始化 git 仓库
git init
# 为站点设置一个主题(这个主题可以修改)
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
# 向配置文件写入 theme = "ananke" 即配置 ananke 主题
echo 'theme = "ananke"' >> config.toml -
完成以上步骤站点就配置好了,输入以下命令即可创建第一篇博客了
hugo new posts/my-first-post.md -
通过以上步骤,站点已经创建好了,且写了一篇文章,赶紧通过这个命令启动本地服务器看看你的博客是什么样子吧。
hugo server -D -
基础完成了,接下来需要对站点进行一些设置,让它看起来更像是你自己的站点。找到
config.toml 文件,配置这些内容:1
2
3
4
5
6
7
8# 配置域,如果配置到了github上,这里要改为你自己github.io的地址。
baseURL = "https://example.org/"
# 配置语言 中文可以改为 "zh-Hans"
languageCode = "en-us"
# 站点标签名,浏览器标签上的内容
title = "My New Hugo Site"
# 主题设置,有新主题,就把主题名设置到这里
theme = "ananke" -
本地操作已经完成了,想要将站点部署到github或者自己的云服务器上,请继续阅读。
-
都配置好后,确保你控制台还处于博客生成器目录下(即"untilthecore.github.io-generator") 输入
hugo 在博客生成器目录下会产生一个’
public/ '的文件夹,将这个文件夹部署到服务器上就可以了。
如何在github上部署自己静态博客呢?
- 在github上创建一个仓库,仓库名为自己github名字的且以"
.github.io "结尾。(如:untilthecore.github.io) - 上面步骤 11 中的
public 文件夹还记得吗?首先在博客生成器目录中将它忽略git管理,即放入.gitignore 中。没有这个文件就创建一个这样的文件,内容保存 “/public/ ” 即可将此文件夹忽略; - 进入
public 文件夹中,初始化 git 并将这个文件夹上传到步骤1中创建的github仓库中; - 在浏览器中进入你自己仓库的
Settings 中,找到图片这个地方看看点击能不能看到博客呢?成功了,祝贺你!没成功,看看有没有哪一步错了?