乐趣区

关于github-pages:Github-托管-Hugo

jiezi

详情

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
  1. 应用 Git Submodule 指令装置皮肤 
git submodule add https://github.com/nanxiaobei/hugo-paper.git themes/paper
  1. 输出 hugo server -t paper 返回地址 localhost:1313 能够进行预览。

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

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

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

  1. 咱们能够通过任何 Markdown 编辑器 或者 LINUX/Mac 下的 VIM 编辑器进行编辑 content/post/test.md。
  2. 进去的时候咱们发现了曾经为咱们编辑好了一部分内容：
title: "Test"
date: 2022-11-26T11:58:56+08:00
draft: true

咱们间接在上面开始文章就行。

  1. 编辑好保留后，再进行预览看看：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 文件夹里。
  1. 进入目录并初始化为 Git 我的项目：
cd public
git init
  1. 关联仓库（本地关联 Github）：git remote add origin <url>

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

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

Tips：Github 将仓库的默认分支改为 main 了，咱们只须要二选一 改本地的分支名或者 近程的都能够，只有两者分支名一样皆可，这里我改本地的分支名，如下 👇

git branch -m master main

# git branch -m < 分支名 > < 须要更改的分支名 >
  1. 将仓库中的 README.md 拉下来：
git pull --rebase origin main

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

  1. 失常流程上传 
git add .
git commit -m "update"
git push origin main
  1. 如果生成的内容没有文章，请留神了！命令不会生成草稿文章，什么是草稿文章？就是你文章上方的 draft: true，你能够把这行给正文掉再从新执行命令。

Tips：生成 ssh 密钥：ssh-keygen -t rsa -C "your_email@example.com"

退出移动版