摘要：
  Hexo是一款快速、简洁且高效的博客框架，本文主要讲述如何在ubuntu18.04中安装和使用hexo软件。

1.hexo的安装

  hexo软件安装之前需要安装node和git，这些在之前的过程中就已经安装过了，可以查看之前的文档。

  • hexo官网

  hexo中文档地址：hexo官方中文文档

  安装命令如下

1
npm install -g hexo-cli
  • 查看版本
1
hexo -v

  出现以下信息，说明安装成功。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
hexo-cli: 4.2.0
os: Linux 5.4.0-65-generic linux x64
node: 15.8.0
v8: 8.6.395.17-node.23
uv: 1.40.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.17.1
modules: 88
nghttp2: 1.42.0
napi: 7
llhttp: 2.1.3
openssl: 1.1.1i
cldr: 38.1
icu: 68.2
tz: 2020d
unicode: 13.0

2.hexo的使用

2.1hexo的本地使用

  • 初始化文件夹

  hexo 将会在指定文件夹中新建所需要的文件,此处的folder文件夹必须为空，否则会报错。

1
2
3
hexo init <folder>
cd <folder>
npm install

  初始化完成后，查看文件树

1
2
# 显示1级目录
tree -L 1

  显示结果如下：

1
2
3
4
5
6
7
8
9
.
├── _config.landscape.yml
├── _config.yml
├── node_modules
├── package.json
├── scaffolds
├── source
├── themes
└── yarn.lock

  文件说明：

文件名称 用途
_config.yml 网站的 配置 信息，可以在此配置大部分的参数。
package.json 应用程序的信息。
scaffolds 新建文章时，Hexo 会根据 scaffold 来建立文件。Hexo的模板是指在新建的文章文件中默认填充的内容。例如，如果修改scaffold/post.md中的Front-matter内容，那么每次新建一篇文章时都会包含这个修改。
source 资源文件夹是存放用户资源的地方。除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。
themes 主题 文件夹。Hexo 会根据主题来生成静态页面。
  • 生成静态页面

  首先进入自己初始化好的hexo的文件夹，然后执行下边的命令。

1
2
3
4
# 生成页面命令
hexo generate
# 也可以简写为以下
hexo g
  • 监视文件变动

  Hexo 能够监视文件变动并立即重新生成静态文件，在生成时会比对文件的 SHA1 checksum，只有变动的文件才会写入。

1
hexo generate --watch
  • 服务器安装

  Hexo 3.0 把服务器独立成了个别模块，说是必须先安装 hexo-server 才能使用，但是有的时候发现没有安装，貌似也可以正常使用。

1
npm install hexo-server --save
  • 服务器使用

  安装完成之后，输入以下命令以启动服务器，生成的静态网站会在 http://localhost:4000 下启动。在服务器启动期间，hexo 会监视文件的变动并且自动更新，无须重启服务器。

1
2
3
4
# 启动服务器
hexo server
# 简写
hexo s

  想要更改端口，或是在执行时遇到了 EADDRINUSE 错误，可以在执行时使用 -p 选项指定其他端口。

1
2
3
4
# 指定启动的端口
hexo server -p 5555
# 简写
hexo s -p 5555

  若想在启动的时候自动修改端口号，可在_congig.yaml文件中添加以下内容，这样在启动本地预览的时候就可以直接修改启动的全端口号。

1
2
3
4
5
6
7
#------------------------------
# 说    明：Hexo本地启动地址配置
#------------------------------
# Hexo Server
server:
  port: 5555
  ip: 127.0.0.1

2.2hexo部署GitHub

  • 创建仓库

  注意这里的仓库名称必须为user name.github.io，这里还是要选择Public，不然好像不能访问页面，下边的图片我后来改成公共了，下边也可以选添加一个Add a README file 也可以不选，主要是仓库名称一定要对。这个就是以后自己的Gitub主页地址。

  • 安装hexo-deployer-git
1
npm install hexo-deployer-git --save
  • 修改配置文件_config.yml
1
2
3
4
# 进入初始化的文件夹
cd ~/02MyBlog/hexofiles
# 修改文件
vim _config.yml

  修改内容如下:

1
2
3
4
5
deploy:
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]
  • 开始部署
1
hexo d -m "描述"

  与git的commit一样可以加上-m参数来写每次提交的信息，也可以不加，不过每次提交都是默认的信息了，提交完成后，GitHub仓库如下所示，本地部署完毕之后打开网页可能会出现404找不到网页的标识，可以等待一会再进入页面。

  • 查看页面

  我的博客页面：欢迎来到我的博客

1
https://qidaink.github.io/