Hexo搭建Github Pages托管的静态个人博客

白萧迟

2023-12-01

Hexo简介

一个偶然的机会，我看到一篇介绍使用Markdown语言写静态博客的文章，一下子就喜欢上了这种专注写作的方式。之前我在Github上托管的博客就是使用jekyll搭建的，官方的Github Pages同样推荐使用它。通过体验jekyll，没有达到我想要的效果。于是寻找替代方案，搜索同类博客程序，我认识了Hexo：Hexo出自台湾大学生tommy351之手,是由Node.js驱动的一款快速、简单且功能强大的博客框架。Node.js是一个可以快速构建网络服务及应用的平台。该平台的构建是基于Chrome’s JavaScript runtime，也就是说，实际上它是对Google V8引擎（应用于Google Chrome浏览器)进行了封装。V8引擎执行Javascript的速度非常快，性能非常好。Node对一些特殊用例进行了优化，提供了替代的API，使得V8在非浏览器环境下运行得更好。它和jekyll相比，更快，更轻量。

Hexo安装

安装git

大多数Linux发行版已经默认安装了git,如果没有直接使用包管理工具安装
Windows: Git-Downloads

安装node.js

Gentoo package: net-libs/nodejs
Arch: nodejs
Windows: node.js

安装hexo

npm install hexo -g

配置Hexo

hexo init blog

安装依赖包

npm install

安装之后，项目目录下出现如下文件结构：

.
├── _config.yml     全局配置文件
├── package.json
├── scaffolds
├── scripts
├── source           文章存放位置
| ├── _drafts        草稿
| └── _posts         文章
└── themes

插件和主题

plugins: 插件

添加插件的基本操作是：

npm install <plugin-name> --save
npm update

然后修改blog根目录下的_config.yml，添加：

plugins:
- plugin-name

themes:

安装主题：

git clone <repository> themes/<theme-name>

无论是插件还是主题在安装后都需要在根目录下_config.yml中修改plugins和theme的值以启用他们。

本博客使用pacman主题，扁平化设计，响应速快，推荐使用。修改配置参考: http://yangjian.me/workspace/introducing-pacman-theme/

写文章

使用Markdown语法编辑文章。使用hexo new命令生成文章或者直接在_posts目录下直接创建文件，打开后先编辑文章头部信息，如下所示是本文的头部信息，以—结尾。

title: 使用Hexo搭建个人静态博客  #文章页面上的显示名称，可以任意修改，不会出现在URL中
layout: post
date: 2014-11-10 10:07:43  #文章生成时间，一般不改，当然也可以任意修改
updated: 2014-11-12 13:24
comments: true
categories: 
- Blog
tags: 
- hexo
- blog
---

文章摘要

在需要显示摘要的地方添加如下代码即可：

以上是摘要
<!--more-->
以下是余下全文

文章中插入图片

使用markdown写文章，插入图片的格式为![图片名称](链接地址)，这里要说的是链接地址怎么写。对于hexo，使用本地路径：在/source目录下新建一个img文件夹，将图片放入该文件夹下，插入图片时链接即为/img/图片名称。

发布博客

这里的发布也是十分简单的，首先在github上创建名为yourname.github.io的repo，接着修改_config.yml中的deploy字段，最后执行hexo d(前提是你已经在github上添加了你本机的ssh key)，OK，现在通过yourname.github.io已经可以访问你的博客了。

deploy:
type: github
repo: git@github.com:yourname/yourname.github.io.git
branch: master

如果是博客主页以github项目的方式创建，分支选择gh-pages。

或多个平台同时发布

deploy:
type: git
repo:
  gitcafe: https://gitcafe.com/yourname/yourname.git,gh-pages
  github: https://github.com/yourname/yourname.github.io.git,master

Hexo使用

init 初始化博客

hexo init [folder]

new 创建新文章

hexo new [layout] <title>

默认layout是post

generate 生成静态网页文件

hexo generate

publish 发布草稿

hexo publish [layout] <filename>

server 启动本地服务

hexo server

搭建本地server，进行文章预览调试。
浏览器输入http://localhost:4000 就可以看到效果。

deploy 发布博客

hexo deploy

clean 清除缓存

hexo clean

清除缓存文件：Cleans the cache file (db.json) and generated files (public).

list 显示博客结构

hexo list route

列出生成的所有博客文件路径

常用命令

Hexo现在支持更加简单的命令格式了，比如：

hexo n == hexo new
hexo g == hexo generate
hexo p == hexo publish
hexo s == hexo server
hexo d == hexo deploy
发布博客：
hexo g -d
或
hexo d -g

参考：
- hexo.io
- hexo on github
- 搭建一个免费的，无限流量的Blog—-github Pages和Jekyll入门
- pacman主题介绍
- hexo你的博客