使用hugo+github搭建免费个人博客

前提条件

win11电脑一台
电脑安装了git
电脑安装了hugo
github账号一个

个人博客本地搭建

初始化一个博客

打开cmd窗口，使用hugo新建一个博客工程

bash 复制代码

hugo new site blogtest

下载主题

主题官网：themes.gohugo.io

在上面找一个主题，我这里找名称为m10c 的主题：m10c | Hugo Themes (gohugo.io)

注意：不同主题的安装方式不同，以后再专门写一个文章介绍如何安装复杂主题。本文不使用git add submodule 或者git clone的方式下载主题，因为这个部署到github的时候会有问题，坑已踩过，请紧跟我走。

主题的网站是一个github仓库：vaga/hugo-theme-m10c: A minimalistic (m10c) blog theme for Hugo (github.com)，我们需要把它的zip文件下载下来。

下载了zip文件之后，需要在hemes 目录新建一个m10c 的文件夹，然后把zip包里面的内容全部放到m10c 文件夹，放好之后的文件目录是这样的：

主题应用

在blogtest目录的cmd命令行，输入如下命令：

bash 复制代码

hugo server -t m10c

其中-t 是指定主题的意思。在浏览器中输入https://localhost:1313 就能访问

修改配置，将m10c 设置为默认主题：

参考E:\HugoProject\blogtest\themes\m10c\exampleSite\config.toml 的配置，修改E:\HugoProject\blogtest\hugo.toml 为如下

toml 复制代码

baseURL = 'https://lishuangquan1987.github.io/'
languageCode = 'en-us'
title = 'Tony Blog'
theme = 'm10c'
paginate = 8

[menu]
  [[menu.main]]
    identifier = "home"
    name = "Home"
    url = "/"
    weight = 1
  [[menu.main]]
    identifier = "tags"
    name = "Tags"
    url = "/tags/"
    weight = 2
  [[menu.main]]
    identifier = "about"
    name = "About"
    url = "/about/"
    weight = 3

[params]
  author = "Tony"
  description = "familiar with c#,go,lua,vb6"
  menu_item_separator = "  ·  "
  [[params.social]]
    icon = "circle"
    name = "CSDN"
    url = "https://blog.csdn.net/lishuangquan1987"
  [[params.social]]
    icon = "github"
    name = "Github"
    url = "https://github.com/lishuangquan1987"
  

  # Default theme
  #[params.style]
  #  darkestColor = "#242930"
  #  darkColor = "#353b43"
  #  lightColor = "#afbac4"
  #  lightestColor = "#ffffff"
  #  primaryColor = "#57cc8a"

  # Green theme
  #[params.style]
  #  darkestColor = "#315659"
  #  darkColor = "#253031"
  #  lightColor = "#96a879"
  #  lightestColor = "#fff"
  #  primaryColor = "#dad865"

  # Red theme
  #[params.style]
  #  darkestColor = "#d35050"
  #  darkColor = "#212121"
  #  lightColor = "#d6d6d6"
  #  lightestColor = "#d3d3d3"
  #  primaryColor = "#ffffff"

其中几个比较重要的配置：

theme=m10c 指定默认主题
baseUrl=https://lishuangquan1987.github.io/ 这个后面将网站部署到github会用到

此时。我们再使用如下命令启动：

hugo server

在浏览器中发现能启动，且主题的文字发生变化。

新建一个文章

使用如下命令，可以新建一个文章：

hugo new post/k8s集群简单搭建.md

这时，我们直接运行hugo server 命令，发现不能看到文章，需要编辑k8s集群简单搭建.md:

+++

title = 'K8s集群简单搭建'

date = 2023-10-05T12:32:30+08:00

draft = true

+++

其中有个draft=true 表示草稿的意思，将它去掉之后，就能看到文章了。往文章里面填写markdown 语法的内容即可

将博客部署到github

在github上新建仓库

在github上新建一个名称为 {用户名}.github.io的仓库。例如我的github用户名是lishuagnquan1987 ，那么我新建仓库名称为lishuagnquan1987.github.io

编译本地项目

在E:\HugoProject\blogtest> 的命令行中输入如下命令：

hugo

即可编译项目，编译之后，发现生成了public文件夹

推送本地项目到github

在E:\HugoProject\blogtest> 的命令行中输入如下命令：

初始化git仓库
bash 复制代码
```
git init
```

添加远程仓库

bash 复制代码

git remote add origin https://github.com/lishuangquan1987/lishuangquan1987.github.io.git

暂存本地修改
bash 复制代码
```
git add .
```
提交本地修改
bash 复制代码
```
git commit -m "first commit"
```
提交本地修改到远程
bash 复制代码
```
git push --set-upstream origin master
```

设置github仓库

在仓库主界面，点击Settintgs:

进入设置界面，点击左侧导航栏的Pages:

在Build and deployment->Source中选择GitHub Actions:

点击browse all workflows:

然后搜索 hugo,找到hugo之后点击configure按钮：

它会自动在lishuagnquan1987.github.io/.github/workflows目录下新建一个hugo.yml文件

这时候，我们不需要修改任何东西，直接点击右侧的Commit changes 按钮提交修改即可：

此时，可以看到github正在构建你的项目：

等构建完毕之后，可以输入地址：http://lishuagnquan1987.github.io来访问你的博客啦:

注意：需要将新建的hugo.toml文件同步到本地，否则后续修改会造成冲突

git pull