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 <name> 初始化创建一个 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 <url>

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 "your_email@example.com"