本文同步于个人博客 :
蝴蝶飞不过沧海 | Blog
本文链接
使用GitHub+hugo搭建静态个人博客
优点
全是静态文件,访问速度快
免费方便,不用花一分钱就可以搭建一个自由的个人博客,不需要服务器不需要后台
可以随意绑定自己的域名,不仔细看的话根本看不出来你的网站是基于github的
博客内容可以轻松打包、转移、发布到其它平台
准备工作
已注册并验证邮箱的GitHub账号
确保您已安装Git for Windows
您已下载合适版本的Hugo
![](https://js-cdn.icland.xyz/static/images/210213/2021-02-12%20222801.png)
创建仓库
新建一个名为<你的用户名>.github.io
的公开仓库,比如说,如果你的github用户名是test,那么你就新建test.github.io的仓库
必须是你的用户名,其它名称无效
必须是公开仓库,私有无效
你的网站访问地址就是 http://test.github.io
由此可见,每一个github账户最多只能创建一个这样可以直接使用域名访问的仓库。
几个注意的地方
注册的邮箱一定要验证,否则不会成功;
仓库名字必须是:username.github.io,其中username是你的用户名;
仓库创建成功不会立即生效,需要过一段时间,大概10-30分钟,或者更久
绑定域名
当然,你不绑定域名肯定也是可以的,就用默认的 xxx.github.io 来访问,如果你想更个性一点,想拥有一个属于自己的域名,那也是OK的。
首先你要注册一个域名,自己百度!
绑定域名分2种情况:带www和不带www的。
域名配置最常见有2种方式,CNAME和A记录,CNAME填写域名,A记录填写IP,
如果设置顶级域名,即不带www方式只能采用A记录,所以必须先ping一下你的用户名.github.io的IP,然后到你的域名DNS设置页,将A记录指向你ping出来的IP
将CNAME指向你的用户名.github.io
然后到你的github项目根目录新建一个名为CNAME的文件(无后缀),里面填写你的域名,例如
https://blog.icland.xyz/
另外说一句,在你绑定了新域名之后,原来的你的用户名.github.io就无法访问了,必须用你绑定的域名
![](https://js-cdn.icland.xyz/static/images/210213/2021-02-12%20230737.png)
配置文件夹及Git用户登录
新建一个你喜欢的目录
在该目录下右键打开Git bash here
输入以下命令
git config --global user.name "abcdef" # 你的github用户名,非昵称
git config --global user.email "xxx@qq.com" # 填写你的github注册邮箱
git init # 初始化目录
git clone https://github.com/skyxingcheng/skyxingcheng.github.io.git # 替换为你仓库的地址
git pull # 将仓库文件都拉到本地目录
配置Hugo初始化
解压你下载的hugo_0.80.0_Windows-64bit.zip得到hugo.exe
hugo version #通过检查版本号验证hugo是否运行正常
hugo new site ./ --force #强制在当前目录创建网站
你的文件目录结构就像这样
![](https://js-cdn.icland.xyz/static/images/210213/2021-02-12%20232427.png)
安装主题
git clone https://github.com/flysnow-org/maupassant-hugo.git themes/maupassant
在根目录下的 config.toml
文件中添加一行
echo theme = "maupassant">> config.toml # 启用主题
本地测试
创建一个示例文章
hugo new post/my-first-post.md
然后打开post/my-first-post.md
文件将draft: true
改为draft: false
# 该选项为草稿不可见
在下面几行随便写点东西
![](https://js-cdn.icland.xyz/static/images/210213/2021-02-13%20111959.png)
启动Hugo
hugo server
使用浏览器访问localhost:1313
即可打开本地预览
![](https://js-cdn.icland.xyz/static/images/210213/2021-02-13%20112251.png)
实战操作
执行命令编译网站
hugo -d skyxingcheng.github.io # 替换你自己的目录 该目录为Git项目名,在前面你已经clone到本地
执行命令上载到GitHub
cd skyxingcheng.github.io # 进入仓库目录
git pull # 拉回并更新本地文件
git add * # 添加本地文件
git commit -m "updates $(date)" # 添加上载信息
git push # 推送到GitHub
若绑定好域名则使用自定义域名访问反之使用<username>.github.io
访问
至此基本操作已完成
界面个性化和美化
未完待续
End For Page