Hexo + GitHub Pages 个人博客部署工作报告

I. 前言

本报告概述了使用 Hexo 静态网站生成器和 GitHub Pages 服务部署个人博客的过程。本次部署的目的是通过简化的步骤创建和上线一个轻量级、易于维护的个人技术博客。

II. 技术选型

  1. Hexo： 一个快速、简洁且高效的博客框架，使用 Node.js 编写，适合用于快速构建静态网站。
  2. GitHub Pages： 免费托管服务，可直接从 GitHub 仓库部署网页，适用于个人、项目或组织页面。

III. 实施步骤

步骤 1: 环境准备

  1. 安装 Node.js
    确认 Node.js 已正确安装，使用命令 node -v 和 npm -v 检查版本。

  2. 安装 Git
    用于版本控制和推送代码到 GitHub。安装后通过 git --version 验证。

步骤 2: 安装 Hexo

  1. 全局安装 Hexo CLI
    执行命令 npm install -g hexo-cli。

  2. 创建 Hexo 项目
    终端运行 hexo init blog 创建名为 ‘blog’ 的新目录，并初始化博客项目。

  3. 安装依赖
    进入 ‘blog’ 目录，执行 npm install 安装所需依赖。

步骤 2: 下载主题

  1. 下载主题模板

    git clone 相关主题模板，放置在themes下。

  2. 修改主题配置

    进入 _config.yml，对应修改themes 配置。

步骤 4: 配置博客

  1. 编辑 _config.yml
    修改网站标题、作者等配置信息，适应个人需求。

  2. 新建文章
    使用 hexo new "我的第一篇博客" 创建新文章。

步骤 5: 本地预览和调试

  1. 启动本地服务器
    执行 hexo server，通过 http://localhost:4000 预览博客。

步骤 6: 部署到 GitHub

  1. 配置部署
    在 _config.yml 中设置 deploy 部分，选择 GitHub Pages 作为部署平台。

    1
    2
    3
    4
    deploy:
      type: git
      repo: <GitHub仓库URL>
      branch: main

  2. 安装 Hexo 部署插件
    执行命令 npm install hexo-deployer-git --save。

  3. 一键部署命令
    执行 hexo clean && hexo deploy，清理缓存并推送至 GitHub。

IV. 结果与展示

​ 部署完成后，博客成功托管在 GitHub Pages 上。通过直接访问 <username>.github.io 可以看到上线的博客页面，样式简洁，加载速度快。

V. 后续维护与计划

  • 内容更新： 定期通过 Hexo 写新文章并部署更新。
  • 主题优化： 根据需要调整或更换 Hexo 主题以增强博客的视觉吸引力。
  • 功能扩展： 可考虑添加评论系统、搜索功能等。

VI. 结论

​ 使用 Hexo 结合 GitHub Pages 部署个人博客是一个高效且成本低的选择，适合个人技术展示和内容分享。整个部署过程简单明了，易于操作，也易于维护更新。通过本次成功的部署，提升了个人在网站开发和维护的实践经验。