↓跳过正文
Don’t Lose Hope

使用hugo+github搭建个人博客

·1516 字·4 分钟· ·
Hugo Github
Yann Howard
Yann Howard
真的就这么晚，急不来
目录

环境搭建
#

一.安装git
#

以win10为例

1.注册git账号：https://github.com/并记住用户名和密码

2.下载地址：Git - Downloads (git-scm.com)鼠标右键显示Git Bash Here就表示安装Git成功了。

git

3.设置本地git用户

  • git config --global user.name "Your Name"

  • git config --global user.email "邮箱"

是否已经登录

  • git config user.name

生成密钥

  • ssh-keygen -t rsa -C "邮箱"
git用户

将其中Your Name替换为用户名,邮箱替换为自己注册时的邮箱

如图所示，密钥已经给我们生成到C:/Users/UserName/.shh/id_rsa文件下了。

打开该目录下的id_rsa.pub文件，用记事本打开并复制这个密钥。

pub

4.去GitHub上验证

登录github ->进入设置->SSH and GPG key ->新建密钥，把上面文件里的内容全部复制粘贴进去即可。

user1

在Git Bash里输入ssh -T [email protected] ，成功的话会出现

You’ve successfully authenticated, but GitHub does not provide shell access.。

二.安装choco
#

Chocolatey是Windows平台上的包管理器，通过它可以集中安装、管理、更新各种各样的软件。

打开Windows PowerShell，用管理员登录，运行下面代码：

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

查看版本号判断是否安装成功或生成C:\ProgramData\chocolatey目录（这个目录是隐藏的）

choco
choco

三.安装hugo
#

在Windows PowerShell中运行以下命令

choco install hugo -confirm

验证是否成功

hugo version
hugo

四.安装Typora
#

下载安装即可，非常简单

网上搜索安装即可，安装Typora的目的是编写md文件，也可以用vscode等。

到这里环境就搭建好了。

使用hugo搭建博客
#

一.新建站点
# 

hugo new sit Bearcat
cd Bearcat

二.下载主题：
# 

git clone https://github.com/nunocoracao/blowfish.git themes/blowfish

三.配置Blowfish
#

之所以选了主题用Blowfish是因为文档，它有我在一众hugo主题里见过最齐全的文档了：https://blowfish.page

配置主题的时候没必要看着文档一点点来，把对应主题下的exampleSite下的配置文件拿出来改改就好。 改的时候可以开着本地环境，打开无痕浏览，一边改一边看效果。

四.git同步
# 

rm -rf themes/blowfish/ 
git init .
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
git remote add origin [email protected]:LesserCat/LesserCat.git
git add .
git commit -m "init"
git push -u origin main

这之前当然是要配基础环境到git,太基础就不写了。

五.Github Action
#

在仓库的Actions里添加workflow Actions -> New workflow -> 搜索hugo -Configure -> Commit changes

然后等待action完成即可访问username.github.io

UPDATE: 此时虽然能访问，但在actions的任务里总有一个pages build and deployment的任务是失败，还失败的莫名其妙

需要去项目的设置里把部署方从Depoly from a branch式改成Github Actions，路径： Settings -> Pages -> Build and deployment -> Github Actions

总结
#

日常发布文章命令

$ hugo new [posts]/[name]/index.md
$ hugo server -D
$ hugo
$ git status
$ git add .
$ git commit -m '[描述信息]'
$ git push origin

Cloudflare Pages 配置博客
#

新建 Pages
#

登录 cloudflare，点击左侧的Workers和Pages，选择Pages——连接到 Git

md_img202311081549200

允许 cloudflare 访问 blog 仓库，选择这个仓库开始设置。

md_img202311081550760

设置构建环境
#

  • 项目名称：随便写，之后会分配给你一个[项目名称].pages.dev。我这里就是 leev.pages.dev

  • 生产分支：一般默认选择 main

  • 框架预设：hugo

  • 环境变量

  • 设置 hugo 版本，设置成当前最新版本。我这里是：HUGO_VERSION=0.120.3

  • 开启 hugo 扩展功能，extend=true

    md_img202311081553496

部署成功
#

通过[项目名称].pages.dev访问站点

md_img202311081556682

设置域名
#

首先自行添加个人域名
#

md_img202311081559407

绑定域名
#

  • 进入构建好的 Pages

    md_img202311081600461

  • 自定义域——设置自定义域

    202408202330986

  • 添加自定义域。可以设置一级或二级域名，这里我直接用了一级域名

    md_img202311081602294

md_img202311081603622

然后进入 Pages，绑定域名

  • 等待片刻，DNS 解析生效
    md_img202311081604721