前面说了,hexo从根本上来说是一个web程序框架;而hexo-cli脚手架提供各种快捷指令,方便我们开发配置我们需要开发的web程序。
安装脚手架
1 | $ npm install hexo-cli -g |
我们先通过npm全局安装hexo-cli这个给脚手架,然后就可以用hexo指令来执行一些快捷指令进行创建工程、生成页面、部署博客等等一些功能。现在我们就可以先生成一个blog工程。
1 | $ hexo init blog |
将工程用git管理起来
然后在github创建一个blog配置管理库,把这个工程关联并管理起来。
- 先进入到个人的github页面,点击Repositories右侧的New按钮,然后按照默认创建一个空的blog库:git@github.com:youname/yourblog.git
- 然后返回到本地机器,在刚刚建立的blog目录下初始化git库
1
2
3$ git init
$ git add . #添加当前文件夹所有文件到暂存区
$ git commit -m 'init blog' #提交文件到本地库 - 将本地库与远程库关联起来 这样就把blog工程用git管理起来了,并且可以随时把工程push github远端库里;这样可以随时在任何机器上获取你的工程文件生成博客了。
1
2$ git remote add origin git@github.com:youname/yourblog.git #将本地库与远程库关联起来
$ git push -u origin master #将本地库push到远程库中
生成博客
现在只要运行hexo指令
1 | $ hexo g |
这样我们就可以在localhost:4000
访问初始的hexo博客了。
配置博客
博客的配置文件是在根目录下的_config.yml
。需要注意的是在博客的themes目录中也有一个_config.yml
文件;通常的我们把根目录下的_config.yml
文件叫做站点配置文件,而themes目录中的_config.yml
文件叫做主题配置文件
打开站点配置文件_config.yml
;我们需要配置的主要有这么几项。
1 | # Site |
上面的就是关于配置博客的一些基本信息。
然后是关于博客的部署配置,在填写配置信息之前,需要安装部署的插件
1 | $ npm install hexo-deployer-git --save |
然后修改站点配置文件_config.yml
1 | # Deployment |
然后运行hexo指令
1 | hexo d |
或者当添加了新的日志之后运行
1 | hexo clean # 清除旧文件 |
现在打开https://yourname.github.io
就可看到我们的博客了。
写日志
运行hexo治理
1 | hexo new '日志标题' |
这样就会在source/_posts目录中生成一个日志标题.md
的文件,然后用markdown格式编写一篇文档之后,重复以下的指令,就可以在个人博客上看到新日志了
1 | hexo clean # 清除旧文件 |
至此,可以作为一个hexo博客的冒烟测试。
之后关于博客的标签、分类、归档以及主题的设置,将在下一篇说明。