需要的环境
- git
- npm
- nodejs
笔者使用的是Fedora 25,所以使用dnf命令就可以把这个两个工具快速安装了,nodejs也可以通过dnf快速安装到系统中。
Github上的准备
在github上建立一个与自己用户名对应的仓库,仓库名为”${用户名}.github.io”。
在本地上新建一个目录,用于存储hexo博客的工程内容,我就建立了一个”blog”作为hexo的根目录,只需要记得根目录路径即可,很多操作直接在根目录上使用hexo命令。
安装Hexo
在前面提及的工具已经安装的情况下,使用:
1 | $ sudo npm install -g hexo |
安装hexo。
初始化以及配置Hexo工程
进入blog目录,执行
1 | $ hexo init |
初始化目录。
生成静态页面:
1 | $ hexo generate |
或者简化的命令参数:
1 | $ hexo g |
然后可以使用:
1 | $ hexo server |
使用浏览器访问http://localhost:4000即可看到搭建起来的本地博客。
将Hexo本地工程部署到远程站点上
在blog本地根目录下有一个名为_config.yml
的配置文件,用于配置整个hexo工程。
使用:
1 | $ vim _config.yml |
打开, 其他平台或者编辑器的使用者请自行使用熟悉的编辑器。
到了文件末尾会有一段deploy
开头的配置。
修改成如下:
1 | deploy: |
例如我的配置:
1 | deploy: |
然后执行命令:
1 | $ npm install hexo-deployer-git --save |
保存配置。
最后,执行:
1 | $ hexo deploy |
将本地的修改提交到github仓库上,并会部署到站点上运行应用。
使用浏览器访问建立的仓库名则可以看到部署的博客站点,例如我的站点是http://cfwloader.github.io
至此github + hexo的基本配置结束。
部署事项
每一次编辑并发布,请按照下列命令执行:
1 | $ hexo clean |
开启Hexo文章分类功能
在项目目录下,编辑scaffolds/post.md
,修改内容为:
1 | --- |
之后使用hexo new
产生新文章时,在categories中填入文章的分类,hexo会自动产生分类栏。
因为一般我们采用的是中文,所以产生出来的页面的路径也包含中文,如果需要将分类与路径分离,可以修改_config.yml
中category_map
,有兴趣的可以自己去探索探索,这里不展开介绍了。
Hexo标签功能
Hexo自带的模板的文章头就有tags
选项,之前学习搭建hexo的时候别的文章提到有多个标签的时候有两种填法。
一种是:
1 | tags: [tag1, tag2, ..., tag`n`] |
另一种是:
1 | tags: |
笔者使用的hexo-cli
版本是1.0.4
,只有第二种方法才能正确产生期望的标签样式。故采用第二种方法。
常用命令
新建文章:
1 | $ hexo new "${文章名}" |
新建页面:
1 | $ hexo new page "${页面名}" |
生成页面:
1 | $ hexo generate |
或者
1 | $ hexo g |
部署应用到站点上:
1 | $ hexo deploy |
更多:
1 | $ hexo help |