hexo框架+github如何创建属于自己的博客
Published in:2025-04-15 |

hexo框架+github创建属于自己的博客

一、环境准备

  1. 安装 Node.js
    • 前往 Node.js 官网下载并安装最新版本的 Node.js。
    • 安装完成后,在终端中运行 node -vnpm -v,确认安装成功。
  2. 安装 Git
    • 如果 macOS 未预装 Git,可以通过 Homebrew 安装:brew install git
    • 或者从 Git 官网下载安装包进行安装。
    • 安装完成后,在终端中运行 git --version,确认安装成功。
  3. 安装 Hexo
    • 使用 npm 全局安装 Hexo CLI:npm install -g hexo-cli
    • 安装完成后,运行 hexo -v,确认安装成功。

二、初始化 Hexo 项目

  1. 创建项目文件夹
    • 在终端中,导航到希望存放博客项目的目录,然后运行 mkdir myblog 创建新文件夹。
    • 进入该文件夹:cd myblog
  2. 初始化 Hexo
    • 运行 hexo init 博客名,Hexo 会自动生成项目所需的文件和目录结构。
    • 进入到新创建的博客名目录下
  3. 安装依赖
    • 运行 npm install,安装项目所需的依赖包。

三、配置 GitHub 仓库

  1. 创建 GitHub 仓库

    • 登录 GitHub,创建一个新的仓库,仓库名称必须为 username.github.io,其中 username 是你的 GitHub 用户名。
    • 选择 Public(公开)以便所有人都能访问你的博客。
  2. 生成 SSH Key

    (如果尚未配置):

    • 在终端中运行 ssh-keygen -t rsa -C "your_email@example.com",生成 SSH Key。
    • 按照提示操作,将生成的公钥(id_rsa.pub)添加到 GitHub 的 SSH Keys 设置中。

四、配置 Hexo 部署

  1. 编辑 _config.yml

    • 在项目根目录下找到_config.yml 文件,编辑 deploy 部分:

      1
      2
      3
      4
      deploy:
      type: git
      repo: git@github.com:username/username.github.io.git
      branch: main # 或 master,根据 GitHub 仓库的默认分支选择
    • username 替换为你的 GitHub 用户名。

  2. 安装部署插件

    • 运行 npm install hexo-deployer-git --save,安装 Hexo 的 Git 部署插件。

五、生成并部署博客

  1. 生成静态文件
    • 运行 hexo generate(或简写为 hexo g),生成博客的静态文件。
  2. 部署到 GitHub
    • 运行 hexo deploy(或简写为 hexo d),将生成的静态文件部署到 GitHub 仓库。
  3. 访问博客
    • 部署完成后,打开浏览器,访问 https://username.github.io,即可看到你的博客。

六、个性化与维护

  1. 选择主题
    • Hexo 提供了丰富的主题,可以在 Hexo 主题官网 选择并下载喜欢的主题。
    • 将主题文件放置在 themes 目录下,并在 _config.yml 中配置 theme 字段。
  2. 编写文章
    • 使用 hexo new "文章标题" 命令创建新文章,文章将保存在 source/_posts 目录下。
    • 使用 Markdown 格式编写文章内容。
  3. 更新与维护
    • 每次更新文章后,运行 hexo ghexo d 重新生成并部署博客。

七、主题下载

  • 竹子主题:https://github.com/yuang01/hexo-theme-bamboo

  • 进入themes文件夹下使用 Git clone 命令来下载:

    1
    git clone https://github.com/yuang01/hexo-theme-bamboo.git

    ⚠️如果clone速度较慢,可以用科学上网或者进入github下载压缩包

  • 修改hexo根目录下的站点配置文件_config.yml,把主题改为bamboo

  • 在source目录下新创建CNAME文件,文件内容写上访问的域名(如:penghc.cn

Prev:
线程池ThreadPoolExecutor详解
Next:
Hello World