1 为什么选择 Hugo DoIt？

• 更新活跃，构建速度快

• 简洁美观，功能丰富，移动端友好

• 加载速度快，SEO 优化良好

2 预先要求

1. Git

2. Go Programming Language

3. Hugo

   建议安装 Hugo Extended 版本。

3 步骤

3.1 初始化

1. 在本地初始化博客：

   bash

   hugo new site myblog
   cd myblog
   git init
   git submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt
   git add .
   git commit -m "Initial commit"

2. 初始化配置文件：

   1. 删除根目录的 hugo.toml 文件
   2. 把 themes/DoIt/exampleSite/config 文件夹复制到博客根目录
   3. 修改根目录的 config/_default/hugo.toml 文件，将 themesDir = "../.." 删去。

3. 创建第一篇博客文章：

   bash

   hugo new posts/my-first-post.md

4. 根目录下执行：

   bash

   hugo server

5. 打开浏览器，访问 http://localhost:1313 查看博客

   

3.2 配置

详见 DoIt 主题文档

3.3 部署

3.3.1 GitHub

同 Hexo 博客搭建指南#GitHub

3.3.2 Cloudflare

与 Hexo 博客搭建指南#Cloudflare 基本一致，注意：

1. 构建命令为 hugo，构建输出目录为 public。
2. 构建系统版本为 版本 3。

3.4 其它功能

3.4.1 评论

与 Hexo 博客搭建指南#评论功能 基本一致

1 设置用户名和邮箱

git config --global user.name "your name"
git config --global user.email "your email"

--global 表示全局设置，如果只想对当前仓库生效，去掉 --global 即可。

GitHub 等代码托管平台会为用户提供一个匿名邮箱地址。就 GitHub 来说，在 Settings -> Emails 中勾选 Keep my email addresses private，然后就可以看到 GitHub 分配的类似于 123456+user@users.noreply.github.com 的匿名邮箱地址。匿名邮箱地址可以保护个人隐私，同时也能将提交与平台账户关联起来，方便在平台上查看提交历史和贡献记录。

如果不需要关联账户，或代码托管于多个平台，可以使用一个虚假的邮箱地址。

2 初始化本地仓库和远程仓库

1. 初始化本地仓库

   bash

   git init

2. 创建远程空仓库 (如果没有)

   登录 GitHub，点击右上角 +，选择 New repository，填写信息，点击 Create repository。输入仓库名，其余保持默认即可，点击 Create repository。

3. 关联本地仓库和远程仓库

   bash

   git remote add origin <远程仓库地址>

4. 暂存并创建 commit

   bash

   git add .
   git commit -m "message"

5. 将本地仓库内容推送到远程仓库

   bash

   git push --set-upstream origin master

   或

   bash

   git push -u origin master

3 撤销已 commit 的更改

1. 保留更改到暂存区

   bash

   git reset --soft HEAD~1

2. 删除更改

   bash

   git reset --hard HEAD~1

fatal: ambiguous argument 'HEAD~1': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

4 修改某个 commit 的 message

假设修改第 n 个 (以最近的 commit 为 1) commit 的 message：

git rebase -i HEAD~n

在弹出的编辑器中，将需要修改的 commit 前的 pick 改为 reword，保存并关闭编辑器。接着会弹出一个新的编辑器，修改 message 后保存并关闭编辑器。

5 合并多个 commit

假设合并最近的 n 个 commit：

方法一：

git rebase -i HEAD~n

在弹出的编辑器中，将需要合并的 commit 前的 pick 改为 squash，保存并关闭编辑器。接着会弹出一个新的编辑器，修改 message 后保存并关闭编辑器。

方法二：

git reset --soft HEAD~n
git commit -m "new message"

6 强制推送

git push --force

多人协作时不建议使用，必要时可以使用 git push --force-with-lease。它会检查远程仓库是否有新的更改，如果有则拒绝推送。

7 批量修改提交者信息

新建一个.mailmap 文件，格式为以下之一：

Correct Name <correct@email.com> Wrong Name <wrong@email.com>
Correct Name <correct@email.com> <wrong@email.com>
<correct@email.com> <wrong@email.com>

例如：

user1 <1@1.com> user2 <2@2.com>

再执行：

git filter-repo --mailmap .mailmap --force
git push --force

.mailmap 代表该文件的路径，可以手动指定。

8 将原仓库的更改同步到 fork 的仓库

1. 添加上游远程仓库

   bash

   git remote add upstream <原仓库地址>

2. 获取上游远程仓库的更改

   bash

   git fetch upstream

3. 切换到本地的主分支

   bash

   git checkout <主分支名称>

4. 将上游远程仓库的更改应用到本地分支

   • 使用 merge 方法

     bash

     git merge upstream/<主分支名称>

     如果有冲突，你会看到类似如下的信息：

     text

     CONFLICT (content): Merge conflict in <冲突文件路径>

     打开冲突的文件，你会看到类似如下的标记：

     text

     <<<<<<< HEAD
     你的代码
     =======
     上游的代码
     >>>>>>> upstream/main

     你需要手动编辑冲突的文件，并删除所有标记 (<<<<<<<, =======, >>>>>>>)，然后保存文件。

     解决所有冲突后执行：

     bash

     git add .
     git commit -m "Merge upstream changes"

   • 使用 rebase 方法

     bash

     git rebase upstream/<主分支名称>

     冲突处理同上。

     解决冲突后执行：

     bash

     git add <冲突文件路径>
     git rebase --continue

5. 将本地分支的更改推送到 fork 的远程仓库

   bash

   git push origin <主分支名称> --force

9 浅克隆

当只需要获取仓库的最新状态，而不需要完整的提交历史时，可以使用浅克隆来节省时间和存储空间。

git clone --depth 1 <仓库地址>

--depth 1 表示只克隆最近的一次提交，可以根据需要调整深度。

如果需要在浅克隆的基础上获取更多的提交，可以使用以下命令：

git fetch --deepen <深度>

该命令会在当前的基础上再获取更多的提交，<深度> 表示要获取的提交数量。比如原来克隆了最近的 1 次提交，执行 git fetch --deepen 4 后会获取最近的 4 次提交，使本地仓库总共包含最近的 5 次提交。

或者使用以下命令：

git fetch --depth <深度>

该命令会将修改克隆深度。比如原来克隆了最近的 1 次提交，执行 git fetch --depth 4 后就会获取最近的 3 次提交，使本地仓库总共包含最近的 4 次提交。

使用以下命令将浅克隆转换为完整克隆：

git fetch --unshallow

如果要针对特定分支，可以使用以下命令：

git fetch <远程名称> <分支名称> --deepen <深度>
git fetch <远程名称> <分支名称> --depth <深度>
git fetch <远程名称> <分支名称> --unshallow

如果需要设置某个子模块为浅克隆，在 .gitmodules 文件中的对应条目添加 shallow = true 配置即可。

1 预先要求

1. Git
2. node.js
3. GitHub 账号
4. Cloudflare 账号

2 步骤

2.1 本地站点

1. 打开终端管理员，输入

   bash

   npm install -g hexo-cli

2. 在你喜欢的位置打开终端，输入

   bash

   hexo init myblog

   会新建一个 myblog 文件夹。你可以按照喜好命名。

3. 继续执行：

   bash

   cd myblog
   npm install

4. 继续执行：

   bash

   hexo clean
   hexo g
   hexo s

5. 打开浏览器，输入 http://localhost:4000/，可见：

   

这样，我们本地的网站就初步构建好了。

2.2 部署

2.2.1 GitHub

1. 登录 GitHub，新建一个 repository，名字最好和刚刚 hexo init 的名字一致，权限设置 Private，其余保持默认。

2. 在博客根目录下：

   bash

   git init

3. 设置用户名、邮箱地址、远程存储库：

   bash

   git config user.name "你的 GitHub 用户名"
   git config user.email "你的 GitHub 邮箱地址"
   git remote add origin <你的仓库地址>

4. 提交并推送代码：

   bash

   git add .
   git commit -m "Initial Commit"
   git push

这样，网站代码已经上传到 GitHub 的仓库了。

2.2.2 Cloudflare

1. 登录
2. 计算和 AI -> Workers 和 Pages -> 创建
3. Pages -> 连接到 git 里，关联 GitHub 账号，选择仓库，开始设置
4. 按喜好修改名称 (同时域名也会改变)，构建命令写 npx hexo generate，构建输出目录写 public，保存并部署
5. 等待构建成功

约一分钟后网站可以访问了。

2.3 Hello World

1. 在博客根目录下:

   bash

   hexo new "first"

2. 转到 source/_post，找到新建的 md 文件，用你喜欢的 markdown 编辑器编辑

3. 修改好后，在博客根目录下：

   bash

   hexo clean
   hexo g
   hexo s

4. 打开浏览器，输入 http://localhost:4000/，可以看到修改生效了

5. 如果确认可以提交了，在博客根目录下：

   bash

   git add .
   git commit -m "up"
   git push --force-with-lease

6. 约一分钟后访问你的网址，可以看到修改生效了

2.4 自定义站点样式

hexo 提供许多主题和配色方案，个人推荐 fluid。

它的优点比较显著：

• 免费 & 开源
• 配置简单
• 文档丰富

2.4.1 fluid 主题配置

2.4.1.1 安装与启用

npm install --save hexo-theme-fluid

修改_config.fluid.yml 里 theme: fluid

2.4.1.2 自定义配置

详见_config.yml 和官方文档

一些自定义的配置：

• 背景图全屏 & 随日夜模式切换 & 毛玻璃效果
• 运行时间 & 版权声明优化 & 关于页评论
• 自定义字体

2.4.1.3 评论功能

comments:
enable: true
type: # your scheme

1. valine

   需要先注册 LeanCloud，创建应用，点击，再在设置 - 安全中心 - Web 安全域名里填你的域名

   配置：

   yaml

   valine:
   appId: xxx
   appKey: yyy
   meta: ['nick', 'mail']
   placeholder: '说点什么吧...'
   serverURLs: https://xxx.yyy

   注意

   如使用国际版 LeanCloud，可能会出现国内无法加载评论的问题；使用国内版则需要实名。

2. waline

   相对复杂但效果更好，详见这篇博客

   注意

   国内无法使用

3. twikoo

   步骤较繁琐，详见这篇博客

3 技巧

1. 上传某些文件到网站根目录：

   直接放到 source 目录下即可

   或执行：

   bash

   npm install -g wrangler
   wrangler login
   wrangler pages publish <本地文件夹路径> --project-name=<项目名>

4 常见问题

1. npm 安装报错

   • 尝试使用管理员权限运行
   • 可以使用 npm config set registry https://registry.npm.taobao.org 切换到国内镜像

2. hexo 命令未找到

   • 确保已正确安装 node.js
   • 检查环境变量是否正确设置

3. 更改未生效

   • 确保已执行以下命令

     bash

     hexo clean
     hexo g
     hexo s

   • 网页 build、上线和更新需要一定时间，请过几分钟后再次查看

4. 个人博客需要备案吗？

   • 未设置自定义域名，只使用 *.pages.dev：不需要
   • 网站的自定义域名不使用国内的域名：不需要
   • 网站的自定义域名使用国内的域名：需要