我的Hexo博客搭好了02 - 搭建过程之：披荆斩棘，晋级啦！

Witt181
21 阅读4分钟

文章系列导航

  1. 第01篇 - 选择困难症发作
  2. 第02篇 - 搭建过程之：披荆斩棘，晋级啦！
  3. 第03篇 - 搭建过程之：一路踩坑
  4. 第04篇 - 备份Hexo博客的源码目录，上传到Gitee仓库
  5. 第05篇 - 更换Hexo主题
  6. 第06篇 - 怎么给文章分类、打标签、展示目录
  7. 第07篇 - 怎么制作/about/、/categories/、/tags/页面
  8. 第08篇 - 让世界找到我——SEO大冒险(站点地图制作和提交)
  9. 第09篇 - 添加统计字数和阅读时长的插件
  10. 第10篇 - 怎么插入图片和视频
  11. 第11篇 - 怎么创建文章系列导航
  12. 第12篇 - 自动提交URL到搜索引擎(IndexNow + Google Search Console)
  13. 持续更新中...

1 准备本地Hexo环境

安装Hexo的过程顺利得让人怀疑人生，就几行命令。

  1. 安装Node.js

访问 Node.js官网 https://nodejs.org/en/download，下载并安装长期维护版(LTS)。

  1. 安装Hexo命令行工具

打开Linux的终端（或Windows的CMD/PowerShell），执行命令： npm install -g hexo-cli

  1. 创建并初始化博客

找一个合适的目录，执行以下命令（ 替换为你想要的文件夹名，例如 my-blog）：

hexo init <folder>
cd <folder>
npm install
  1. 本地预览

执行 hexo server 或 hexo s，然后在浏览器访问 http://localhost:4000，你将看到一个默认主题的博客。这证明本地环境已就绪。

看到默认页面的那一刻，我感觉自己像个天才。“建博客就这么简单？”—— 事实证明，我高兴得太早了，后面还有很多坑要踩。

2 创建并配置Github仓库

  1. 登录Github，点击“新建仓库”。

  2. 仓库名称：强烈建议格式为 你的Github用户名.github.io (例如：我的github用户名是 wittzh，则仓库名称为wittzh.github.io)。这是Github Pages的黄金法则，能让你直接通过 wittzh.github.io 访问。

  3. 选择“公开”，然后点击创建。

3 开启Github Pages服务

  1. 在仓库页面，点击“Settings”（设置），进入到设置页面。

  2. 再次点击“Pages”（页面）标签，进行相关配置。

  3. 在“Source”（源）下拉菜单中，选择 deploy from a branch 选项。

  4. 在“Select branch”（选择分支）下拉菜单中，选择 main（主分支）。在“Select folder”（选择文件夹）下拉菜单中，选择 / (root)（根目录）。然后点击最右边的“Save”（保存）按钮。

  5. 在最下方有一个“Custom domain”（自定义域名）输入框，如果自己申请了域名，这里可以填写，然后保存，将来可以用自己申请的域名来访问博客；如果没有，也可以留空。

  6. 稍等片刻，Github会自动构建你的页面。完成后，在“Pages”部分会显示你的博客地址（如 wittzh.github.io）。

4 配置本地Hexo与仓库的连接

- 在本地博客根目录，安装Git部署插件

  `npm install hexo-deployer-git --save`

- 用编辑器打开根目录下的 _config.yml 文件（这是Hexo的主配置文件），找到 `deploy` 部分，修改为：

  ```bash
  deploy:
    type: git
    # 填写你刚创建的仓库地址。ssh类型的地址 和 https类型的地址 填写任何一个都行，我是使用的ssh类型的地址
    repo: git@github.com:wittzh/wittzh.github.io.git # ssh类型的地址
    repo: https://github.com/wittzh/wittzh.github.io.git # https类型的地址
    # 分支通常为master或main
    branch: main
  ```

5 写作与发布“我的第一篇文章”

  1. 创建新文章：在终端执行 hexo new "我的第一篇文章"，会在 source/_posts 目录下生成一个Markdown文件（如 我的第一篇文章.md）。

  2. 编辑文章：用你喜欢的Markdown编辑器打开该文件，在 --- 分隔符下方开始写作。

  3. 生成与部署：文章写好保存后，在博客根目录依次执行以下命令：

    hexo clean   # 清理缓存
hexo generate # 生成静态网页文件到public目录
hexo deploy   # 将public目录内容推送到Gitee仓库

# 可以简写为以下命令
hexo clean && hexo generate && hexo deploy
# 或者更加简洁的命令
hexo c && hexo g && hexo d

6 最后，博客的访问地址

博客访问地址是：wittzh.github.io

下一篇，我要介绍下搭建过程中遇到的一些坑，以及如何解决。对大家很有参考意义。

最后，再记录下Hexo官方文档地址 hexo.io/zh-cn/docs/

avatar
文章
阅读
粉丝