Github 托管 Hugo

详情

hugo：官网地址

Go-lang：官网地址

Git：官网地址

辅助工具 -> Github Proxy：官网地址

文章适合有一定基础的，最起码你能看懂我在讲什么，并不适合小白操作。（部分略写，看不懂可以Google等）

配置环境

1. 我们先下载好 hugo，这里我推荐直接去 Github 下载打包好的，或者你可以通过官网文档查询更多下载方式。
2. 下载好之后解压缩到文件夹里面，并添加到系统变量。
3. 检测安装是否成功：hugo version
4. 前往 Go-lang 官网 安装适合自己的版本。
5. 安装 git 工具，前往 Git 官网 安装适合自己的版本。

初始化项目

1. 我们创建一个 Github 空仓库。
2. 通过 hugo new site 初始化创建一个 hugo 项目。

编辑项目

1. 我们去 官网 找到自己喜欢的皮肤。
2. 检查 Go-lang 是否安装成功：go version。
3. 我选择的主题是：Paper

---

4. 使用 Git Submodule 指令安装皮肤

git submodule add https://github.com/nanxiaobei/hugo-paper.git themes/paper

---

5. 输入 hugo server -t paper 前往地址 localhost:1313 可以进行预览。

Tips：参数 -t paper是指定 paper 这个皮肤进行预览。

5. 新建一篇文章 hugo new post/test.md

Tips：这个命令在 content 文件夹下创建了 post 文件夹，并写入一个 Markdown 文章。

5. 我们可以通过任何 Markdown 编辑器 或者 LINUX/Mac 下的 VIM 编辑器进行编辑 content/post/test.md。
6. 进去的时候我们发现了已经为我们编辑好了一部分内容：

title: "Test"
date: 2022-11-26T11:58:56+08:00
draft: true

我们直接在下面开始文章就行。

---

9. 编辑好保存后，再进行预览看看：hugo server -t paper -D

Tips：这里参数 -D 是 -buildDrafts 在生成静态网站，或预览网站时，草稿内容也会被展示出来。

编辑配置

Tips： 配置文件是指 hugo 项目下的 config.toml 文件。

1. 在里面添加上一句 theme = 'paper' 就是指我们要使用 paper 主题。
2. title 就是我们的网站标题，这里也可以给它改成我们想要的。
3. 注意每个皮肤都有自己的参数，你可以根据它提供的进行更改，例如 paper 选项

Tips：根据你的需要进行添改。

上传 Github

1. 执行 hugo <- 这是个命令，将项目打包成静态的，可访问的，在项目的 public 文件夹里。

---

2. 进入目录并初始化为 Git 项目：

cd public
git init

---

3. 关联仓库（本地关联Github）：git remote add origin

tips： 参数 'url' 指你的 Github 仓库地址。

---

4. 更改本地分支名：git branch -m master main

Tips：Github 将仓库的默认分支改为 main 了，我们只需要二选一 改本地的分支名或者 远程的都可以，只要两者分支名一样皆可，这里我改本地的分支名，如下

git branch -m master main

# git branch -m <分支名> <需要更改的分支名>

---

5. 将仓库中的 README.md 拉下来：

git pull --rebase origin main

Tips：此处不拉后面会报错。

---

6. 正常流程上传

git add .
git commit -m "update"
git push origin main

---

7. 如果生成的内容没有文章，请注意了！命令不会生成草稿文章，什么是草稿文章？就是你文章上方的 draft: true，你可以把这行给注释掉再重新执行命令。

Tips：生成 ssh 密钥：ssh-keygen -t rsa -C "[email protected]"