手把手教你安装和运行 Hexo 博客框架

网站运维

Hexo 是一个快速、简洁且强大的静态博客框架,非常适合个人博客搭建。本文将带你一步步完成 Hexo 的安装和运行,新手也能轻松上手!

环境准备

在开始之前,请确保你的电脑已安装以下工具:

  1. Node.js 和 npm
    下载地址:Node.js 官方网站
    推荐版本:LTS

  2. Git
    下载地址:Git 官方网站
    安装后,请配置好你的用户名和邮箱:

    git config --global user.name "你的名字"
    git config --global user.email "你的邮箱"

安装 Hexo

  1. 打开终端,安装 Hexo 的命令行工具:

    npm install -g hexo-cli
  2. 创建博客项目
    选择一个空文件夹作为你的博客目录,例如 hexo-blog,然后执行以下命令:

    mkdir hexo-blog
    cd hexo-blog
    hexo init

    安装完成后,目录结构如下:

    hexo-blog/
    ├── _config.yml # 站点配置文件
    ├── package.json # 项目信息
    ├── scaffolds/ # 模板文件
    ├── source/ # 博客内容
    └── themes/ # 主题文件
  3. 安装依赖:

    npm install

运行 Hexo

  1. 启动本地服务器:

    hexo server
  2. 打开浏览器,访问 http://localhost:4000,你将看到 Hexo 的默认页面。

撰写博客文章

  1. 新建文章
    使用命令:

    hexo new "文章标题"

    文章文件会保存在 source/_posts/ 文件夹下,文件格式为 .md

  2. 编辑文章
    打开新建的 Markdown 文件,在其中撰写你的内容。例如:

    ---
    title: 我的第一篇博客
    date: 2024-11-19 10:00:00
    tags: [Hexo, 博客]
    ---
    这是我的第一篇 Hexo 博客文章!欢迎阅读!
  3. 生成静态页面
    在终端运行:

    hexo generate
  4. 再次启动服务器
    如果服务器已经关闭,请重新运行:

    hexo server

(可选项目)部署到 GitHub Pages

  1. 编辑 _config.yml 文件,修改以下内容:

    deploy:
    type: git
    repo: https://github.com/你的用户名/你的仓库名.git
    branch: gh-pages
  2. 安装部署工具:

    npm install hexo-deployer-git --save
  3. 部署到 GitHub:

    hexo deploy

常用命令汇总

命令 作用
hexo new <标题> 新建文章
hexo generate 生成静态文件
hexo server 本地预览
hexo deploy 部署到远程仓库
hexo clean 清理缓存与旧的静态文件

结语

恭喜你完成了 Hexo 博客的安装和运行!通过 Hexo,你可以轻松记录生活和技术点滴,还可以通过丰富的主题和插件打造个性化博客。快去试试吧!