hugo+github个人博客网站建立教程

1.安装Hugo

在mac上，安装hugo

brew install hugo

验证

hugo version

2.建立文件夹

首先在桌面新建一个文件夹，用于存储所有网站的内容，例如Website。

3.新建网站

建立一个名为blog的网站，建立同名本地文件夹

hugo new site blog

4.选择主题

选择了好几个，总是有废弃的属性，找半天也没找到在哪。换了个最新的主题，没这些烦心事了
https://themes.gohugo.io/themes/hugo-theme-reimu/

根据教程先git clone到本地，然后创建配置。最后修改网站的hugo.tml。
网上并没有详细的配置，要去主题自己的配置里找，然后根据需要修改，官方推荐的基础配置：
https://gohugo.io/getting-started/configuration/
最关键的是主题选对

5.新建博文

在网站文件夹下，新建一个md，就会在content/post文件夹下新增一个md

hugo new post/f_t.md

编辑该文件

启动网站，在本地显示

hugo server -D

6.部署到github

新建github库

例如：https://github.com/stay-leave/stay-leave.github.io
要求同名

构建Hugo网站，在blog文件夹下执行

hugo

网站的内容将会被保存在blog/public

链接github，ssh的方式

进入public，初始化git库

git init

链接到远程库。首先在github添加本机的ssh公钥

1. 生成新的 SSH 密钥

如果你没有 SSH 密钥，可以生成一个新的密钥。推荐使用 ed25519 类型的密钥，它比 rsa 更加安全。运行以下命令：

bash ssh-keygen -t ed25519 -C "your_email@example.com"

这将创建一个新的密钥对。系统会提示你指定文件保存路径，默认会保存到 ~/.ssh/id_ed25519。

如果你希望保存到默认位置，可以按 Enter 键。

2. 检查新生成的密钥

生成密钥之后，使用以下命令检查密钥是否成功生成：

bash ls -al ~/.ssh

你应该会看到类似以下的文件：

• id_ed25519（私钥）
• id_ed25519.pub（公钥）

3. 将 SSH 公钥添加到 GitHub

接下来，你需要将公钥添加到 GitHub：

1. 查看并复制公钥内容： bash cat ~/.ssh/id_ed25519.pub

2. 登录到 GitHub，点击右上角的 头像，选择 Settings。

3. 在左侧菜单中选择 SSH and GPG keys。

4. 点击 New SSH key 按钮，粘贴你复制的公钥，填写标题（例如 “My Macbook”），点击 Add SSH key。

4. 启动 SSH 代理并添加私钥

确保 SSH 代理正在运行并加载私钥：

bash eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_ed25519

5. 测试 SSH 连接

完成上述步骤后，你可以通过以下命令测试是否能成功连接 GitHub：

bash ssh -T git@github.com

如果成功，你将看到类似如下的输出：

does not provide shell access. ```

然后关联库：

git remote add origin git@github.com:stay-leave/stay-leave.github.io.git

提交修改

git status
git add .
git commit -m "第一次提交"

提交修改推送到远程库，这里是第一次提交，直接强制

git push -u -f origin main 

7.日常操作

1.上传博客

在blog里

新建博客

hugo new post/第二篇测试博客.md

在content/post下找到相应文件，进行编辑
构建hugo网站

hugo

切换到git目录，也就是public
提交修改

git status
git add .
git commit -m "2"

提交修改推送到远程库

git push -u origin main 

2.修改博客

省去第一步即可

3.删除博客

在blog/content/post和public/post找到对应文件删除。然后构建网站，推送

4.图片插入

现将图片放到blog/static里，写博客时相对引用

参考：
https://zz2summer.github.io/github-pages-hugo-%E6%90%AD%E5%BB%BA%E4%B8%AA%E4%BA%BA%E5%8D%9A%E5%AE%A2/
https://jianzhnie.github.io/post/hugo_site/
https://themes.gohugo.io/themes/hugo-theme-reimu/
https://gohugo.io/getting-started/configuration/