小海cosea常用Hexo帮助手册

欢迎进入我的 GitHub站

参考Hexo官网文档说明

前言:什么是 Hexo

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

hexo

1.软件环境

2.安装 Hexo

所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。

1
$ npm install -g hexo-cli

3.利用Hexo搭建一个博客

3.1 创建博客目录hoctoboy.github.io

1
2
3
$ hexo init hoctoboy.github.io
$ cd hoctoboy.github.io
$ npm install

3.2 生成静态页面

1
2
$ hexo clean
$ hexo g

3.3 运行

1
$ hexo s

这个时候,会生成本地的预览。浏览器输入地址 localhost:4000 即可看到本地博客效果。

注:关于创建MD文件,直接在source下posts里创建即可实时渲染出本地效果,关于这部分,此文忽略不写。

4.关于Hexo配置

配置部分,官网配置文档非常详尽,在这里就不一一赘述。不过需要注意的有:

1
2
3
4
deploy:
type: git
repo: https://github.com/hoctoboy/hoctoboy.github.io.git
branch: master

以及之后会提到的theme的修改

更改配置后,执行万能的调试命令即可:

1
2
3
$ hexo clean
$ hexo g
$ hexo s

5.更换主题

推荐使用量排名第一的主题NexT,当然,你也可以选用Hexo官方主题

a.下载主题

ctrl+c退出预览,然后执行Git命令$ hexo clean,再下载

1
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

b.启用主题

打开根目录下站点配置文件_config.yml, 找到 theme 字段,并将其值更改为 next。

到此,NexT 主题安装完成。下一步我们将验证主题是否正确启用。

c.验证主题

在切换主题之后、验证之前, 我们最好使用 hexo clean 来清除 Hexo 的缓存,以免出现一些莫名其妙的问题。然后重新执行hexo g来重新生成。

使用hexo s本地预览,查看是否安装NexT主题成功。

提示:$ hexo version 查询hexo版本,缩写$ hexo v,theme-next主题的版本号在_config.yml主题配置文件末尾处可查看。

6.Github

6.1 注册一个github账号

6.2 创建一个xxx.github.io的public仓库

如果您的账户名是hoctoboy,则需要创建一个hoctoboy.github.io的public仓库.

6.3 安装 hexo-deployer-git

1
$ npm install hexo-deployer-git --save

6.4 网站配置git

在网站的_config.yml中配置deploy

1
2
3
4
deploy:
type: git
repo: <repository url>
branch: [branch]

branch为分支,默认为master,可以不配置 repo为仓库地址,在github上新建仓库后,可复制此地址

6.5 部署

1
$ hexo d

d 即deploy

7.Hexo网站

这个时候,就得到了cosea个人博客。

8.购买域名并解析

本文以阿里云为例,注册购买部分略。购买后,直接进入域名列表,点击解析,然后添加解析,这里添加两个解析,以同时打开两种输入形式的域名。

1
2
lllookii.com
www.lllookii.com

记录类型 主机记录 记录值
CNAME @ hoctoboy.github.io
CNAME www hoctoboy.github.io

到这里,还没有结束,很简单的一个原理,本地将博客加载到GitHub托管网站,而hexo直接从GitHub调博客数据,我们将域名解析到了GitHub,但我们的解析是使用的CNAME,这个时候,GitHub并不能识别CNAME,它就相当于解析的一个中间桥梁,链接着域名与GitHub,而GitHub这个时候还未创建CNAME,所以,这个时候输入域名lllookii.com并无意义,这个时候,我们先要进GitHub的仓库https://github.com/hoctoboy/hoctoboy.github.io,点create new file,在name your file处输入CNAME,在edit中输入lllookii.com,此时,就完成了域名解析的全部过程,浏览器输入域名lllookii.com即可打开个人博客。

9.更多问题

配置完网站域名,hexo d再次部署时,重新打开lllookii.com会出现404错误,这个时候,需要在source文件夹下,新建一个txt格式的文档,命名为CNAME,并创建文档内容为

1
你的网站域名,如:lllookii.com(实际输入时,只输入域名 lllookii.com 即可)

然后,输入命令:

1
2
3
hexo clean
hexo g
hexo d

这个时候,再次进入lllookii.com域名查看即可。
当我们重新部署后,网站内容并没有更新,这个时候,需要在hexo clean后,删除.deploy_git文件,然后再执行hexo g,再使用hexo d部署,即可更新。

结束语:此,斓。

cosea wechat
Subscribe to WeChat Official Accounts