前两天刚搭建好博客,今天没事刚好记录下关于hexo博客的相关内容,希望能帮到大家少走点弯路。
- 安装hexo
- 关联GitHub page
- 总结
1、安装hexo
Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。
安装 Hexo 相当简单。然而在安装前,您必须检查电脑中是否已安装下列应用程序:
当然安装这两个软件也很简单,在这里不做过多介绍。
安装好以上的软件后,我们可以通过cmd命令验证是否正确。
1 | node -v |
接下来我们通过Node.js的npm命令安装hexo即可。
1 | npm install -g hexo-cli |
安装 Hexo 完成后,我们首先需要为我们的项目创建一个指定文件夹(例如我在 E 盘目录下创建了一个文件夹 blog 。E:\blog ),在指定文件夹中执行下列命令, Hexo 将会在指定文件夹中新建所需要的文件。
1 | //使用node.js Command命令窗口,切换至指定文件目录 |
等待安装,安装完成后,指定文件夹 的目录如下:1
2
3
4
5
6
7
8.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── ...
继续执行命令。1
2hexo g
hexo s --debug
这个时候,我们在浏览器中访问 http://localhost:4000/ ,就可以看到基于 Hexo 的默认主题的原型:
安装主题
我所使用的是yilia主题,当然大家可以在hexo官网上找到更多的主题,安装照样使用的是npm命令。
1 | git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia |
等待下载完成即可。
在 Hexo 中有两份主要的配置文件,其名称都是 _config.yml 。其中,一份位于站点根目录下,主要包含 Hexo 本身的配置;另一份位于主题目录(themes)下,这份配置由主题作者提供,主要用于配置主题相关的选项。
一般将前者称为站点配置文件,后者称为主题配置文件
启用 yilia 主题
打开站点配置文件,找到 theme 字段,并将其值更改为 yilia 。
到此, yilia 主题安装完成。下一步我们将验证主题是否正确启用。在切换主题之后、验证之前,我们最好使用 hexo clean 来清除 Hexo 的缓存。
验证主题
首先启动 Hexo 本地站点,并开启调试模式(即加上 –debug),整个命令是 hexo s –debug。在服务启动的过程,注意观察命令行输出是否有任何异常信息。当命令行输出中提示:1
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
此时即可使用浏览器访问 http://localhost:4000/ ,检查站点是否正确运行。
至此hexo和主题的安装已经告一段落。
本地调试步骤1
2
3$ hexo clean
$ hexo g
$ hexo s --debug
首先hexo clean会将hexo缓存清除,避免因为缓存出现其他问题,你懂的。
hexo g帮我们重新生成静态的html文件。
最后hexo s将开启本地服务,将你的网页在本地服务器上访问。
最后提醒大家,开启服务后,使用ctrl+c即可关闭服务,尴尬的是这事确实困扰了我一段时间,多读点书总是有好处的…
2、关联Github Page
简单介绍下github:
- 用户编写的,托管在GitHub上的静态网页
- 简单方便,相当于一个免费的服务器
- 绑定域名,辨识度高。
也就是说我们可以通过Github Page建立一个自己的静态的个人博客,完全自定义样式,这也是为什么使用它的原因。
当然首先你得有一个Github账号…
建立新的存储库
我们的个人博客将存储在这个存储库中。
配置Hexo与github pages关联
安装hexo-deployer-git,这是hexo关于git的管理组件。
进入Hexo也就是之前hexo init初始化过的文件夹目录下,在终端输入如下命令:
1 | npm install hexo-deployer-git --save |
安装完成后,你的blog文件夹会生成一个.deploy_git的文件夹,如图所示:
接下来开始配置hexo站点文件,修改如下配置信息:
deploy:
type: git
repo: https://github.com/DZhaoHui/blog.io
branch: master。
注意所有的.yml配置文件中:后必须加空格
其中repo字段的值替换成你自己的github Page提交地址,例如之前创建的blog.io存储库就是如图所示的路径地址:
这个时候与github的关联还没完全建立起来,接下来我们会通过git命令去关联
打开Git Bash输入如下命令:1
2
3
4git config --global user.name "Github用户名"
git config --global user.email "邮箱"
hexo clean
hexo g -d
注意此步骤会要求输入密码
3、总结
对于hexo的配置就此告一段落,抱歉教程写的不是很详细,大家实际操作难免出些问题,所以为大家找到了绝大多数的解决方案,希望能帮到你^_^。
有时间我会再写关于主题的配置,以及gitment的配置。
如果这篇教程对你有帮助,留个友链