Hugo+Github搭建个人博客

SMJ
•
#hugo
• loading... read

安装Git

  1. 在这个页面下载最新版的Git。
  2. 然后按照wizard指引安装Git。
  3. 配置环境变量
graph LR
a[control panel] --> b[System and Security]
b[System and Security] --> c[System]
c[System] --> d[Advanced system settings]
d[Advanced system settings] --> e[ENvirment Variables..]
e[ENvirment Variables..] --> f[select Path then Edit]
f[select Path then Edit] --> g[add git path]
g[add git path] --> Done!

创建GitHub账号

这个自行百度 or Google

安装Hugo

  1. 从Hugo Releases下载Hugo压缩包(记得注意系统位数是32 or 64)
  2. 解压压缩包
  3. 配置环境变量(同上)

当然还有其他方法，这边就暂时不介绍了，有兴趣的同学可以参考这里.

配置Hugo

创建网站

使用hugo new site sitename命令来创建一个网站模板
模板包含下面这些文件

    ├── archetypes
    ├── content
    ├── data
    ├── layouts
    ├── static
    ├── themes
    └── config.toml

安装主题

  1. 在这个Hugo 主题页面找一个喜欢的主题下载并安装。
  2. 下载的应该是一个压缩包，把它解压到themes这个文件夹里面。
  3. 接下来就是配置网站了，在上面我们可以发现有一个名为config.toml的文件，所以我们只要编辑这个文件就可以配置我们的网站了。

我们上面只是下载解压了那个主题文件夹，并没有把它加载到我们的创建的网站上，所以这个时候我们只要在config.toml这个文件里添加一行themes = "theme_name"就搞定了。
主题也安装好了，接下来就可以试试效果了：

  1. 我们在content文件夹里面新建一个文件夹，命名为post(一定要是这个名字哦，这个是默认的，如果要用其他名字，还需要在*config文件里面添加一行代码，这里暂时不做讨论了)
  2. 在网站根目录(即: ./sitename下)打开命令行(win+R,然后输入cmd), 输入hugo server -t theme_name
  3. 我们打开(http://localhost:1313)就可以看到了! 这个时候我们会发现多了一个public文件夹，这个文件夹包含了我们生成的网页内容
    当然，这个时候才刚刚完成了一半，因为现在只有我们自己可以看到这个网页，别人是看不到的。所以，这个时候我们就要把它部署到服务器上了，服务器可以有好多选择，这里就只讨论Github pages了，毕竟是免费还不限流量的嘛！

在Github Pages上部署

创建 GitHub pages

这个可以参考官方教程，就不赘述了，有疑问的同学可以私信我。

在Github上托管

  1. 在 GitHub 上创建 your-project-name 代码仓库（它将用于托管 Hugo 的内容）
  2. 在 GitHub 上创建 username.github.io 代码仓库（它将用于托管 public 文件夹：静态的网站）
  3. git clone <your-project-name-url> && cd <your-project-name>
  4. 使用hugo new site sitename来创建网站，在<your-project-name>目录下。
  5. 让你的网站在本地生效，输入hugo server -t theme_name
  6. 看到效果后，我们这时候需要把public这个文件夹删除了
  7. git submodule add git@github.com:<username>/<username>.github.io.git public (这里又生成一个public文件夹，这就是我们的网页文件)
  8. 最后，我们添加一个脚本(deploy.sh)来帮我们简化操作
#!/bin/bash

echo -e "\033[0;32mDeploying updates to GitHub...\033[0m"

# Build the project.
hugo # if using a theme, replace by `hugo -t <yourtheme>`

# Go To Public folder
cd public
# Add changes to git.
git add -A

# Commit changes.
msg="rebuilding site `date`"
if [ $# -eq 1 ]
  then msg="$1"
fi
git commit -m "$msg"

# Push source and build repos.
git push origin master

# Come Back
cd ..

到这里我们的个人网站就建成了！！！ 让我们马上看看效果吧(http://username.github.io/), 可能会有些延迟哦，要有耐心。

❦

Sooner or later, everything ends.