Hugo 安装与部署

本文中 Hugo 的安装环境为 Windows 10 ，并使用 Github Page 部署。

准备工作

1. 安装 Golang

   从 Golang官网 下载 .msi 安装包，并进行安装。

2. 安装 Git

   从 Git官网 下载安装包，并进行安装。¹

安装 Hugo²

下载 Hugo

1. 从 Github 下载最新版本压缩包 https://github.com/gohugoio/hugo/releases

2. 添加两个新文件夹 C:\Hugo\bin 和 C:\Hugo\Sites

3. 将下载的压缩包解压到 C:\Hugo\bin

配置环境

1. 打开 控制面板 > 系统 > 系统保护 > 高级 选项卡 > 系统变量 。

2. 在 系统变量 中找到 Path，添加 hugo.exe 所在的路径。

建立本地站点

运行 cmd 执行以下命令

1cd C:\Hugo\Sites
2hugo new site myblog

添加主题

在站点根目录执行以下命令

1git clone https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke

将配置文件 config.toml 替换成以上主题目录下的预设配置文件，并修改。

创建新博文

在站点根目录，执行命令 hugo new posts/Hello-World.md

在本地预览站点

在站点根目录执行命令 hugo server -D

完成后可在本地 http://localhost:1313/ 预览。

创建静态网页

对预览效果满意后，可以创建静态页面，以便上传至 Github 。

执行 hugo -D ，静态文件将存放于 ./public/ 下。

部署至 Github

如果搞不清楚 git命令 的话，可以下载 github desktop，俗话说GUI解千愁（不是

创建 Github 仓库

创建站点仓库，命名为 username.github.io

连接本地静态文件与 Github 仓库

1. 修改站点配置文件 config.toml 将 baseURL 改为上述仓库地址，并重新创建静态文件。

2. 打开 public 文件夹，执行以下命令。或者可以用 github desktop 连接本地与仓库。

   1git init
   2git add .
   3git commit -m "initial"
   4git remote add origin https://github.com/<username>/<项目仓库名>.git #连接本地与仓库
   5git pull origin main #注意 Branch 名称
   6git push -u origin main
   

创建 Github Page

打开仓库设置选项，找到 Pages ，选择静态文件所在的 Branch 。

如果没什么问题的话，打开 Page 所指向的链接就可以看到博客主页了。

创建 deploy.sh 文件

为了简化每次发布博文的流程，可以写一个脚本，自动执行。

1#!/bin/bash
2#在站点根目录下
3hugo
4cd public
5git add .
6git commit -m "new post"
7git pull origin main #注意 Branch 名称
8git push -u origin main

每次执行时，在根目录右击打开 git bash here ，输入命令 ./deploy.sh 。

参考