使用Hugo在GitHub上搭建个人博客初步

准备工作（使用win10 64位系统）

1. 安装Git for Windows

2. 安装Hugo二进制版
下载Hugo Windows 64位版压缩包，解压，将包含hugo.exe的目录添加到path变量，打开Git Bash，执行

hugo version

结果显示如下表示Hugo安装成功

3. 创建GitHub仓库
在你的GitHub（免费申请账户）创建两个仓库，一个名为username.github.io（username是你的账户名）仓库用来发布Hugo生成的博客，一个名为blog（或其他名字）用来保存Hugo站点工程文件（如果只想本地保存Hugo工程，则无需创建blog仓库）。

4. 设置Git与GitHub连接（略)

第一步 创建Hugo站点

在Git Bash中，cd进入你想保存站点文件夹的路径（我这里是D盘），执行

hugo new site blog

Hugo会生成一个名为blog的站点工程文件夹，如图

简要说明：content文件夹里放文章，themes文件夹里放主题，config.toml为站点设置文件

第二步 添加主题

在Hugo主题网站上选择一款你喜欢主题，这里我选择Beautiful Hugo，在Git Bash中，进入themes目录，执行

git clone https://github.com/halogenica/beautifulhugo.git beautifulhugo

此时themes文件夹下就多了一个beautifulhugo文件夹，或者到主题的github主页下载zip包解压到themes文件夹，注意把文件夹名字-master去掉。要想快速设置成beautifulhugo主题，可以用blog\themes\beautifulhugo\exampleSite\config.toml替换掉blog\config.toml，再修改其中两个参数，baseurl为要发布的Github网址，一般为https://username.github.io，title为博客的名字

第三步 写一篇测试博文

在Git Bash中，blog目录下，执行

hugo new posts/test.md

在content\posts文件夹多了一个test.md文件，使用markdown编辑器（我用的是Typora）加上一行文字

#### 这是第一篇文章

第四步 本地服务器测试

在Git Bash中，blog目录下，执行

hugo server -D

在浏览器中打开http://localhost:1313/即可看到博客网站

此时，对文章或网站设置所做的修改都可以即时在浏览器里看到，Ctrl+c停止Hugo服务器。

第五步 发布到Github

在Git Bash中，blog目录下，执行

hugo -D

生成网站，默认在blog\public文件夹，我们需要把public文件夹内容推送到username.github.io仓库，同时希望把Hugo工程文件夹也同步到远程仓库，两个仓库最好分开在两个文件夹，为此，新建一个名为GitHubRepo的文件夹，进入GitHubRepo目录，执行

git clone https://github.com/weihuan/blog.git
git clone https://github.com/weihuan/weihuan.github.io.git public

把远端的两个仓库克隆到GitHubRepo文件夹，因为远端仓库里什么也没有，所以得到的是blog和public两个空仓库，把原D:\blog工程文件夹下的所有文件复制到GitHubRepo\blog仓库，并删掉其中的public文件夹，此时D:\blog可以删除掉。要把生成的网站放到GitHubRepo\public仓库，需要编辑config.toml更改发布的路径，加入一行

publishDir = "../public"

为了能让生成网站、推送到GitHub仓库一气呵成，我们可以写一个脚本来执行这些操作，在GitHubRepo\blog创建一个deploy.sh文件，写入以下shell脚本并保存

#!/bin/sh

# If a command fails then the deploy stops
set -e

printf "\033[0;32mDeploying updates to GitHub...\033[0m\n"

# Build the project.
hugo -D # if using a theme, replace with `hugo -t <YOURTHEME>`

# Go To Public folder
cd ../public

# Add changes to git.
git add .

# Commit changes.
msg="rebuilding site $(date)"
if [ -n "$*" ]; then
    msg="$*"
fi
git commit -m "$msg"

# Push source and build repos.
git push origin master

在Git Bash中，blog目录下执行

chmod +x deploy.sh

把deplay.sh设置为可执行，然后执行

./deploy.sh

脚本执行完成后，稍后可在https://username.github.io中看到你的博客主页，若想保存Hugo工程文件到Github仓库，进入blog目录，执行

git add .
git commit -m "这里写一些提交信息"
git push origin master

至此，一个用Hugo生成的空博客就在GitHub上安家了，接下来也是更重要的是增添内容了。当然，Hugo还有很多设置，我就浅尝辄止了。

参考页面

https://gohugo.io/getting-started/quick-start/

https://gohugo.io/hosting-and-deployment/hosting-on-github/