回到文章目录

Hexo 常用命令

  • 生成静态网页文件到 public 目录。
1
hexo generate
  • 启动本地预览服务器（实时更新）。
1
hexo server  # http://localhost:4000  (https 不可用)
  • 部署服务器到远端。
1
hexo deploy  # 即将介绍
  • 新建文章到 source/_posts 目录（可以手动新建）。
1
hexo new {文章名称}  # 可以手动新建，但注意 Markdown 头部声明
  • 新建页面到 source 目录（可以手动新建）。
1
hexo new page {页面名称}
  • 清除 hexo 博客目录缓存与 public 目录，用于修复未知问题。
1
2
hexo clear
# hexo generate  # 别忘了重新生成

注：很多命令都可以直接用首字母简化表示。

配置博客信息

  • 前面讲到 _config.yml 文件用于配置博客信息。这里我们打开 _config.yml，仅对于我们关心的基本内容进行讲解。
  • 详细内容见官方文档：_config.yml
1
2
3
4
5
6
7
8
# Site
title: Hexo                                        # 博客标题: Jamhus Tao's Blog
subtitle: ''                                    # 博客副标题，可缺省
description: ''                                    # 博客描述，显示在作者下方
keywords:                                        # 关键词
author: John Doe                                # 作者: Jamhus Tao
language: en                                    # 语言: zh-CN
timezone: ''                                    # 时区: 'Asia/Shanghai'

创建 Github 仓库

  • 配置 Hexo 的方式其实有两种，一种是使用个人服务器，另一种是使用 Github 提供的免费服务。我更倾向于使用 Github，这里也只作 Github 配置的教学。

安装 Git

  • 前往官网下载 SetUp 版本或 Portable 版本。小白建议下载 SetUp 版本。

    Git 官网下载

注：如果你还不会使用 Git，建议先学习使用 Git，后面会大量使用。此处不作教学。

注册 Github 并创建个人仓库

Github 个人主页仓库界面截图

  • New 一个名为 {用户名}.github.io 的仓库（Repositories）。

  • 配置 git 工具与 github 建立可信任连接。（请先学习 Git 使用）。

  • 使用 git 工具向 github 该仓库推送简单的 index.html 与 Readme.md 文件。

index.html：

1
2
3
4
5
6
7
8
9
<!DOCTYPE html>
<html>
    <head>
        <title>Jamhus Tao's Blog</title>
    </head>
    <body>
        <p>Welcome to my blog!</p>
    </body>
</html>

Readme.md：

1
# Jamhus Tao's Blog
  • 确保仓库的 Settings-Pages 已经被打开，这可能需要手动打开。打开后的状态如下。

Github Settings Pages 截图

  • 点击上方截图显示的 Visit site 或在浏览器直接输入 https://{用户名}.github.io 访问个人站点，这可能需要一些时间等待 github.com 部署完成你的个人站点。一切正常！

Github 个人网站试访问截图

配置自定义域名（可选）

  • 如果你觉得 xxx.github.io 简直太 low 了！可以花钱购买自定义域名，购买域名可以到 阿里云 等平台，一般的域名大概每年几十元。

  • 打开平台的域名解析界面，添加 CNAME 记录，全部指向你的 xxx.github.io。

  • 打开 github 仓库，将 Settings-Pages-Custom domain 设置为你购买的域名。

  • 在本地博客目录下的 source 目录创建 CNAME 文件（没有后缀名），使用记事本打开，写入你购买的域名。

部署个人站点

配置部署信息

  • 我大费周章，还专门去学了 git 才终于搞定了 github 个人站点，怎么就一个 Hello World 呀。别急，因为我们还没用上 Hexo。

  • 在 _config.yml 找到 URL 和 Deployment 配置。在 url 写上个人站点，如果配置了自定义域名请写上你购买的域名，不然写上 xxx.github.io。在 deploy.type 写上 git，后面还得加上 repository 和 branch 配置。

1
2
3
# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: https://jamhus-tao.github.io                                    # url
1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: 'git'                                                        # 部署方式: sftp / git
  repository: https://github.com/jamhus-tao/jamhus-tao.github.io    # 仓库地址
  branch: main                                                        # 仓库分支

注：SFTP 用于推送至个人服务器，这里当然是选择 git 啦。

开始部署站点

  • 第一次需要安装 git 部署方式依赖。
1
npm install hexo-deployer-git --save  # 首先安装 git 部署方式依赖
1
2
3
4
# 每次最好都运行这三个
hexo clean  # 清空缓存与静态文件, 避免出错
hexo g      # 重新生成静态文件
hexo d      # 开始部署站点
  • 现在使用浏览器打开 {用户名}.github.io 或你的个性化域名，可以看到和本地试运行时相同的界面。

Hexo 试运行博客界面截图

​将站点部署到 Github 后不会立即生效始于正常现象，因为 Github 需要花些时间将代码仓库中的文件部署到他自己的服务器上。

​之后每次部署你的站点，都需要用到这些命令。不同的是，如果你修改了网站配置，最好运行 hexo clean 命令；日常上传文章不需要运行该指令。