詳情

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"