教程

hexo 教程，搭建一个属于自己的博客 

文章部分内容来自 [Hexo 帮助文档](https://hexo.io/zh-cn/docs/)

什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

安装 Hexo

文章使用 Windows 10 22H2 作为演示系统

安装前提

安装 Hexo 需要再电脑中安装 node.js 和 git

安装 Git

其他系统可以参考 [Git 下载页面](https://git-scm.com/downloads)

Git 下载界面

安装大致略过，下面只展示一些带有选项的窗口

保持默认即可

选择 Use Vim as Git's default editor

选择 Let Git decide

选择 Git from the command line and also from 3rd-party software

选择 Use the OpenSSL Library

选择 Checkout Windows-style, commit Unix-style line endings

选择 Use MinTTY

选择 Fast-forward of merge

选择 Git Credential Manager

勾选 Enable file system caching

保持默认，选择 Install

安装 Node.js

其他系统可以参考 [Node.js 下载页面](https://nodejs.org/zh-cn/download/prebuilt-binaries)

  1. 进入 Node.js 官网，选择下载。

  2. 选择 预构建二进制文件 ，选择 我需要用于 Windows x64 ，版本选择默认的 LTS 版本即可

  3. 点击 下载 Node.js

Node.js 下载界面

  1. 对于国内用户，可以选择更换软件源来提高连接速度和稳定性
1
2
3
4
# 淘宝镜像源
npm config set registry https://registry.npmmirror.com/
# 官方镜像源
npm config set registry https://registry.npmjs.org/
安装大致略过，下面只展示一些带有选项的窗口

保持默认即可

同样保持默认

正式安装

首先我们打开 终端 (Windows需用户打开CMD) ，执行以下命令

1
npm install -g hexo-cli

然后我们要初始化Hexo

1
2
3
4
5
6
7
# blog 是要创建的文件夹名称，可以随意替换，下面同理
md blog
# hexo 会在 blog 文件夹中释放所需的文件
hexo init blog
# 此命令是进入刚刚创建的文件夹
cd blog
npm install

执行完成后会在文件夹内看到创建的文件

你可以执行以下代码，然后访问 http://localhost:4000/ 就可以预览网页了

1
hexo server

没出错的话应该是下面这个样子 ↓

Hexo 基础界面

创建 Github 仓库

  • 首先你需要创建 Github 账号

如果你进入不了 Github 的话我推荐你下载 Watt Toolkit
设置步骤如图所示: 1.下拉找到Github并勾选 2.点击一键加速 ( 如果提示启动失败之类的把右边的 Hosts 代理模式 换成 系统代理模式 )

Watt Toolkit 软件界面

  1. 打开 Github ，点击右上角 Sign up

点击右上角 Sign up

  1. 在中间输入电子邮箱，按照要求完成注册即可

输入电子邮箱后按照要求完成注册

  1. 注册后进入主页

  2. 找到右上角的 加号，选择 New repository

    选择 New repository

  3. 在右边的 Repository name 中，写上 你的用户名 + .github.io

    输入名称

    仓库的名字一定要是 你的用户名 (也就是左边那个名字) + .github.io

  4. 下拉，点击 Create repository 创建仓库

部署至 Github

配置 Git

打开终端，输入下面以下命令配置 git

1
2
git config --global user.name "Github 用户名"
git config --global user.email "注册 Github 的邮箱"

配置 Git

配置 SSH key

生成 SSH key

打开终端，输入下面命令

1
ssh-keygen -C "注册 Github 的邮箱"

输入后按三下回车即可

ssh 密钥

如果提示 ssh-keygen 不是内部或外部命令，也不是可运行的程序或批处理文件 可以使用 Git 附带的 Bash 仿真终端

在开始菜单中，可以找到 Git Bash

配置 SSH key

配置的文件生成的文件存放在 当前用户目录/.ssh 下，而我们需要的 公钥文件 在 当前用户目录/.ssh/id_rsa.pub 中

SSH key 目录

  • 你可以使用记事本打开，也可以用下面的命令直接访问公钥（可以用 Git Bash 仿真终端打开）
1
2
cd ~./ssh
cat id_rsa.pub

  1. 打开 Github，选择 Setting

  2. 选择 SSH and GTPG keys

  3. 点击 New SSH key

  4. 在 key 中输入刚才获取的公钥即可

配置 SSH key

修改配置文件

由于我们现在没法直接部署到 Github，我们需要修改 hexo 的配置文件

  1. 首先，在 Github 上，打开刚刚创建好的仓库

  2. 在下面找到 SSH 链接，复制备用
    SSH 链接

  3. 直接打开配置文件 _config 或输入下面的命令

    1
    2
    cd blog
    notepad ./_config.yml

  4. 编辑 _config.yml

    1
    2
    3
    4
    5
    deploy:  
      type: git  
      repo: <repository url> # https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io  
      branch: [branch]  
      message: [message]
选项 描述 默认
repo 目标存储库的 URL
branch 分支名称 gh-pages (GitHub)
coding-pages (Coding.net)
master (others)
message 自定义提交信息 Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}
token 可选的令牌值，用于认证 repo。 用 $ 作为前缀从而从环境变量中读取令牌 
内容节选自 [一键部署 | Hexo](https://hexo.io/zh-cn/docs/one-command-deployment)
  1. 将刚刚复制的链接粘贴到 repo 中

将链接粘贴到 repo 中

上传至 Github

  1. 用 cd 命令进入 hexo 的跟目录

  2. 输入下面命令，安装必要组件

    1
    npm install hexo-deployer-git --save

  3. 输入 hexo d 将博客上传至 Github

  1. 打开仓库，点击 Setting ，选择 Pages

  2. 将 Brance 中的 None 改为其他分支（例如 master），点击 Save

更改分支

  1. 通过访问仓库名称（例如 https://CuiCHenE.GitHub.io/ ），即可访问创建的博客