用hexo快速搭建个人博客

写在前面

如果你跟我一样,想要开辟出一块自留地来记录自己在技术学习过程中的各种收获,却又懒于搭建个人博客的繁琐,也对各种免费空间无爱,那么我相信Hexo会是一个不错的选择。

Hexo是一个快速、简洁且高效的博客框架,并且可以支持使用Markdown来解析文章。对于“颜控”,还有各种各样的主题可供使用。同时,Hexo搭建的博客还可以部署在github上,免去了自己购买空间的花费,又能获得无限的空间。

本文主要介绍作者在使用Hexo时的实践心得。关于更加深入的内容,可以查阅Hexo官方的文档以求得更详尽的解答。

Hexo安装

作者使用的是Mac系统,对于其他系统的用户可以查阅官方文档了解相关的安装过程。

安装Hexo之前,你的电脑中需要有:

  • Node.js
  • Git

安装git

关于git的安装,在Mac系统中推荐使用Homebrew进行安装。

1
sudo brew install git

安装Node.js

安装node.js的最佳方式是安装nvm.这也可以直接通过Homebrew进行安装。

1
sudo brew install nvm

安装Hexo

所有必要的程序安装完毕后,就可以直接使用npm来安装hexo了。

1
sudo npm install -g hexo-cli

Hexo使用

初始化

在使用hexo之前,自然应该先初始化一系列相关的文件。首先,在终端中cd到打算存储该博客相关内容的文件夹中,然后通过一下命令对站点进行初始化。

1
2
3
cd <folder>
hexo init
npm install

执行完上述命令后,Hexo会生成相关的目录以及文件。整个目录的格式如下:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

其中,_config.yml中包含了建站相关的一系列配置。package.json定义了一系列依赖的信息。scaffolds包涵了模版文件,当你创建一个新的文章的时候,hexo会调用scaffolds中的相应的模版(默认为post)来建立新的文件。sources存放了用户的资源。其中_post中包含了用户所发表的文章,_drafts中包含的是用户声明使用drafts模版生成的草稿文件。themes文件夹,顾名思义,存储了一系列相关的主题文件,可以通过修改_config.yml中的配置来更换文件,也可以去Hexo官网的主题分支来选取最中意的主题。

常用指令

当你完成hexo文件的初始化以后,就可以通过一系列相应的指令来完成各种功能了。

创建新的文件

1
hexo new [layout] <title>

这条指令也可以使用简写:

1
hexo n

其中[layout]的默认布局为post,这点可以在_config.yml中进行修改。\为用户文章的标题。生成的新文章将会被存储在source/_posts中,通过修改相关文件的内容来完成文章的编写。

生成网站相关的静态文件

1
hexo generate [-d]

这个指令会生成相关的静态文件。选项-d可以在生成静态文件的同时进行部署。

发表草稿

1
hexo publish [layout] <filename>

启动调试服务器

1
hexo server [-p]

默认情况下,启动服务器后可以通过 http://localhost:4000 对网站进行访问。选项-p可以对服务端口进行自定义。

部署网站

1
hexo deploy [-g]

这条指令也可以用简写:

1
hexo d

这条指令将会对网站进行部署。选项-g可以在部署之前生成相应的静态文件,即完成了generate的功能。

整体流程

对于整体的一个发布文章的流程,通常是:

1
hexo new <title>  #生成一个新的文件

在完成对文章的编写后,生成并部署:

1
hexo deploy -g    #生成静态文件并部署

之后你就可以在自己的站点上看到相应的文章了。

将页面部署到Github

首先安装hexo-deployer-git

1
npm install hexo-deployer-git --save

然后修改_config.yml中的相应的配置:

1
2
3
deploy:
type: git
repo: <repository url>

我们可以将页面部署到github上,并通过.github.com或者.github.io进行访问。在这之前,首先你要有个github账号,并且设置好本机git与github。详见这里

账号设置完成之后,在github.com页面登录,之后点击右边栏的New Repository创建一个新的repository,这里要注意的是:创建的repository的名字要与用户名一致。比如你的用户名为user1,就创建一个user1.github.com的repository.之后把存有hexo相关文件的文件夹同步到你的github中。

最后,修改_config.yml中的相应配置:

1
2
3
# URL
url: http://<your-user-name>.github.com
root: /

之后就可以在.github.com或者.github.io中访问你的个人博客了。每次根据前述的流程写完文章并部署后,访问该页面就能看到相应的同步的博客了!